BillClaw 是一款面向 OpenClaw 用户的本地优先型财务管理技能，旨在为用户提供完全自主的财务数据掌控能力。其核心功能涵盖三大模块：银行交易同步（通过 Plaid 覆盖美加地区、GoCardless 覆盖欧洲）、Gmail 账单自动抓取，以及向 Beancount 或 Ledger 等纯文本会计格式的数据导出。
核心用法：用户通过 CLI 工具 billclaw setup 完成交互式配置，包括银行账户 OAuth 授权、Gmail API 连接及本地存储路径设置。同步操作支持全量、单账户及日期范围筛选，数据以 JSON 格式按月分区存储于 ~/.billclaw/ 目录。导出功能可生成符合复式记账规范的 Beancount 或 Ledger 语法文件，便于与现有会计工作流集成。OpenClaw 集成后提供自然语言交互能力，如「同步上个月的交易记录」。
显著优点：
- 数据主权：银行凭证仅存本地，规避第三方云服务托管风险
- 区域覆盖：Plaid + GoCardless 组合实现欧美主要银行支持
- 生态兼容：原生支持 Beancount/Ledger 开源会计社区标准
- 自动化能力：Gmail 账单解析减少手工录入负担
潜在局限：
- 技术门槛：需自行部署 Connect OAuth 服务（生产环境需 HTTPS 域名及 TLS 证书配置）
- 区域限制：亚洲、南美等地区银行缺乏直接支持
- 维护成本：Plaid/GoCardless API 凭证需定期轮换，OAuth 回调 URI 配置易出错
- 加密可选：本地存储加密非强制，依赖用户安全意识
适合人群：
- 注重隐私的技术型个人用户
- 已使用 Beancount/Ledger 的复式记账实践者
- 需要自动化银行对账的小微企业主
- 欧洲或北美地区的多银行账户持有者
常规风险：
- OAuth 令牌泄露风险（需妥善保管
~/.billclaw/config.json） - Gmail 权限过度授权（建议限制仅读取邮件元数据）
- 本地数据丢失（无云备份机制，需用户自行制定备份策略）
- API 速率限制可能导致同步中断