核心用法
BillClaw 是专为 OpenClaw 设计的财务数据管理技能，采用本地优先架构。用户需自行安装 @firela/billclaw-openclaw npm 插件，配置 Plaid 和 Gmail API 凭证后，即可通过对话或命令方式同步银行账户交易、从 Gmail 抓取账单，并导出为 Beancount 或 Ledger 会计格式。
主要功能
- 银行同步: 通过 Plaid（美加）或 GoCardless（欧洲）连接银行账户
- 账单抓取: 自动从 Gmail 提取账单邮件
- 会计导出: 支持 Beancount 和 Ledger 双格式
- 对话式交互: 自然语言指令触发同步和查询
显著优点
1. 本地优先主权: 所有数据存储在 ~/.billclaw/ 本地目录，不上传云端
2. 凭证自控: 用户自行申请并管理 Plaid/Gmail API 密钥，无需信任第三方托管
3. 系统级加密: 敏感 token 使用平台原生钥匙串加密存储
4. 完全开源: MIT 许可证，代码可审计，npm 包独立发布可查验
5. 模型不可自主调用: disable-model-invocation: true 确保需用户显式触发
潜在局限
- 配置门槛: 需自行注册 Plaid/Gmail 开发者账号并获取 API 凭证
- 地域限制: Plaid 仅支持美加，GoCardless 仅限欧洲
- Node 依赖: 要求本地安装 Node.js 环境
- 无内置 UI: 依赖 OpenClaw 对话界面或可选 CLI
适合人群
- 注重数据主权的隐私敏感型用户
- 使用 Beancount/Ledger 的复式记账爱好者
- 有技术能力配置 API 凭证的开发者或进阶用户
- 需要自动化银行对账的个人或小型企业
常规风险
- API 凭证泄露: 若环境变量或配置文件权限设置不当，可能导致凭证暴露
- 本地数据丢失: 无云备份机制，需用户自行备份
~/.billclaw/目录 - 第三方服务依赖: Plaid/GoCardless 服务中断将影响同步功能
- OAuth 配置复杂性: Gmail OAuth 流程对非技术用户存在一定门槛