billclaw

What This Skill Does

BillClaw provides a comprehensive financial management layer for your OpenClaw agent. It serves as a local-first bridge between your private financial accounts—such as bank feeds via Plaid or email invoices via Gmail—and your preferred accounting systems like Beancount or Ledger. By emphasizing local data sovereignty, it ensures that your sensitive financial information remains on your machine in the ~/.billclaw/ directory rather than on external cloud servers. It provides a suite of tools for transaction syncing, bill parsing, and status monitoring, enabling you to automate your personal finance workflows through natural language.

Installation

To begin, ensure you have Node.js installed on your system. You can install the core plugin directly into your environment using the command: npm install @firela/billclaw-openclaw. Once installed, you must configure your API credentials. Navigate to the Plaid Dashboard and Google Cloud Console to generate the necessary client IDs and secrets. You can provide these credentials via your system's environment variables or by creating a configuration file at ~/.billclaw/config.json. After configuration, you can finalize the setup using the built-in command /billclaw-setup within the OpenClaw interface to verify your connections.

Use Cases

• Automated Bookkeeping: Sync transaction data from your bank accounts directly into your local ledger files without manual input.
• Invoice Extraction: Automatically fetch bills from your Gmail inbox to identify outstanding debts or recurring subscriptions.
• Financial Reporting: Generate quick summaries of your spending habits or account balances using conversational status requests.
• Data Privacy Audits: Maintain complete control over your financial history by keeping all data local and encrypted within your own file system.

Example Prompts

1. "BillClaw, please sync my latest bank transactions and categorize them for this month."
2. "Check my Gmail for any unpaid utility bills received in the last 48 hours."
3. "Show me the current sync status of my Plaid accounts and let me know if any credentials need updating."

Tips & Limitations

BillClaw is designed with a security-first, local-first philosophy. Because it does not use a central server, you are responsible for maintaining your own credentials. Ensure you store your secret keys in your platform's secure keychain rather than plain-text files. Note that this skill does not autonomously trigger actions; you must explicitly request an operation (e.g., a sync or fetch) to prevent unexpected background activity. If you encounter issues, use the /billclaw-status command to diagnose connectivity problems or credential mismatches.