billclaw
Installation
SKILL.md
BillClaw 记账 Skill(OpenClaw / Agent 使用说明)
本 Skill 通过本地 Python CLI 操作 SQLite 账本(db/expenses.db),实现记账、分类管理、报表图表与 Web 看板。Agent 负责自然语言理解与二次确认;脚本负责结构化读写与一致性。
1. 功能概览
- 记账(结构化字段;可选
parse_text辅助从片段补全字段) - 条件查询(日期范围、类型、分类、备注关键词等)
- 删除(先 preview 列候选,用户确认后再 confirm)
- 分类归并(先 preview,用户确认后再批量改 category)
- 用户自定义分类(
user_categories表;记账时category可直接用自定义名) - 报表:深色主题多图 PNG(合图
report_dashboard.png:KPI + 支出/收入环形图 + 每日趋势 + 按月柱图;另有单图expense_by_category.png、income_by_category.png、daily_trend.png、monthly_bar.png)+ 结构化highlights(供你生成有温度的中文总结);data.agent_json中含primary_chart指向合图路径 - Web 看板:本地 Flask +
scripts/dashboard.html+scripts/static/vendor内 Chart.js,支持时间筛选、按月柱状图、分页明细与图表交互(缩放/平移等),离线可开页 - 导出 CSV(可选)
环境变量:BILLCLAW_DB_PATH 可覆盖默认数据库路径。