A local-first financial management skill that syncs bank transactions and email bills while maintaining complete data sovereignty.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install billclaw
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install billclaw using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is BillClaw?
BillClaw is a robust financial data management tool designed for users who prioritize security and data ownership. As part of the Openclaw Skills ecosystem, it provides a local-first architecture that ensures your sensitive financial records never leave your local machine. It bridges the gap between various financial institutions and your personal accounting workflow, allowing for seamless integration without the privacy risks associated with cloud-based aggregators.
By leveraging this skill, developers can automate the tedious process of transaction collection and bill organization. Whether you are tracking personal spending or managing business accounts, BillClaw offers a professional-grade bridge to services like Plaid and GoCardless, all while keeping you in full control of your API credentials and data storage.
BillClaw Use Cases
- Synchronizing daily bank transactions from Plaid or GoCardless directly into a local database.
- Automatically extracting digital receipts and invoices from Gmail for expense tracking.
- Generating plaintext accounting files for Beancount or Ledger to simplify tax preparation.
- Auditing financial history through a secure, offline-first JSON storage system.
How BillClaw Works
- The user installs the core BillClaw plugin which registers specific financial tools and commands.
- API credentials for banking providers or Google Cloud are configured via environment variables or a local config file.
- The user runs an interactive setup wizard to link accounts and define local storage paths.
- Upon command, the skill fetches encrypted data from external APIs and processes it locally.
- Transaction data is partitioned into monthly JSON files for easy management and long-term storage.
- Users can interact with their data via natural language queries or export it to specialized accounting formats.
BillClaw Setup
To get started with BillClaw for Openclaw Skills, install the primary plugin package:
npm install @firela/billclaw-openclaw
Configure your environment variables for the services you intend to use:
# For Plaid integration
export PLAID_CLIENT_ID="your_client_id"
export PLAID_SECRET="your_secret"
# For Gmail integration
export GMAIL_CLIENT_ID="your_client_id"
export GMAIL_CLIENT_SECRET="your_secret"
Finally, run the setup command to link your accounts:
/billclaw-setup
BillClaw Data Schema & Taxonomy
BillClaw uses a structured local storage approach to keep your data organized and accessible.
| Item | Description |
|---|---|
| Directory | ~/.firela/billclaw/ |
| Transaction Data | JSON files using monthly partitioning (e.g., 2024-10.json) |
| Configuration | config.json stores provider settings and account metadata |
| Security | Tokens are encrypted and managed via the platform's secure system keychain |
BillClaw Advanced Features
- Multi-region support covering US, Canada (Plaid), and Europe (GoCardless).
- Natural language processing for syncing transactions and checking account status via conversational tools.
- Extensible export engine with native support for Beancount and Ledger double-entry formats.
- Optional standalone CLI and self-hosted OAuth server for advanced automation architectures.
SKILL.md
Loading
Related Openclaw Skills
Session Watchdog
Proactively monitors context levels to save critical session information before AI token compaction occurs.
session-wrap-up
An end-of-session automation tool that synchronizes code, extracts technical learnings, and evolves project rules using AI pattern detection.
Self-Hosted Whisper API
A local, privacy-focused speech-to-text solution that leverages OpenAI's Whisper model on Kubernetes for fast audio transcription and translation.
Commute Traffic Checker (TomTom)
A TomTom-powered AI skill that provides real-time traffic analysis, geocoding, and travel recommendations for any route.
CAN ASK MCP
A local, verifiable naming and storage layer that allows AI agents to stamp and log data retrieved from tools via the Model Context Protocol.
URnetwork Proxy & Privacy Agent Skill
A decentralized privacy network skill that enables AI agents to access global content anonymously through secure HTTPS, SOCKS, and WireGuard proxies.
METADATA
Featured*
