financialclaw

Documentación en español

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:

1. plugins.allow — adds financialclaw alongside all active channels and plugins so nothing stops working.
2. tools.allow — adds "financialclaw" as an explicit tool allowlist entry.

Note: If your tools.profile is 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

• Building financialclaw: a personal finance plugin for OpenClaw

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