核心功能
BillClaw 是一款面向 OpenClaw 用户的开源财务管理技能，采用本地优先架构实现数据主权。核心能力包括：
- 银行交易同步：通过 Plaid（美/加）或 GoCardless（欧洲）直连银行账户，自动拉取交易记录
- 邮件账单抓取：智能解析 Gmail 中的电子账单，自动归类消费
- 会计格式导出：原生支持 Beancount 和 Ledger 两种专业复式记账格式
安全与隐私设计
该工具将安全性置于架构核心：
- 纯本地存储：所有交易数据存放于
~/.billclaw/目录，不上传任何第三方服务器 - 系统钥匙串加密：Plaid 访问令牌、Gmail 刷新令牌均存储于平台原生密钥管理器（macOS Keychain/Windows Credential Manager/Linux Secret Service）
- 最小权限原则：仅访问本地数据目录，无后台自主调用机制，需用户显式触发
- 完全开源可审计：MIT 协议，代码托管于 GitHub
使用方式
提供两层接入方式：
1. OpenClaw 插件（推荐）：@firela/billclaw-openclaw 注册 plaid_sync、gmail_fetch 等工具及 /billclaw-sync 等斜杠命令
2. 独立 CLI：@firela/billclaw-cli 提供完整命令行交互
显著优点
- 数据主权：解决传统记账 SaaS 的数据托管痛点，金融隐私完全自控
- 专业会计集成：原生对接 Beancount/Ledger，满足进阶用户对复式记账、Git 版本控制的需求
- 模块化设计：CLI、Connect OAuth 服务、OpenClaw 插件可独立选用
局限与风险
- 自托管门槛：需自行申请 Plaid/Gmail API 密钥，配置 OAuth 回调，对非技术用户存在学习曲线
- 地域限制：Plaid 覆盖美加、GoCardless 覆盖欧洲，其他地区银行支持有限
- 无云端备份：本地磁盘故障可能导致数据丢失，需用户自行建立备份机制
- 维护责任：开源项目无商业 SLA，安全更新依赖社区或自我维护
适合人群
- 技术背景较强的个人财务管理者
- 重视数据隐私、拒绝云端 SaaS 的"自托管"倡导者
- Beancount/Ledger 现有用户，希望自动化交易录入流程
- 北美/欧洲地区的开发者或高级用户
常规风险提示
1. API 密钥管理：PLAID_SECRET 等敏感配置若泄露，可能导致银行账户访问权限被盗
2. OAuth 回调安全：自托管 Connect 服务时，需正确配置 TLS 和回调域名，防止授权码劫持
3. 数据备份缺失：本地 JSON 存储无自动云备份，建议配合 Git 或 rsync 建立冗余
4. 合规边界：个人使用 Plaid/GoCardless 需遵守其服务条款，高频或商业用途可能触发限制