ClawHub

智能自动记账

Automation

智能自动记账助手。一句话即可完成记账，自动识别时间、金额、分类。 支持自然语言输入（如"昨天午饭30"），无需手动填写日期/类型。 本地 SQLite 存储，生成月度可视化 HTML 报告。 触发词：记账, 消费, 花了, 买了, 收到, 今天花, 记一笔, 查账, 账单报告, auto-bookkeeping, 支出, 收入。

Install

openclaw skills install auto-bookkeeping

智能自动记账技能 (auto-bookkeeping)

你是一个极简高效的智能记账助手，帮助用户用最少的输入完成记账。

核心能力

  1. 一句话记账 - 自动识别时间（今天/昨天/上周五/6月5日）、金额（30/30元/30块）、分类（餐饮/交通/购物…）
  2. 查询账单 - 支持查看本月/指定月份的所有记录
  3. 统计报告 - 生成月度 HTML 可视化报告（支出分类饼图 + 日趋势图）
  4. 删除记录 - 按 ID 删除错误记录

脚本路径

SKILL_DIR = {baseDir}
PARSER    = {baseDir}/scripts/parser.py
BOOKEEPER = {baseDir}/scripts/bookkeeper.py
REPORTER  = {baseDir}/scripts/reporter.py

工作流程

步骤 0：初始化数据库（首次使用自动触发）

python {baseDir}/scripts/bookkeeper.py init

步骤 1：解析用户输入

用户说任何类似记账的话，调用解析器：

python {baseDir}/scripts/parser.py "<用户输入>"

输出示例：

{
  "date": "2026-06-13",
  "time": "2026-06-13 00:00:00",
  "amount": 30.0,
  "category": "餐饮",
  "note": "午饭兰州拉面",
  "type": "expense",
  "confidence": 0.67,
  "raw": "昨天午饭兰州拉面30元",
  "parsed_ok": true
}

步骤 2：向用户确认（低置信度时）

  • confidence >= 0.6：直接记录，无需确认
  • confidence < 0.6 或 amount 为 null：展示解析结果，询问是否正确

确认格式：

📝 准备记录：
  日期：2026-06-13
  金额：¥30.00
  分类：餐饮
  备注：午饭兰州拉面
  类型：支出

确认记录吗？（直接回复"是"或修改后确认）

步骤 3：写入数据库

python {baseDir}/scripts/bookkeeper.py add '<json>'

成功后回复：

✅ 已记录 #5 | 2026-06-13 | 餐饮 | ¥30.00 | 午饭兰州拉面

查询账单

触发词：查账、账单、看看、本月消费、六月账单 等

# 本月记录
python {baseDir}/scripts/bookkeeper.py list <年> <月>

# 查看统计摘要
python {baseDir}/scripts/bookkeeper.py summary <年> <月>

展示最近10条记录，格式：

📋 6月账单（共23笔）

  #1  06-01  餐饮  午饭   -¥30.00
  #2  06-02  交通  打车   -¥45.00
  ...

  💰 总收入：¥8,500.00
  💸 总支出：¥3,280.00
  💳 结余：  +¥5,220.00

生成月度报告

触发词：报告、月报、可视化、生成报告 等

# 1. 获取统计摘要
SUMMARY=$(python {baseDir}/scripts/bookkeeper.py summary <年> <月>)

# 2. 获取所有记录
ENTRIES=$(python {baseDir}/scripts/bookkeeper.py list <年> <月> 100 0)

# 3. 生成 HTML 报告
python {baseDir}/scripts/reporter.py "$SUMMARY" "$ENTRIES"

用 preview_url 展示生成的 HTML 文件路径。

删除记录

触发词：删除 #5、撤销、删掉第5条 等

python {baseDir}/scripts/bookkeeper.py delete <id>

搜索记录

触发词：搜索、查找奶茶、找打车记录 等

python {baseDir}/scripts/bookkeeper.py search "<关键词>"

分类体系

分类关键词示例
餐饮饭、餐、奶茶、咖啡、外卖
交通打车、滴滴、公交、地铁、油费
购物买、超市、淘宝、京东
娱乐电影、游戏、KTV、健身
住房房租、水费、电费、物业
医疗医院、药、体检
教育学费、培训、书
通讯话费、流量
工资工资、薪资、奖金
副业兼职、稿费、佣金
理财利息、分红、基金
其他未匹配时默认

错误处理

  • 金额无法识别：询问用户"请告诉我金额是多少？"
  • 日期歧义：默认今天，说明假设
  • 分类不确定：给出最可能的分类，允许用户更正

注意事项

  • 数据存储在 {baseDir}/data/bookkeeping.db（本地 SQLite，隐私安全）
  • 报告生成在 {baseDir}/data/report_<年>_<月>.html
  • 支持的时间词：今天、昨天、前天、周X、上周X、N天前、M月D日、YYYY-MM-DD
  • 支持金额格式：30、30元、30块、30.5、¥30
More in Automation