Open Accountant — OpenClaw Plugin

Query your local Open Accountant financial data through OpenClaw.

The plugin connects to Wilson's local dashboard server over HTTP — it never touches the SQLite database directly. This means it works with SQLCipher encryption and respects Wilson's auth/RBAC.

Prerequisites

• Wilson CLI installed
• Node >= 22
• OpenClaw gateway running

Setup

1. Start Wilson's dashboard

wilson --dashboard

The dashboard runs at http://localhost:3141 by default.

2. Set up dashboard auth

Open http://localhost:3141 in your browser, create an admin account, and note the bearer token from login.

3. Install the plugin

openclaw plugins install @openaccountant/openclaw-plugin

4. Configure

Add to your OpenClaw config:

{
  "plugins": {
    "entries": {
      "openaccountant": {
        "config": {
          "wilsonUrl": "http://localhost:3141",
          "authToken": "YOUR_BEARER_TOKEN"
        }
      }
    }
  }
}

5. Enable tools

All tools are optional — you must explicitly allow them:

{
  "tools": {
    "allow": [
      "oa_summary",
      "oa_profit_loss",
      "oa_budgets",
      "oa_savings",
      "oa_alerts",
      "oa_net_worth",
      "oa_net_worth_trend",
      "oa_transactions",
      "oa_goals"
    ]
  }
}

Available Tools

Tool	Description
oa_summary	Spending breakdown by category for a given month
oa_profit_loss	P&L report — total income, expenses, and net income
oa_budgets	Budget vs actual spending per category
oa_savings	Savings rate data over time
oa_alerts	Spending alerts and budget warnings
oa_net_worth	Net worth summary across all accounts
oa_net_worth_trend	Net worth trend over time
oa_transactions	Search and filter individual transactions
oa_goals	Active financial goals and progress

Security

• Read-only — no mutation tools exposed
• Localhost only — Wilson dashboard binds to localhost by default
• Auth required — bearer token + RBAC enforced server-side
• Optional tools — must be explicitly enabled per OpenClaw config
• SQLCipher compatible — plugin never touches the database file

Warning: If your OpenClaw gateway is connected to shared channels (Discord, Slack, etc.), financial data could be exposed through those channels. Use this plugin only on personal, single-user gateways.

Development

git clone https://github.com/openaccountant/openclaw-plugin
cd openclaw-plugin
npm install
npm run build

For local testing, install from the local directory:

openclaw plugins install ./path/to/openclaw-plugin