# Send Billclaw 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": "billclaw", "name": "Billclaw", "source": "tencent", "type": "skill", "category": "效率提升", "sourceUrl": "https://clawhub.ai/xBinKai/billclaw", "canonicalUrl": "https://clawhub.ai/xBinKai/billclaw", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/billclaw", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=billclaw", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SECURITY.md", "SKILL.md", "scripts/validate-skill.sh" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "billclaw", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-29T05:59:20.487Z", "expiresAt": "2026-05-06T05:59:20.487Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=billclaw", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=billclaw", "contentDisposition": "attachment; filename=\"billclaw-0.5.5.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "billclaw" }, "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/billclaw" }, "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/billclaw", "downloadUrl": "https://openagent3.xyz/downloads/billclaw", "agentUrl": "https://openagent3.xyz/skills/billclaw/agent", "manifestUrl": "https://openagent3.xyz/skills/billclaw/agent.json", "briefUrl": "https://openagent3.xyz/skills/billclaw/agent.md" } } ``` ## Documentation ### BillClaw - Financial Data Management for OpenClaw Complete financial data management for OpenClaw with local-first architecture. Sync bank transactions, fetch bills from email, and export to accounting formats. ### Security & Trust BillClaw is safe, open-source software designed with security-first principles. ### Verification Transparent packages: All npm packages are open-source and published with provenance Auditable code: Full source available at GitHub npm provenance: Cryptographic proof linking packages to source code Local-first: Your financial data never leaves your machine User-controlled credentials: You provide all API credentials through your own accounts System keychain: Tokens encrypted in your platform's secure keychain Explicit invocation: Requires explicit user action (disable-model-invocation: true) See SECURITY.md for detailed security architecture and verification steps. ### Addressing Security Concerns ConcernExplanationsets-process-nameComes from transitive npm dependencies, not BillClaw codedetect-debug-environmentCommon Node.js ecosystem pattern, not maliciousAPI credentialsRequired for functionality; you control them from your accountsExternal packagesAll packages are open-source with npm provenance ### Required Credentials Important: Credentials are NOT required at install time. Configure them when you're ready to use specific features: Environment VariablePurposeRequired ForPLAID_CLIENT_IDPlaid API client IDPlaid bank syncPLAID_SECRETPlaid API secretPlaid bank syncGMAIL_CLIENT_IDGmail OAuth client IDGmail bill fetchingGMAIL_CLIENT_SECRETGmail OAuth client secretGmail bill fetching Obtain credentials from: Plaid: https://dashboard.plaid.com/ Gmail: https://console.cloud.google.com/apis/credentials Configure via: Environment variables (recommended) Configuration file (~/.firela/billclaw/config.json) OpenClaw config under skills.entries.billclaw.env ### 1. Install the Plugin npm install @firela/billclaw-openclaw The plugin registers these tools and commands with OpenClaw: Tools: plaid_sync, gmail_fetch, conversational_sync, conversational_status Commands: /billclaw-setup, /billclaw-sync, /billclaw-status, /billclaw-config ### 2. Configure Credentials When you're ready to use a feature, configure the required credentials: # For Plaid bank sync export PLAID_CLIENT_ID="your_client_id" export PLAID_SECRET="your_secret" # For Gmail bill fetching export GMAIL_CLIENT_ID="your_client_id" export GMAIL_CLIENT_SECRET="your_secret" ### 3. Setup Your Accounts /billclaw-setup The interactive wizard will guide you through: Connecting bank accounts (Plaid/GoCardless) Configuring Gmail for bill fetching Setting local storage location ### 4. Sync Your Data You: Sync my bank transactions for last month OpenClaw: [Uses plaid_sync tool from BillClaw plugin] Synced 127 transactions from checking account Or use the command directly: /billclaw-sync --from 2024-01-01 --to 2024-12-31 ### 5. Export to Accounting Formats /billclaw-export --format beancount --output 2024.beancount ### OpenClaw Integration This skill provides instructions for using BillClaw with OpenClaw. The actual integration is provided by the @firela/billclaw-openclaw npm package. ### Available Tools (via Plugin) plaid_sync - Sync bank transactions from Plaid gmail_fetch - Fetch bills from Gmail conversational_sync - Natural language sync interface conversational_status - Check sync status ### Available Commands (via Plugin) /billclaw-setup - Configure accounts /billclaw-sync - Sync transactions /billclaw-status - View status /billclaw-config - Manage configuration ### Standalone CLI For users who prefer a command-line interface, the standalone CLI is available as a separate npm package. See https://github.com/fire-la/billclaw for installation instructions. ### Connect OAuth Server For self-hosted OAuth flows, the Connect server is available as a separate npm package. See https://github.com/fire-la/billclaw for configuration details. ### Data Sources SourceDescriptionRegionsPlaidBank transaction syncUS, CanadaGoCardlessEuropean bank integrationEuropeGmailBill fetching via emailGlobal ### Storage Location: ~/.firela/billclaw/ (your home directory) Format: JSON files with monthly partitioning Security: Local-only storage ### Configuration Configuration is stored in ~/.firela/billclaw/config.json: { "plaid": { "clientId": "your_client_id", "secret": "your_secret", "environment": "sandbox" }, "gmail": { "clientId": "your_gmail_client_id", "clientSecret": "your_gmail_client_secret" } } ### Beancount 2024/01/15 * "Starbucks" Expenses:Coffee Liabilities:CreditCard:Visa $5.50 ### Ledger 2024/01/15 Starbucks Expenses:Coffee $5.50 Liabilities:Credit Card:Visa ### Getting Help Documentation: https://github.com/fire-la/billclaw Issues: https://github.com/fire-la/billclaw/issues Security: Report security vulnerabilities privately at security@fire-la.dev npm packages: https://www.npmjs.com/org/firela ## Trust - Source: tencent - Verification: Indexed source record - Publisher: xBinKai - Version: 0.5.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-29T05:59:20.487Z - Expires at: 2026-05-06T05:59:20.487Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/billclaw) - [Send to Agent page](https://openagent3.xyz/skills/billclaw/agent) - [JSON manifest](https://openagent3.xyz/skills/billclaw/agent.json) - [Markdown brief](https://openagent3.xyz/skills/billclaw/agent.md) - [Download page](https://openagent3.xyz/downloads/billclaw)