billcat-save-my-money（Billcat 帮我省钱）

BillCat Save My Money

通过 BillCat 的 extractbill 与 skill 接口，把自然语言账单描述提取成结构化 JSON 并实际保存到 乖猫记账 App 中，同时支持按 billId 删除账单、按日期范围统计收入支出，以及查询账本和资产汇总。

获取 API Key

1. 下载 乖猫记账 App。
2. 在 App 内给 OpenClaw 发送一条消息 "openclaw"。
3. 返回内容里可拿到 BILLCAT_API_KEY。

配置方式

方式 1：环境变量

# Windows PowerShell
$env:BILLCAT_API_KEY="你的 key"

# macOS / Linux
export BILLCAT_API_KEY="你的 key"

方式 2：写入 ~/.openclaw/.env

BILLCAT_API_KEY=你的 key

方式 3：写入 ~/.openclaw/openclaw.json

这个 skill 现在也会自动读取 skills.entries.billcat-save-my-money.apiKey，并把它当作 BILLCAT_API_KEY 使用。

{
	"skills": {
		"entries": {
			"billcat-save-my-money": {
				"apiKey": "你的 billcat key"
			}
		}
	}
}

也支持显式写成：

{
	"skills": {
		"entries": {
			"billcat-save-my-money": {
				"env": {
					"BILLCAT_API_KEY": "你的 billcat key"
				}
			}
		}
	}
}

优先级：BILLCAT_API_KEY 环境变量 > openclaw.json > ~/.openclaw/.env

命令

在 OpenClaw 工作区运行：

# 默认输出原始 JSON
python {baseDir}/scripts/extract_bill.py --text "中午吃饭160"

# 美化 JSON
python {baseDir}/scripts/extract_bill.py --text "打车花了35" --format pretty

# 输出简洁 Markdown
python {baseDir}/scripts/extract_bill.py --text "收到工资8000" --format md

# 删除一条账单
python {baseDir}/scripts/delete_bill.py --bill-id "账单ID" --format md

# 删除多条账单
python {baseDir}/scripts/delete_bill.py --bill-id "billId1,billId2" --format pretty

# 统计某个时间范围内的总的收入和支出
python {baseDir}/scripts/bill_statistics.py --start-date 20260301 --end-date 20260331 --format md

# 查询某个时间范围内的账本和资产汇总，也可以统计某个时间范围内的账本或者资产的收入和支出情况
python {baseDir}/scripts/list_books_assets.py --start-date 20260301 --end-date 20260324 --format md

# 不传日期，直接查询当前可用账本和资产
python {baseDir}/scripts/list_books_assets.py --format pretty

# 从标准输入读取
echo "昨天买咖啡18" | python {baseDir}/scripts/extract_bill.py --stdin --format pretty

能力说明

1. 提取并保存账单

• 调用 extractbill 接口
• 成功后会直接写入一条账单到乖猫记账 App
• 建议使用 --format md 或 --format pretty，这样更容易看到返回的 billId

2. 删除账单

• 调用 skill 接口，action=delete
• 需要传入一个或多个 billId
• 支持逗号分隔批量删除

3. 账单统计

• 调用 skill 接口，action=statics
• 需要传入 startDate 和 endDate
• 日期格式固定为 YYYYMMDD

4. 账本与资产列表

• 调用 skill 接口，action=list
• 可选传入 startDate 和 endDate
• 返回账本列表 books 与资产列表 assets
• 每个账本/资产都会附带 totalIncome、totalExpense、netAmount

输出格式

注意：每次成功调用接口时，不只是“识别/提取”，而是会实际写入一条账单到乖猫记账 App。

raw

直接返回 BillCat API 原始 JSON。

pretty

格式化后的 JSON，便于阅读。

md

优先提取常见字段并输出为 Markdown；记账结果会优先展示 billId，便于后续删除账单；如果接口字段未知，则回退为 JSON 代码块。

适用场景

• 用户想把一句消费描述转成结构化账单并直接保存到 App
• 用户想在成功记账后拿到 billId 以便后续删除或追踪
• 用户想按 billId 删除一条或多条账单
• 用户想统计某个时间范围内的收入、支出和净额
• 用户想查看某段时间内各账本、资产账户的收入/支出/净额汇总
• 用户要快速识别金额、类型、时间、备注等字段
• 用户要把聊天式输入接入记账流水线
• 用户在做“自动记账”“消费整理”“账单抽取”相关自动化

注意事项

• 该 skill 目前封装的是接口：POST https://billcat.cn/api/app/openclaw/extractbill
• 删除和统计能力封装的是接口：POST https://billcat.cn/api/app/openclaw/skill
• 账本/资产列表查询能力也封装在接口：POST https://billcat.cn/api/app/openclaw/skill
• 虽然接口名叫 extractbill，但调用成功后，账单也会同步保存到乖猫记账 App
• 删除账单必须依赖 billId，因此建议记账时保留原始 JSON，或直接使用 Markdown/pretty 输出查看 billId
• 统计接口当前使用的 action 是 statics
• 列表接口当前使用的 action 是 list
• 输入建议尽量简洁自然，例如：午饭 32、地铁 4 元、3 月房租 2500
• 如果只是想测试，请避免重复提交同一条内容，以免在 App 中生成重复账单
• 如果接口返回了更丰富的分类字段，优先保留原始 JSON 以免丢失信息