Butler is a comprehensive AI agent treasury and orchestration layer that manages multi-provider API keys and automates sub-agent spawning.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install butler
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install butler using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Butler?
Butler functions as an autonomous CFO for your AI workforce, specifically designed to integrate within the ecosystem of Openclaw Skills. It transforms standard agents into sophisticated economic entities capable of managing their own token budgets across eight different API keys and six providers, including Nvidia, Groq, and Anthropic.
By providing a centralized orchestration layer, Butler handles the complexities of task decomposition, parallel execution, and real-time usage monitoring. It ensures that your AI agents remain operational by automatically rotating keys when they approach usage limits and intelligently allocating resources based on task priority and technical complexity.
Butler Use Cases
- Managing high-volume token budgets across multiple LLM providers like OpenAI, Anthropic, and Nvidia.
- Orchestrating complex research or development tasks by spawning and monitoring autonomous sub-agents.
- Automating API key rotation to prevent service downtime during critical workflows.
- Aggregating and validating data results from parallel AI worker sessions.
How Butler Works
- Butler initializes by loading API key configurations and historical state data from secure local storage.
- When a task is submitted, the system analyzes the PRD or description to estimate the required token complexity.
- The Token Manager identifies the optimal provider and allocates a specific budget, setting a 75% rotation threshold.
- The Agent Orchestrator decomposes the main prompt into discrete sub-tasks and spawns parallel agents to execute them.
- During execution, Butler monitors real-time consumption and automatically rotates keys if the threshold is reached.
- Upon completion, the system aggregates sub-task results into a single report, including success rates and total cost metrics.
Butler Setup
Install the core package using npm or yarn to begin integrating Butler into your Openclaw Skills workflow:
npm install butler
# or
yarn add butler
Configure your environment variables to manage your API key paths and treasury settings:
BUTLER_KEYS_PATH=/path/to/keys.json
BUTLER_STATE_PATH=/path/to/state.json
CIRCLE_API_KEY=your_circle_key
Butler Data Schema & Taxonomy
Butler utilizes a structured state management system to track tokens and task progress efficiently.
| Object | Description |
|---|---|
AllocationResult |
Contains the recommended key ID, provider details, and the allocated token budget. |
Status |
Provides a system-wide view of active keys, sessions, and pending usage alerts. |
AggregatedResult |
Summarizes task completion, including total tokens used and specific failure logs. |
APIKey |
Defines provider limits (tokens/day), costs, and current availability status. |
Butler Advanced Features
- Priority-based budget multipliers ranging from 0.5x for low-priority tasks to 2.0x for critical operations.
- Automated treasury module with USDC auto-buy triggers via Circle API integration.
- Real-time key rotation logic that prevents exhaustion by switching providers at 75% usage.
- Integrated security gate that works with Code Reviewer to prevent credential leaks during agent spawning.
- Parallel execution engine supporting 10+ simultaneous sub-agent tasks with automatic retries.
SKILL.md
Loading
Related Openclaw Skills
GlobePilot AI Agent 2
A decentralized travel assistant providing real-time visa info, currency conversion, and local travel intelligence.
GlobePilot AI Agent 2
A decentralized AI travel assistant providing real-time visa info, currency conversion, and localized travel insights via the Teneo Protocol.
GlobePilot AI Agent 2
A decentralized AI travel assistant powered by Teneo Protocol providing real-time global trip intelligence and automated travel services.
Moltbook
Moltbook is a specialized social networking protocol designed for AI agents to interact, share content, and build communities.
Cardano Wallet
A comprehensive blockchain utility for Openclaw Skills that enables AI agents to generate, restore, and fund Cardano wallets securely.
Hannah & Elena Client
A professional integration for connecting with Serviceplan's specialized AI agents for deep market research and operational project orchestration.
Featured*
