billclawThis skill should be used when managing financial data, syncing bank transactions via Plaid/GoCardless, fetching bills from Gmail, or exporting to Beancount/Ledger formats. Provides local-first data sovereignty for OpenClaw users.
Install via ClawdBot CLI:
clawdbot install xBinKai/billclawComplete financial data management for OpenClaw with local-first architecture. Sync bank transactions, fetch bills from email, and export to accounting formats.
BillClaw is safe, open-source software designed with security-first principles.
disable-model-invocation: true)See SECURITY.md for detailed security architecture and verification steps.
| Concern | Explanation |
|---------|-------------|
| sets-process-name | Comes from transitive npm dependencies, not BillClaw code |
| detect-debug-environment | Common Node.js ecosystem pattern, not malicious |
| API credentials | Required for functionality; you control them from your accounts |
| External packages | All packages are open-source with npm provenance |
Important: Credentials are NOT required at install time. Configure them when you're ready to use specific features:
| Environment Variable | Purpose | Required For |
|---------------------|---------|--------------|
| PLAID_CLIENT_ID | Plaid API client ID | Plaid bank sync |
| PLAID_SECRET | Plaid API secret | Plaid bank sync |
| GMAIL_CLIENT_ID | Gmail OAuth client ID | Gmail bill fetching |
| GMAIL_CLIENT_SECRET | Gmail OAuth client secret | Gmail bill fetching |
Obtain credentials from:
Configure via:
~/.firela/billclaw/config.json)skills.entries.billclaw.envnpm install @firela/billclaw-openclawThe plugin registers these tools and commands with OpenClaw:
plaid_sync, gmail_fetch, conversational_sync, conversational_status/billclaw-setup, /billclaw-sync, /billclaw-status, /billclaw-configWhen 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"/billclaw-setupThe interactive wizard will guide you through:
You: Sync my bank transactions for last month
OpenClaw: [Uses plaid_sync tool from BillClaw plugin]
Synced 127 transactions from checking accountOr use the command directly:
/billclaw-sync --from 2024-01-01 --to 2024-12-31/billclaw-export --format beancount --output 2024.beancountThis skill provides instructions for using BillClaw with OpenClaw. The actual integration is provided by the @firela/billclaw-openclaw npm package.
plaid_sync - Sync bank transactions from Plaidgmail_fetch - Fetch bills from Gmailconversational_sync - Natural language sync interfaceconversational_status - Check sync status/billclaw-setup - Configure accounts/billclaw-sync - Sync transactions/billclaw-status - View status/billclaw-config - Manage configurationFor 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.
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.
| Source | Description | Regions |
|--------|-------------|---------|
| Plaid | Bank transaction sync | US, Canada |
| GoCardless | European bank integration | Europe |
| Gmail | Bill fetching via email | Global |
~/.firela/billclaw/ (your home directory)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"
}
}2024/01/15 * "Starbucks"
Expenses:Coffee
Liabilities:CreditCard:Visa
$5.502024/01/15 Starbucks
Expenses:Coffee $5.50
Liabilities:Credit Card:VisaGenerated Mar 1, 2026
Individuals can sync bank transactions from Plaid and fetch bills from Gmail to maintain a local-first financial ledger. This enables tracking expenses, budgeting, and exporting data to Beancount or Ledger formats for detailed accounting without relying on cloud services.
Small business owners can automate transaction syncing and bill retrieval to streamline bookkeeping processes. By exporting to accounting formats, they ensure accurate records for tax preparation and financial reporting while keeping sensitive data on-premise.
Freelancers can use this skill to consolidate income and expense data from multiple bank accounts and email invoices. It helps in generating financial reports for clients and managing cash flow with local data storage for enhanced privacy.
Financial advisors can integrate this tool to securely gather client transaction data and bills for analysis. It supports creating customized financial plans and reports using exported Beancount files, all while maintaining client data sovereignty.
Offer paid consulting services for setup, customization, and integration of BillClaw with existing financial systems. Revenue comes from one-time fees or retainer contracts for ongoing support and training.
Develop and sell advanced features as premium plugins, such as enhanced analytics, multi-currency support, or integration with additional financial platforms. Revenue is generated through one-time purchases or subscription models.
Provide enterprise licenses for businesses requiring enhanced security, compliance features, or dedicated support. Revenue streams include annual licensing fees and custom development contracts for specific organizational needs.
š¬ Integration Tip
Ensure all required environment variables like PLAID_CLIENT_ID are set before using sync tools, and use the /billclaw-setup command for guided configuration to avoid common setup errors.
Query Copilot Money personal finance data (accounts, transactions, net worth, holdings, asset allocation) and refresh bank connections. Use when the user asks about finances, account balances, recent transactions, net worth, investment allocation, or wants to sync/refresh bank data.
Stripe API integration with managed OAuth. Manage customers, subscriptions, invoices, products, prices, and payments. Use this skill when users want to process payments, manage billing, or handle subscriptions with Stripe. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
QuickBooks API integration with managed OAuth. Manage customers, invoices, payments, bills, and run financial reports. Use this skill when users want to interact with QuickBooks accounting data. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Advanced financial calculator with future value tables, present value, discount calculations, markup pricing, and compound interest. Use when calculating investment growth, pricing strategies, loan values, discounts, or comparing financial scenarios across different rates and time periods. Includes both CLI and interactive web UI.
Track expenses via natural language, get spending summaries, set budgets
Query and manage personal finances via the official Actual Budget Node.js API. Use for budget queries, transaction imports/exports, account management, categorization, rules, schedules, and bank sync with self-hosted Actual Budget instances.