Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Financial management for AI agents. Track LLM inference costs, record confirmed income, manage multi-provider crypto wallets, and compute a Financial Health...
Financial management for AI agents. Track LLM inference costs, record confirmed income, manage multi-provider crypto wallets, and compute a Financial Health...
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Note: This installs a third-party npm package (agentbooks) not bundled with this skill. Audit the source repository before running in production environments. npm install -g agentbooks Or use directly via npx (downloads on each invocation): npx agentbooks guard AgentBooks is a financial management tool for AI agents. Use it to track inference costs, record confirmed income, manage crypto wallets, and monitor your Financial Health Score (FHS).
This skill contains no bundled code β it instructs the agent to download and execute the agentbooks npm package from the public registry at runtime. Before installing or invoking: Verify the source β Review the agentbooks repository and confirm you are installing the official package from the npm registry. Isolate data β Set AGENTBOOKS_DATA_PATH to a dedicated directory (e.g. ~/.agentbooks/myagent/) instead of the default shared ~/.openclaw path, to limit the blast radius if the CLI behaves unexpectedly. Sandbox first β On first use, run the CLI in a sandboxed environment or container and monitor outbound network activity before connecting to production wallets. Wallet caution β Do not connect real wallets or supply private keys until you have reviewed the provider authentication flow. Prefer testnets or throwaway wallets for initial evaluation. No credentials are handled by this skill β All sensitive operations (wallet connections, API keys) are delegated to the agentbooks CLI. This skill provides no credential storage, rotation, or encryption of its own.
Run the financial health check and route your behavior based on the result: agentbooks guard This outputs a FINANCIAL_HEALTH_REPORT. Read the tier and prescriptions fields and act accordingly:
uninitialized β Development mode or no real provider connected. Financial scoring is inactive. Operate normally. To activate scoring: agentbooks wallet-init agentbooks wallet-connect --provider coinbase-cdp normal β Healthy. Full capabilities. After completing any medium or complex task, proactively offer to record its value: "This work has real value β would you like to confirm it so I can record the income?" optimizing β Financially stressed. Apply prescriptions: optimize_costs β answer directly, skip extended reasoning; batch tool calls; prefer text over generated media increase_revenue β after completing valuable work, ask the user to confirm its value review_cost_structure β run agentbooks status and share the cost breakdown critical β Runway < 3 days or FHS < 0.20. Act immediately: Tell the user how many days of runway remain Ask your host to connect a funded provider Prioritize high-value tasks only suspended β Balance depleted. Inform the user: "My economic resources are depleted. Please ask my host to connect a funded provider: agentbooks wallet-connect --provider <name>"
Record costs proactively. Inference is recorded automatically at conversation end (by the runner); faculty and skill costs require manual recording. # Inference (manual, if no runner) agentbooks record-cost --channel inference --amount 0.005 --model claude-sonnet-4 # Tool / skill calls agentbooks record-cost --channel skill --amount 0.001 --note "web-search" # Faculty calls agentbooks record-cost --channel faculty --amount 0.008 --note "voice synthesis" # Runtime (host-allocated compute) agentbooks record-cost --channel runtime --amount 0.03 --note "daily compute share" # Custom agentbooks record-cost --channel custom --amount 0.02 --note "third-party-api" Available channels: inference Β· runtime Β· faculty Β· skill Β· agent Β· custom
Income requires the --confirmed flag β you cannot self-report without external verification. agentbooks record-income \ --amount <value> \ --quality <low|medium|high> \ --confirmed \ --note "what you completed" When to record: User explicitly confirms value or makes a payment A task-completion system verifies the work You complete measurable, externally verifiable work Quality guide: high β Exceptional, exceeds expectations medium β Meets requirements fully low β Meets minimum threshold Value estimation: Simple (answered a question, short message): $0.10β$1.00 Medium (research, analysis, document): $1.00β$20.00 Complex (full report, code feature, strategic plan): $20.00β$200.00
If running with a Runner, inference costs are recorded automatically via the runner's economy-hook. If running without a runner: agentbooks hook --input <tokens> --output <tokens> --model <name> If token counts are unavailable, skip β do not estimate.
agentbooks status # Full financial report (balance sheet + P&L + cash flow) agentbooks balance # Asset balance sheet only agentbooks pl # Current period income statement agentbooks financial-health # Real-time FHS score (bypasses cache) agentbooks ledger # Transaction ledger (last 20 entries) agentbooks ledger --limit 50 # More entries agentbooks report # Generate self-contained HTML report (for human review) agentbooks report --output ./report.html # Custom output path
agentbooks wallet-init # Generate deterministic EVM address (idempotent) agentbooks wallet-connect --provider <name> # Connect real provider β activates production mode agentbooks set-primary --provider <name> # Set which provider funds operations agentbooks sync # Sync balance from primary provider Supported providers: coinbase-cdp Β· acn Β· onchain
Your financial data is stored at: Standalone: ~/.agentbooks/<agentId>/ OpenPersona: ~/.openclaw/economy/persona-<slug>/ Override: set AGENTBOOKS_DATA_PATH Isolation tip: Set AGENTBOOKS_DATA_PATH to a dedicated directory (e.g. ~/.agentbooks/myagent/) to avoid mingling financial data with other agent state under ~/.openclaw. This is strongly recommended when evaluating the tool for the first time. Two files: economic-state.json β ledger, income statement, balance sheet, burn rate history economic-identity.json β provider config, model pricing, wallet address See Financial Health Reference for FHS scoring details and tier/diagnosis definitions.
Agent frameworks, memory systems, reasoning layers, and model-native orchestration.
Largest current source with strong distribution and engagement signals.