ClawHub
Code Pluginsource linked

Financialclawv1.0.10

Personal finance plugin for OpenClaw: expenses, income, recurring payments, and receipt OCR

financialclaw·runtime financialclaw·by @riclara
Community code plugin. Review compatibility and verification before install.
openclaw plugins install clawhub:financialclaw
Latest release: v1.0.10Download zip

Capabilities

Tags
executes-code
configSchema
Yes
Executes code
Yes
HTTP routes
0
Runtime ID
financialclaw

Compatibility

Built With Open Claw Version
2026.3.24
Min Gateway Version
2026.3.24
Plugin Api Range
>=2026.3.24
Plugin Sdk Version
2026.3.24
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
✓
Purpose & Capability
Name/description match the implementation: tools for logging expenses/incomes, recurring rules, reminders, a local SQLite DB, and agentic OCR (the plugin expects the agent to provide structured OCR). There are no unrelated network endpoints or cloud credentials requested.
ℹ
Instruction Scope
SKILL.md and the packaged setup script instruct the user to run a local setup that reads and writes the global OpenClaw config (plugins.allow, tools.allow, and plugins.entries.financialclaw.config.dbPath). This is within the plugin's stated purpose (ensuring the plugin and tools are allowed), but it does modify a global config file—user review/consent is appropriate (the script prompts for confirmation unless --yes is passed).
✓
Install Mechanism
No external downloads or unusual install steps. This is an instruction+packaged-code plugin (no install spec). All files are present in the bundle; runtime uses Node.js 24+ built-in modules and node:sqlite. No URL-based installs or extract-from-remote artifacts were found.
ℹ
Credentials
The plugin declares no required env vars, which is consistent for optional configuration. However the runtime DB resolution reads process.env.FINANCIALCLAW_DB_PATH (falling back to a sensible default) and the setup supports OPENCLAW_CONFIG — FINANCIALCLAW_DB_PATH is not documented in SKILL.md. No secrets or unrelated credentials are requested.
ℹ
Persistence & Privilege
The setup script writes to the user's OpenClaw config and creates a persistent DB file (default: ~/.openclaw/workspace/financialclaw.db). It does not set always:true and will not be force-enabled across agents, but it does modify a global config file (with interactive confirmation unless skipped). This behavior is justified by the plugin purpose but is a persistent change the user should review.
Assessment
This plugin appears to do what it says: local SQLite DB, tools for expenses/income, and a setup script that adds the plugin to OpenClaw's allowlists and sets a persistent DB path. Before running the setup: (1) back up your OpenClaw config (openclaw.json), (2) review the setup changes the script will list and avoid passing --yes until you're comfortable, and (3) be aware it will create a DB file (default ~/.openclaw/workspace/financialclaw.db) — you can override that with --db-path or by setting FINANCIALCLAW_DB_PATH in your environment (this env var is read by the code but not documented in SKILL.md). If you want additional assurance, inspect the included source files (they are bundled) or run the setup in a test environment first.

Verification

Tier
source linked
Scope
artifact only
Summary
Validated package structure and linked the release to source metadata.
Source
github.com/riclara/financialclaw
Commit
505f3c2b4eda
Tag
505f3c2b4edaff671c5b325d6c993519a44d2972
Provenance
No
Scan status
clean

Tags

latest
1.0.10

financialclaw

CI Ask DeepWiki

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

ToolDescription
manage_currencyAdd currencies, list them, set the default
log_expense_from_receiptRecord an expense from structured OCR data
log_expense_manualRecord an expense manually
log_incomeRecord income
log_income_receiptRecord a payment received linked to an income
add_recurring_expenseCreate a recurring expense rule
mark_expense_paidMark an existing expense as paid
get_financial_summaryGet a financial summary for a period
list_expensesList expenses with filters
list_incomesList incomes with filters
run_daily_syncRun the daily sync: generate recurring expenses, mark overdue, send reminders

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