- name
- billcat-save-my-money
- description
- 使用 BillCat API 从自然语言中提取并保存记账信息到乖猫记账 App，并支持删除账单、账单统计、账本与资产列表查询。适合当用户想把一句中文消费/收入描述转成结构化账单、按 billId 删除账单、按时间范围统计收入支出，或查看账本/资产汇总时使用。
- homepage
- https://github.com/isee15/billcat-save-my-money
- metadata
- {"openclaw":{"emoji":"🐱","requires":{"env":["BILLCAT_API_KEY"]},"primaryEnv":"BILLCAT_API_KEY"}}
BillCat Save My Money
通过 BillCat 的 extractbill 与 skill 接口，把自然语言账单描述提取成结构化 JSON 并实际保存到 乖猫记账 App 中，同时支持按 billId 删除账单、按日期范围统计收入支出，以及查询账本和资产汇总。
获取 API Key
- 下载 乖猫记账 App。
- 在 App 内给 OpenClaw 发送一条消息 "openclaw"。
- 返回内容里可拿到
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 以免丢失信息