zhichu-tracker

What This Skill Does

The zhichu-tracker is a powerful, privacy-first personal finance management tool designed for the OpenClaw ecosystem. It allows users to manage their expenses and income using natural language processing (NLP). Instead of manually navigating complex spreadsheets, you can simply type your spending habits as if talking to a friend. The agent automatically parses the input, identifies the amount, categorizes the expenditure (e.g., dining, transportation, shopping), and stores it locally. Beyond basic logging, this skill includes a robust reporting engine capable of generating daily, weekly, and monthly summaries, as well as sophisticated trend analysis and anomaly detection to help you spot overspending patterns.

Installation

To add the smart expense tracker to your agent environment, run the following command in your terminal:

clawhub install openclaw/skills/skills/dyby99-gif/zhichu-tracker

Once installed, the tool will be accessible via your OpenClaw agent, and data will be stored at ~/.openclaw/workspace/data/expenses/expenses.json.

Use Cases

• Daily Budgeting: Quickly log every transaction on the go using natural language.
• Trend Analysis: Monitor whether your monthly 'dining out' or 'shopping' expenses are increasing over time.
• Budget Compliance: Set up categories to track spending against personal monthly goals.
• Automation: Integrate with your automated workflow to export monthly summaries as JSON for external dashboarding or long-term storage.

Example Prompts

1. "记录一下：今天和朋友在外面吃饭，一共花了150块。"
2. "查看一下我最近30天的总支出是多少，特别是餐饮方面的占比。"
3. "生成一份上个月的月报，分析一下我的消费趋势。"

Tips & Limitations

• Privacy: All data stays on your machine in a JSON file. There is no cloud sync, so ensure you backup the data directory manually.
• Accuracy: While the NLP engine is robust, ensure you include keywords like '元', '块', or category-specific nouns (e.g., '打车', '工资') for higher classification accuracy.
• Customization: You can refine the categorization logic by editing the assets/categories.json file. This is useful if you want to add specific budget thresholds for categories like 'Hobbies' or 'Subscriptions'.
• Limitations: Currently, currency conversion is not supported; it assumes a single currency environment as specified in your locale settings.