openclaw-accounting

Description

A powerful local AI accounting assistant that helps you record daily income and expenses through natural language, query transactions, and generate statistical reports. All data is securely stored locally — no internet connection required.

Capabilities

1. Natural Language Accounting
2. Record income and expenses through conversation
3. Automatically detect amount, category, and date

4. Smart category suggestions

5. Transaction Queries

6. Query by time range (today, this week, this month, this year, etc.)
7. Filter by category
8. Keyword search

9. Support for multi-condition combined filtering

10. Statistical Analysis

11. Total income and expense summary
12. Category breakdown analysis
13. Daily average spending calculation

14. Balance auto-calculation

15. Report Generation

16. Generate detailed income/expense reports
17. Category statistics TOP ranking
18. Export support

Usage Examples

Recording Transactions - "Record expense: lunch 35 yuan" - "Income: salary received 15000 yuan" - "Spent 120 on movie tickets, category entertainment" - "Transport today 20 yuan"

Querying Transactions - "Show this month's transactions" - "How much did I spend this week" - "Query food and dining expenses" - "Show last month's income"

Statistics - "Summarize this month's income and expenses" - "Spending overview for this year" - "Show my expense categories"

Available Tools

add_transaction Add a transaction record - type: expense or income - amount: amount - description: description - category: category (optional) - tags: tags (optional)

query_transactions Query transaction records - period: time range - type: transaction type filter - category: category filter - keyword: keyword search - limit: result count limit

get_statistics Get income/expense statistics - period: statistics time period

generate_report Generate detailed report - period: report time period

get_categories Get all available categories

update_transaction Update a transaction record - id: record ID - other fields to update

delete_transaction Delete a transaction record - id: record ID

Category System

Expense Categories - Food & Dining: meals, takeout, beverages, etc. - Transport: bus, subway, taxi, fuel, etc. - Shopping: supermarket, online shopping, daily necessities, etc. - Entertainment: movies, games, travel, etc. - Healthcare: doctor visits, medicine, checkups, etc. - Education: tuition, training, books, etc. - Housing: rent, mortgage, utilities, etc. - Utilities: phone bill, internet, etc. - Other

Income Categories - Salary: monthly salary, annual salary, etc. - Bonus: year-end bonus, performance bonus, etc. - Investment: stocks, funds, wealth management, etc. - Freelance: side jobs, self-employment, etc. - Gift: monetary gifts, red envelopes, etc. - Reimbursement: expense reimbursement, refunds, etc. - Other

Data Storage

• All data saved in local JSON files
• Path: configured data directory / accounting.json
• Auto backup: retains the last 30 backups
• Open data format, exportable at any time

Quick Commands

• /accounting.help - Show help
• /accounting.stats - Quick view of this month's statistics

Notes

1. The data file is created automatically on first use
2. Use positive numbers for amounts
3. Edit/delete operations require the record ID (obtainable via query)
4. Back up your data file regularly to prevent accidental loss