Simplify Budget Plugin
simplify-budget is an OpenClaw plugin package for running a personal budget tracker on top of a specific Google Sheets template.
It exposes an OpenClaw HTTP route and runs the bundled budget scripts directly. This package is for plugin installation, not skill-only installation.
It handles:
- expense create, find, update, delete
- income create, find, update, delete
- recurring item create, find, update, delete
- summary and cross-ledger lookup routes
- conversation preview/write/learn flows through the bundled bridge script
Required Sheet
This plugin only works with the Simplify Budget sheet template, or a direct copy of it:
Each user must make their own copy of the sheet and configure their own Google service account credentials.
Optional browser UI for the same system:
The plugin talks to the Google Sheet directly. The web UI is optional.
What This Ships
This package contains:
openclaw.plugin.json: plugin manifestindex.js: plugin entrypointscripts/: bundled budget scripts used by the pluginCONVERSATION_WORKFLOW.md: conversation-layer reference
Required Configuration
This plugin requires:
GOOGLE_SA_FILESPREADSHEET_IDTRACKER_CURRENCY
Optional:
TRACKER_CURRENCY_SYMBOL
These values must point at a user-owned Google service account key and a user-owned copy of the Simplify Budget sheet template.
Security Scope
- The plugin talks to
sheets.googleapis.comusing the configured Google service account. - It does not need or ship any session-pruning or agent-state migration tooling as part of the published plugin bundle.
- The Google service account should be scoped to Sheets access and shared only with the intended budget sheet.
Install Summary
- Copy the Google Sheet template.
- Create your own Google service account JSON key.
- Share the copied sheet with the service account email.
- Install this plugin package.
- Set the required environment variables.
- Restart OpenClaw.
Full instructions are in SETUP.md.