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