A comprehensive natural language interface for the EasyAccounts self-hosted personal finance system, allowing AI agents to record, query, and analyze household finances.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install easyaccounts
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install easyaccounts using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is EasyAccounts?
The EasyAccounts skill is a specialized tool designed to bridge the gap between natural language processing and structured financial management. It interfaces directly with the EasyAccounts personal bookkeeping system, a self-hosted solution featuring a MySQL backend. This skill empowers users to manage expenses, income, and internal transfers through simple conversational commands, making it an essential addition to the Openclaw Skills ecosystem for anyone seeking a private, robust financial tracking solution.
Built for reliability, the skill utilizes a set of hardened shell scripts that handle complex tasks such as UTF-8/GBK encoding for cross-platform compatibility, automated token lifecycle management, and strict validation of financial business logic. Whether you are performing a quick balance check or a deep annual financial audit, this skill provides a developer-friendly way to maintain your ledger without manual data entry in a GUI.
EasyAccounts Use Cases
- Logging daily expenses and income using natural language like "Record 50 dollars for dinner tonight".
- Checking real-time account balances and net worth across multiple financial accounts.
- Performing bulk transaction entries from a single text summary to save time.
- Managing internal transfers between accounts, such as moving funds from a digital wallet to a bank account.
- Exporting historical financial data to Excel for tax preparation or offline analysis.
How EasyAccounts Works
- The user provides a financial request in natural language to the AI agent.
- The skill validates the environment configuration, specifically checking the EASYACCOUNTS_URL for correct formatting.
- It fetches necessary metadata, including account IDs and category types, to ensure the transaction matches the system's requirements.
- The skill executes the operation using optimized helper scripts (like add_flow.sh or query_flows.sh) to ensure data integrity and proper token authentication.
- Upon completion, the skill returns a structured response including transaction details, updated balances, or generated file paths.
EasyAccounts Setup
To get started with the EasyAccounts skill, ensure you have curl and jq installed on your system. Configuration is handled via environment variables in your Openclaw Skills environment.
- Install dependencies:
# For Debian/Ubuntu
sudo apt install jq curl
# For macOS
brew install jq
- Configure your environment in ~/.openclaw/.env:
export EASYACCOUNTS_URL="http://your-server-address:port" # No trailing slash
export EASYACCOUNTS_USERNAME="your_username"
export EASYACCOUNTS_PASSWORD="your_password"
- Initialize authentication:
bash scripts/login.sh $EASYACCOUNTS_USERNAME $EASYACCOUNTS_PASSWORD
EasyAccounts Data Schema & Taxonomy
The skill interacts with a multi-layered data structure where field names may vary depending on the API endpoint used. Below is a summary of the primary data entities:
| Entity | Key Fields | Description |
|---|---|---|
| Accounts | id, name/aname, money | Financial accounts including assets and liabilities. |
| Flows | id, money, fdate, note | Individual transaction records (income, expense, transfer). |
| Types | id (typeId), tname, actionId | Categories like Dining or Transport. |
| Actions | id (actionId), handle, hname | Transaction types (0=Income, 1=Expense, 2=Transfer). |
| Stats | totalAsset, netAsset, yearBalance | Annual and monthly financial aggregations. |
EasyAccounts Advanced Features
- Batch Transaction Support: Process multiple line items in a single execution using batch_add_flow to minimize API overhead.
- Excel Reporting Engine: Generate comprehensive Excel spreadsheets for filtered transaction history directly from the CLI.
- Automated Token Recovery: Features built-in 401 error handling that attempts automatic re-login using environment credentials.
- Intelligent Category Mapping: Automatically resolves the relationship between typeId and actionId to prevent invalid ledger entries.
- System Health & Notices: Real-time integration with system announcements and version update checks to ensure the self-hosted instance is current.
SKILL.md
Loading
Related Openclaw Skills
Smart Home Assistant
A specialized tool for monitoring real-time energy usage and generating automated power-saving logic within Home Assistant.
Elastolink Meeting Assistant
A specialized MCP server skill for managing Elastolink meetings, offering automated tools for list retrieval, status checks, and document exports.
Guofeng Lyric Writer
A specialized AI assistant for composing authentic traditional Chinese-style (Guofeng) lyrics with classical imagery and rhyme schemes.
Quant Stock Picker
An automated AI quantitative stock selection system that analyzes A-share markets using a multi-dimensional scoring model to generate daily investment reports.
JAR Conflict Detector
An automated diagnostic tool for identifying and fixing dependency conflicts and version inconsistencies in Spring Boot applications.
ggzy_collect
An automated scraper designed to collect bidding and tender data from the Zibo Public Resource Trading website and export it into structured Excel reports.
Featured*
