bill-reminder（账单提醒）

账单提醒技能

🦆 你的私人账单管家，再也不怕忘记还款！

🎯 功能特性

• ✅ 支持多种账单类型（信用卡、花呗、房租、水电费等）
• ✅ 灵活周期设置（每月、每周、每年）
• ✅ 提前 N 天提醒，避免逾期
• ✅ 微信消息提醒，及时触达
• ✅ 还款记录自动保存
• ✅ 逾期提醒（前 3 天持续提醒）
• ✅ 命令行操作，简单高效

🚀 快速开始

1. 安装

# 自动安装（发布后）
npx clawhub@latest install bill-reminder

# 或手动安装
cd ~/.openclaw/workspace/skills/bill-reminder
./install.sh

2. 添加账单

# 基本用法
./scripts/add-bill.js "信用卡" 5000 15

# 完整参数
./scripts/add-bill.js "信用卡" 5000 15 monthly 3
# 参数：名称 金额 日期 周期 提前天数

3. 查看账单

./scripts/list-bills.js

4. 标记还款

./scripts/mark-paid.js 1 "已还清"

📋 命令详解

添加账单 add-bill.js

./scripts/add-bill.js <名称> <金额> <日期> [周期] [提前天数]

参数说明：

示例：

# 信用卡每月 15 号 5000 元，提前 3 天提醒
./scripts/add-bill.js "信用卡" 5000 15

# 花呗每月 8 号 2000 元，提前 1 天提醒
./scripts/add-bill.js "花呗" 2000 8 monthly 1

# 房租每月 1 号 3000 元，提前 5 天提醒
./scripts/add-bill.js "房租" 3000 1 monthly 5

# 每周提醒（如：周报）
./scripts/add-bill.js "周报" 0 1 weekly 1

# 每年提醒（如：保险）
./scripts/add-bill.js "车险" 3000 15 yearly 7

查看账单 list-bills.js

# 查看活跃账单
./scripts/list-bills.js

# 查看所有账单（包括已删除）
./scripts/list-bills.js --all

# 查看还款历史
./scripts/list-bills.js --history

输出示例：

📋 账单列表

============================================================

1. ⚠️ 信用卡
   💰 ¥5000
   📅 每月 15 日
   ⏰ 提前 3 天提醒
   📆 还有 2 天到期
   ✓ 上次还款：2026/2/15

2. ✅ 房租
   💰 ¥3000
   📅 每月 1 日
   ⏰ 提前 5 天提醒
   📆 还有 15 天到期
   ✓ 上次还款：2026/3/1

============================================================
总计：2 个账单

标记还款 mark-paid.js

./scripts/mark-paid.js <序号> [备注]

示例：

# 标记第 1 个账单已还
./scripts/mark-paid.js 1

# 添加备注
./scripts/mark-paid.js 2 "已还清全部"

删除账单 remove-bill.js

./scripts/remove-bill.js <序号>

示例：

# 删除第 1 个账单
./scripts/remove-bill.js 1

⏰ 自动提醒

定时任务

安装时会自动添加 cron 任务，每天 9:00 检查账单：

0 9 * * * /path/to/bill-reminder/scripts/check-bills.js >> ~/.openclaw/logs/bill-reminder.log 2>&1

提醒规则

防重复机制

• 同一天的同类型提醒只发送一次
• 次日自动清除标记，允许再次提醒

💬 微信提醒示例

提前提醒

⏰ 账单提醒

📋 招商银行信用卡
💰 ¥5000
📅 15 日到期

还有 3 天，别忘了哦～ 🦆

到期提醒

⚠️ 今天到期！

📋 招商银行信用卡
💰 ¥5000

今天最后期限，快还！🦆

逾期提醒

🚨 已逾期！

📋 招商银行信用卡
💰 ¥5000
📅 逾期 2 天

赶紧还，要产生利息了！🦆

还款确认

✅ 已记录还款！

📋 招商银行信用卡
💰 ¥5000
📅 下次到期：4 月 15 日

继续保持良好的信用记录～ 🦆

📁 文件结构

bill-reminder/
├── SKILL.md                    # 本文件
├── README.md                   # 快速入门
├── package.json                # 项目配置
├── install.sh                  # 安装脚本
├── scripts/
│   ├── add-bill.js             # 添加账单
│   ├── list-bills.js           # 查看账单
│   ├── remove-bill.js          # 删除账单
│   ├── mark-paid.js            # 标记还款
│   └── check-bills.js          # 检查到期（cron 用）
├── data/
│   └── bills.json              # 账单数据存储
└── tests/
    └── test-bill-reminder.sh   # 测试脚本

💾 数据格式

data/bills.json 存储所有账单数据：

{
  "bills": [
    {
      "id": "bill_1711432800000",
      "name": "招商银行信用卡",
      "amount": 5000,
      "dueDay": 15,
      "cycle": "monthly",
      "advanceDays": 3,
      "userId": "o9cq802hhREiOXPlXq_Tgb0MjPTo@im.wechat",
      "createdAt": "2026-03-26T13:00:00Z",
      "lastPaid": "2026-02-15T10:30:00Z",
      "nextDue": "2026-04-15T00:00:00Z",
      "status": "active"
    }
  ],
  "paymentHistory": [
    {
      "billId": "bill_1711432800000",
      "paidAt": "2026-02-15T10:30:00Z",
      "amount": 5000,
      "note": "已还清"
    }
  ]
}

🔧 配置

环境变量

修改提醒时间

编辑 crontab：

crontab -e

修改第一行（9 改成你想要的小时）：

0 9 * * * /path/to/check-bills.js >> ...

❓ 常见问题

Q: 支持多个用户吗？

A: 目前每个用户需要单独配置。可以在添加账单时指定不同的 userId。

Q: 可以设置多个提醒时间吗？

A: 目前固定每天 9:00 检查。如需多次提醒，可以添加多个 cron 任务：

# 早晚各检查一次
0 9 * * * /path/to/check-bills.js >> ...
0 20 * * * /path/to/check-bills.js >> ...

Q: 数据会丢失吗？

A: 数据存储在本地 JSON 文件，建议定期备份：

cp ~/.openclaw/workspace/skills/bill-reminder/data/bills.json ~/backup/bills-$(date +%Y%m%d).json

Q: 支持农历日期吗？

A: 目前只支持公历。农历需求可以提 Issue～

Q: 逾期后怎么停止提醒？

A: 标记还款即可：

./scripts/mark-paid.js <序号>

🔒 安全说明

• 所有数据存储在本地，不会上传
• 微信消息通过 OpenClaw 官方渠道发送
• 建议定期备份 data/bills.json

📝 更新日志

v1.0.0 (2026-03-26)

• ✅ 初始版本发布
• ✅ 支持添加/查看/删除账单
• ✅ 支持标记还款
• ✅ 自动到期检查（cron）
• ✅ 微信提醒（提前/到期/逾期）
• ✅ 还款历史记录

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

MIT-0 License

🦆 作者

鸭鸭 (Yaya) - 你的私人账单管家