核心用法
BillClaw 是专为 OpenClaw 设计的本地优先型财务管理工具，主打数据主权与隐私保护。用户可通过自然语言或斜杠命令完成银行交易同步、邮件账单抓取及会计格式导出。
主要功能模块：
- 银行同步：集成 Plaid（北美）与 GoCardless（欧洲）API，获取账户交易流水
- 账单抓取：通过 Gmail OAuth 自动识别并提取电子账单
- 多格式导出：支持 Beancount、Ledger 等纯文本会计格式，便于版本控制与审计
- 对话式交互：
conversational_sync等工具允许用自然语言执行复杂操作
典型工作流：
1. 安装 @firela/billclaw-openclaw 插件
2. 配置 Plaid/Gmail API 凭据（环境变量或配置文件）
3. 执行 /billclaw-setup 完成账户关联向导
4. 使用 /billclaw-sync 或自然语言指令同步数据
5. 导出为 .beancount 或 .ledger 文件供后续分析
数据默认存储于 ~/.firela/billclaw/，采用 JSON 格式按月分区，完全离线可控。
显著优点
1. 本地优先架构：金融数据永不离开用户设备，规避云端泄露风险
2. 开源可审计：全代码托管于 GitHub，npm 包附带加密来源证明（provenance）
3. 灵活集成：既可在 OpenClaw 内通过对话使用，也可独立运行 CLI 工具
4. 标准格式输出：Beancount/Ledger 为会计领域成熟格式，支持 Git 版本管理与 diff 审计
5. 多区域覆盖：Plaid + GoCardless 组合覆盖北美与欧洲主要银行体系
潜在局限
- 技术门槛较高：需自行申请 Plaid/Gmail API 凭据，配置 OAuth 流程对非技术用户不够友好
- 功能边界明确：专注数据获取与格式转换，不包含预算分析、投资追踪等高级财管功能
- 区域限制：亚洲、南美等地区银行缺乏原生支持
- 维护依赖：作为开源项目，长期更新与银行 API 适配依赖社区活跃度
适合人群
- 技术型个人用户：熟悉命令行、愿意自建数据管道的开发者或财务极客
- 隐私敏感者：拒绝 SaaS 财务软件、坚持数据本地化的用户
- Beancount/Ledger 现有用户：希望自动化交易导入的文本记账实践者
- 小企业与自由职业者：需要标准化会计审计线索的轻量级主体
常规风险
| 风险类别 | 说明 |
|---------|------|
| API 凭据泄露 | 用户自行保管 Plaid/Gmail 密钥，若写入 shell 历史或明文配置文件存在暴露风险 |
| 令牌存储 | 虽使用系统钥匙链加密，但本地文件权限配置不当可能导致其他用户读取 |
| 供应链安全 | npm 生态的传递依赖（如 `sets-process-name`）引入的潜在风险，已通过 provenance 缓解 |
| 银行 API 变更 | Plaid/GoCardless 接口调整可能导致同步失效，需及时更新插件版本 |
| 数据完整性 | 本地 JSON 存储无内置备份机制，用户需自行配置版本控制或定时备份 |