核心功能
BillClaw 是一款专为 OpenClaw 设计的财务数据管理技能，采用本地优先架构，核心能力包括：
| 功能模块 | 说明 |
|---------|------|
| 银行交易同步 | 通过 Plaid（美加）或 GoCardless（欧洲）API 自动拉取账户流水 |
| 账单邮件抓取 | 智能识别 Gmail 中的账单/发票邮件，提取关键信息 |
| 多格式导出 | 支持 Beancount、Ledger 等主流复式记账格式 |
| 本地数据主权 | 所有数据存储于 `~/.billclaw/`，不上传第三方服务器 |
显著优点
1. 安全设计优先：敏感凭据存储于系统钥匙串，Token 加密管理；无外部代码执行，纯文档型 Skill
2. 完全透明可控：MIT 开源协议，源码可审计；用户自建 Plaid/Gmail 开发者账户，不经过中间商
3. 零订阅成本：仅需自行申请 API 免费额度，无 Skill 使用费
4. 开放式生态：模块化 npm 包设计，可选 CLI 独立运行或 Connect 自建 OAuth 服务
局限与风险
| 类型 | 说明 |
|-----|------|
| **区域限制** | Plaid 仅支持美加，欧洲需切换 GoCardless；亚洲银行覆盖有限 |
| **配置门槛** | 需自行注册 Plaid Dashboard 和 Google Cloud Console 获取 API 凭据，流程繁琐 |
| **环境依赖** | 要求 Node.js 运行时，纯浏览器环境无法使用 |
| **维护责任** | 数据备份、API 配额管理、Token 续期均需用户自行处理 |
适合人群
- 已使用或计划使用 Beancount/Ledger 的复式记账实践者
- 注重数据隐私、拒绝 SaaS 财务工具的技术用户
- 拥有美加/欧洲银行账户，具备基础 API 配置能力的自托管爱好者
- 希望自动化账单归集，减少手动录入的效率追求者
安全等级说明
本 Skill 本身不执行代码，仅提供调用指引。实际功能由用户自主安装的 npm 包（@firela/billclaw-openclaw 等）实现，符合供应链最小权限原则。凭据全程由用户掌控，无隐蔽数据外泄通道。
---
> 快速开始：配置 PLAID_CLIENT_ID / PLAID_SECRET / GMAIL_CLIENT_ID / GMAIL_CLIENT_SECRET 后，运行 /billclaw-setup 进入交互式向导。