# Send AgentBooks to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text 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. ``` ### Upgrade existing ```text 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. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "agent-books", "name": "AgentBooks", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/NeilJo-GY/agent-books", "canonicalUrl": "https://clawhub.ai/NeilJo-GY/agent-books", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/agent-books", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-books", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "references/financial-health.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "agent-books", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-29T13:54:29.420Z", "expiresAt": "2026-05-06T13:54:29.420Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-books", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=agent-books", "contentDisposition": "attachment; filename=\"agent-books-0.1.5.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "agent-books" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/agent-books" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/agent-books", "downloadUrl": "https://openagent3.xyz/downloads/agent-books", "agentUrl": "https://openagent3.xyz/skills/agent-books/agent", "manifestUrl": "https://openagent3.xyz/skills/agent-books/agent.json", "briefUrl": "https://openagent3.xyz/skills/agent-books/agent.md" } } ``` ## Documentation ### Installation 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). ### Security & Trust 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. ### Before each session 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: ### Tier routing 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 " ### Recording Costs 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 ### Recording Income Income requires the --confirmed flag — you cannot self-report without external verification. agentbooks record-income \\ --amount \\ --quality \\ --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 ### After each session If running with a Runner, inference costs are recorded automatically via the runner's economy-hook. If running without a runner: agentbooks hook --input --output --model If token counts are unavailable, skip — do not estimate. ### Common Commands 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 ### Wallet Setup agentbooks wallet-init # Generate deterministic EVM address (idempotent) agentbooks wallet-connect --provider # Connect real provider → activates production mode agentbooks set-primary --provider # Set which provider funds operations agentbooks sync # Sync balance from primary provider Supported providers: coinbase-cdp · acn · onchain ### Data Location Your financial data is stored at: Standalone: ~/.agentbooks// OpenPersona: ~/.openclaw/economy/persona-/ 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. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: NeilJo-GY - Version: 0.1.5 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-04-29T13:54:29.420Z - Expires at: 2026-05-06T13:54:29.420Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/agent-books) - [Send to Agent page](https://openagent3.xyz/skills/agent-books/agent) - [JSON manifest](https://openagent3.xyz/skills/agent-books/agent.json) - [Markdown brief](https://openagent3.xyz/skills/agent-books/agent.md) - [Download page](https://openagent3.xyz/downloads/agent-books)