An AI-powered personal finance tool that tracks expenses and income using natural language processing and secure local JSON storage.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install zhichu-tracker
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 zhichu-tracker 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 Smart Expense Tracker (zhichu-tracker)?
The Smart Expense Tracker is a sophisticated Openclaw Skills integration designed for seamless personal financial management. It allows users to log transactions by simply typing phrases in natural language, such as "Lunch cost 35 yuan" or "Received 8000 salary." By leveraging intelligent keyword mapping, it automatically categorizes spending into buckets like dining, transport, and shopping, ensuring your financial data is organized without manual overhead.
This skill prioritizes privacy by keeping all financial records in a local JSON format, ensuring no sensitive data is uploaded to the cloud. It is an ideal tool for developers and power users who want a CLI-first approach to budgeting, trend analysis, and consumption monitoring within their existing development workflows.
Smart Expense Tracker (zhichu-tracker) Use Cases
- Rapidly log daily expenses and income using natural language commands.
- Generate multi-dimensional financial reports including daily, weekly, and monthly summaries.
- Perform trend analysis to identify spending patterns and potential savings over 30 or 90 days.
- Detect consumption anomalies where spending significantly exceeds historical averages.
- Maintain a strictly private and local financial database for personal accounting.
How Smart Expense Tracker (zhichu-tracker) Works
- The user inputs a natural language string describing a transaction via the CLI.
- The script parses the input to extract key metadata including amount, date, and transaction type (income/expense).
- An automated classification engine matches the description against a keyword dictionary to assign the correct category.
- The transaction is assigned a unique ID and appended to a local JSON database file.
- The report generator script queries the local database to calculate totals, averages, and trends based on user-defined timeframes.
Smart Expense Tracker (zhichu-tracker) Setup
To deploy this skill within your Openclaw Skills environment, ensure you have Python 3.9 or higher installed. No external dependencies are required as the skill utilizes the Python standard library.
# Navigate to the project directory
cd smart-expense-tracker
# Record an expense using natural language
python scripts/expense-tracker.py add "Lunch today cost 35 yuan"
# Record income
python scripts/expense-tracker.py add "Received monthly salary 8000"
# Generate a weekly report
python scripts/report-generator.py weekly
Smart Expense Tracker (zhichu-tracker) Data Schema & Taxonomy
The skill manages its data in a structured JSON format located at ~/.openclaw/workspace/data/expenses/expenses.json. Below is the schema for each transaction record:
| Attribute | Type | Description |
|---|---|---|
id |
String | Unique hash for transaction identification |
date |
String | ISO formatted date (YYYY-MM-DD) |
type |
String | Transaction type: 'expense' or 'income' |
amount |
Float | The numerical value of the transaction |
category |
String | Mapped category (e.g., Dining, Transport, Salary) |
note |
String | Extracted description or manual note |
raw_text |
String | The original natural language input string |
created_at |
String | Timestamp of record creation |
Smart Expense Tracker (zhichu-tracker) Advanced Features
- Custom keyword mapping via
assets/categories.jsonto tune the auto-classification engine. - Support for consumption anomaly detection which flags any spending exceeding 2x the rolling average.
- Budget threshold alerts that can be configured per category to prevent overspending.
- JSON output mode for the report generator, allowing for easy integration with other data visualization tools.
- Programmatic API support, enabling the tracker to be imported as a Python module for custom automation scripts.
SKILL.md
Loading
Related Openclaw Skills
Xinqing Journal
An intelligent, privacy-focused mood tracker that uses natural language processing to analyze daily emotions and generate comprehensive wellness reports.
Smart Expense Tracker
A sophisticated personal finance tool that uses natural language processing to track expenses and generate insightful financial reports.
Mood Diary
A privacy-first AI journaling tool that uses natural language processing to analyze Chinese diary entries and track emotional health locally.
DiaryBeast
A gamified habit-building skill where daily journaling keeps a virtual pet alive and earns blockchain-based rewards.
BlockBeats to ChainThink Content Automator
An automated workflow skill that scrapes BlockBeats articles and saves them directly to the ChainThink backend as drafts.
WeChat Article Assistant
A comprehensive writing and formatting engine designed to produce human-like, viral-ready WeChat public account articles with automated layout and styling.
Featured*
