基于 OpenClaw 的本地优先财务数据管理工具,支持 Plaid 银行同步与 Gmail 账单抓取,确保金融数据完全本地化存储与隐私安全。
说明:
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 包的安全更新公告。








