核心用法
BillClaw是OpenClaw生态的本地化金融数据管理技能，采用本地优先（local-first）架构，确保用户金融数据完全自主可控。核心工作流包括三步：①通过交互式向导billclaw setup配置Plaid（美/加）或GoCardless（欧洲）银行账户，及Gmail OAuth账单抓取；②执行billclaw sync按需或定时同步交易流水，自动去重（24小时窗口）；③使用billclaw export导出为Beancount双分录格式或Ledger CLI格式。
OpenClaw插件提供自然语言接口，如"同步上月信用卡账单"等指令可直接触发conversational_sync工具，降低命令行门槛。
显著优点
1. 数据主权：明文JSON本地存储于~/.billclaw/，可选AES-256-GCM加密，凭证托管于系统钥匙串（keytar），从根本上杜绝云端数据泄露风险
2. 多源覆盖：Plaid+GoCardless实现欧美主要银行覆盖，Gmail抓取补充账单场景，形成完整财务数据源闭环
3. 会计级输出：原生支持Beancount（量化投资社区主流）和Ledger（极客首选），而非简陋CSV，满足进阶用户复式记账需求
4. 技术开放性：MIT协议、运行时抽象层设计、事件驱动架构，便于二次开发与跨平台移植
潜在缺点与局限性
- 地理覆盖缺口：亚洲（含中国、日本、东南亚）银行无原生API支持，需依赖手动CSV导入或未来扩展
- Gmail依赖：账单抓取深度绑定Google生态，Outlook/企业邮箱用户无法直接使用
- 版本早期风险：0.0.1初始版本，生产环境长期稳定性待验证，Plaid/GoCardless API变更可能影响兼容性
- 无移动端：纯Node.js/CLI工具链，缺乏iOS/Android原生应用，现场消费记录场景受限
适合人群
- 隐私敏感型用户：拒绝Mint/YNAB等云端记账工具的数据托管模式
- 复式记账实践者：已使用或计划迁移至Beancount/Ledger的技术爱好者
- 欧美银行用户：拥有美国、加拿大、欧洲银行账户，需自动化流水同步
- 开发者/自托管爱好者：希望集成金融数据至个人数据仓库或HomeLab场景
常规风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| API凭证泄露 | Plaid/GoCardless Client Secret本地存储 | 启用keychain加密，避免硬编码 |
| 同步冲突 | 多设备同时写入同一JSON存储 | 建议单主设备+定期备份策略 |
| 数据格式演进 | 0.0.x版本存储格式可能不兼容 | 导出为Beancount作为长期存档格式 |
| 邮件隐私 | Gmail读取权限涉及敏感通信 | 创建专用账单接收邮箱隔离权限 |