billclaw

BillClaw 是一款专为 OpenClaw 生态设计的金融数据管理 Skill，采用本地优先（Local-First）架构，旨在帮助用户实现银行交易记录与账单数据的自主管理。

核心用法：用户需安装 @firela/billclaw-openclaw npm 包作为插件，通过 plaid_sync 工具同步 Plaid/GoCardless 银行交易，使用 gmail_fetch 自动抓取邮件账单，并利用 /billclaw-export 命令将数据导出为 Beancount 或 Ledger 会计格式。所有操作需通过显式命令或自然语言指令触发，数据默认存储于本地 ~/.billclaw/ 目录，采用 JSON 格式按月分区保存。

显著优点：首先是数据主权保障，金融数据完全本地存储，配合系统密钥链加密敏感令牌，杜绝云端泄露风险。其次是多源整合能力，覆盖北美（Plaid）、欧洲（GoCardless）及全球 Gmail 账单源。第三是会计生态兼容性，原生支持 Beancount 和 Ledger 双格式，满足复式记账用户需求。此外，开源 MIT 协议确保代码透明可审计，disable-model-invocation: true 设计防止模型擅自操作财务数据。

潜在缺点：Skill 本身为纯文档型配置，实际功能完全依赖外部 npm 包（@firela/* 系列），存在供应链安全风险。配置门槛较高，需自行申请 Plaid Dashboard 和 Google Cloud Console 开发者凭据。地域支持不均衡，亚洲银行机构覆盖有限。作为 T3 来源的个人项目，长期维护稳定性与持续性存疑。

适合群体：注重隐私的技术型用户、Beancount/Ledger 记账爱好者、需要自动化银行对账的财务工作者，以及具备 Node.js 环境配置能力、希望本地化管控金融数据的个人用户。

使用风险：需信任 @firela npm 组织的代码安全性，建议在使用前审查依赖包源码。API 密钥（PLAID_SECRET、GMAIL_CLIENT_SECRET）若泄露可能导致金融账户风险，应避免硬编码于配置文件。首次使用建议在沙箱环境验证 Plaid 集成，并关注 npm 包的安全更新公告。