Personal finance plugin for OpenClaw: expenses, income, recurring payments, and receipt OCR
Install
openclaw plugins install clawhub:financialclawfinancialclaw
Personal finance plugin for OpenClaw. Registers expenses, income, recurring payments, and generates summaries. Works with any OpenClaw-supported channel (Telegram, WhatsApp, etc.). Receipt OCR is handled agentically — if your channel supports sending images, you can photograph a receipt and the agent will extract the data automatically. Embedded SQLite database. Multi-currency support.
Installation
# From ClawHub (recommended)
openclaw plugins install clawhub:financialclaw
# Or from npm
openclaw plugins install financialclaw
Then run the setup and restart:
npx financialclaw financialclaw-setup
openclaw gateway restart
Why is financialclaw-setup needed?
openclaw plugins install registers the plugin but does not add it to plugins.allow. Once that field exists, OpenClaw uses it as an explicit allowlist — anything not listed stops working, including active channels like Telegram.
financialclaw-setup reads your current config and applies two required changes:
plugins.allow— addsfinancialclawalongside all active channels and plugins so nothing stops working.tools.allow— adds"financialclaw"as an explicit tool allowlist entry.
Note: If your
tools.profileis set to something other than"full"(e.g."coding"), plugin tools may be hidden from the agent. The setup script will warn you if this is the case — you can change it manually if needed.
It also sets plugins.entries.financialclaw.config.dbPath so the database persists across reinstalls (default: ~/.openclaw/workspace/financialclaw.db).
Options
# Custom database path
npx financialclaw financialclaw-setup --db-path /your/path/financialclaw.db
# If the OpenClaw config is in a non-standard location
npx financialclaw financialclaw-setup --config /path/to/openclaw.json
Available tools
The current shipped contract exposes 13 tools:
| Tool | Description |
|---|---|
manage_currency | Add currencies, list them, set the default |
log_expense_from_receipt | Record an expense from structured OCR data |
log_expense_manual | Record an expense manually |
log_income | Record income |
log_income_receipt | Record a payment received linked to an income |
add_recurring_expense | Create a recurring expense rule |
mark_expense_paid | Mark an existing expense as paid |
get_financial_summary | Get a financial summary for a period |
list_expenses | List expenses with filters |
list_incomes | List incomes with filters |
run_daily_sync | Run the daily sync: generate recurring expenses, mark overdue, send reminders |
manage_fund | Create, list, deposit into, withdraw from, or archive savings funds and accounts |
plan_allocation | Given an income amount, show current-month commitments and remaining balance by currency |
Requirements
Node.js 24+ is required. The plugin uses node:sqlite, the built-in SQLite module available since Node.js 24 — no native addons or compilation needed.
Blog
Documentation
- README.es.md: documentación en español
- docs/setup.md: full setup guide and troubleshooting — español
- docs/hitos.md: implementation status
- docs/testing.md: testing strategy