SMB 发票追踪器

何时使用此技能

当用户希望执行以下操作时启用：

• 手动添加和追踪发票
• 查看哪些发票尚未结清或已逾期
• 生成现金流报告
• 通过 LLM 生成催款文本（可选，需配置 MINIMAX_API_KEY）

前提条件

• MINIMAX_API_KEY（可选 — 仅在使用 LLM 生成催款文本时需要）
• OpenClaw 网关正在运行

注意：Gmail 邮件扫描、WhatsApp 催款通知、Stripe 支付检测及 Telegram 汇总报告功能在 v1.0 中尚未实现，计划于 v1.1 版本中支持。

工作流程

1. 添加发票

clawhub run smb-invoice-tracker add 
  --payer "Acme Corp" 
  --amount 1500 
  --currency "USD" 
  --due 2026-07-15 
  --note "Q2 consulting"

2. 配置催款语气（可选）

clawhub run smb-invoice-tracker configure 
  --tone "polite" 
  --reminder-schedule "T-7,T-1,T+0,T+7"

支持的语气选项：polite、friendly、firm。

3. 列出发票

# 所有发票
clawhub run smb-invoice-tracker list

# 仅列出未结清发票
clawhub run smb-invoice-tracker list --status outstanding

# 仅列出已支付发票
clawhub run smb-invoice-tracker list --status paid

4. 生成催款文本（可选，依赖 LLM）

clawhub run smb-invoice-tracker send-reminder --id INV-001
# 将催款文本输出至 stdout —— 请人工审核后再发送

5. 标记为已支付

clawhub run smb-invoice-tracker mark-paid --id INV-001

6. 现金流报告

clawhub run smb-invoice-tracker report --period week

输出内容

• 发票账簿：存储于 ~/.openclaw/smb-invoice-tracker/invoices.json
• 催款文本：输出至 stdout（请人工审核后再发送）
• 报告：输出至 stdout

v1.0 版本实际支持的功能

• ✅ 添加 / 列出 / 标记为已支付发票
• ✅ 追踪未结清与已支付状态
• ✅ 现金流报告（含未结余额、到期日等）
• ✅ LLM 生成催款文本（可选，需配置 MINIMAX_API_KEY）
• ❌ Gmail 扫描 —— 尚未实现（计划 v1.1）
• ❌ WhatsApp 催款通知 —— 尚未实现（计划 v1.1）
• ❌ Stripe 支付检测 —— 尚未实现（计划 v1.1）
• ❌ Telegram 汇总报告 —— 尚未实现（计划 v1.1）
• ❌ CSV 导出 —— 尚未实现（计划 v1.1）

成本预期

• LLM 催款文本生成：约 $0.001 / 发票（仅当环境变量中设置了 MINIMAX_API_KEY 时产生）
• OpenClaw：免费、支持自托管

故障排查

发票未显示？

• 检查状态：clawhub run smb-invoice-tracker list

LLM 催款文本未生成？

• 确认环境变量中已正确设置 MINIMAX_API_KEY

是否需要 Gmail / WhatsApp / Stripe 集成？

• 这些功能已在 v1.1 路线图中规划，当前版本尚未实现。