核心用法
Finance Skill 是一个本地优先的个人财务管理层,通过解析银行账单(PDF/图片)自动提取交易记录,存储于 ~/.openclaw/workspace/finance/transactions.json,并提供自然语言查询能力。
主要流程:
1. 账单解析:使用 pypdf 提取完整 PDF 文本(关键:Telegram 预览会截断,必须全页提取),通过视觉模型解析交易明细
2. 数据存储:交易以 JSON 格式持久化,包含 UUID、日期、商户、金额(负数为支出)、分类、来源文件等元数据
3. 智能查询:支持按时间范围、消费类别(food/transport/shopping/bills/entertainment/health/travel/other)、金额排序等多维度聚合分析
4. 手动录入:口语化输入即可快速补录现金交易
显著优点
- 完全离线:所有数据本地存储,无云端传输,隐私风险极低
- 多源兼容:支持信用卡账单截图、PDF 对账单,特别标注 Coinbase Card 等无 Plaid 支持的卡种
- 验证机制:强制校验提取金额与账单总计是否匹配,防止遗漏
- OpenClaw 原生集成:遵循统一工作区规范,与会话记忆系统协同
潜在缺点与局限
- 无自动同步:当前版本依赖手动上传账单,Plaid 银行直连列为未来功能
- 解析依赖视觉模型:复杂排版账单可能存在提取错误,需人工复核
- 单用户设计:无多账户/多币种管理,家庭共享场景不适用
- 无预算/报表功能:仅提供原始查询,缺乏可视化图表或预警系统
适合人群
- 隐私敏感型用户(拒绝 Mint/YNAB 等云服务)
- 加密货币持卡人(Coinbase Card 等无 Plaid 支持的卡种)
- 轻量级记账需求者,愿接受手动账单上传换取数据主权
- 开发者/技术用户,可扩展 Plaid 集成或自定义分析脚本
常规风险
| 风险类型 | 等级 | 说明 |
|---------|------|------|
| 数据安全 | 低 | 本地 JSON 存储,无网络传输;建议配合磁盘加密 |
| 解析准确性 | 中 | 依赖模型 OCR,关键交易建议人工抽查验证 |
| 数据丢失 | 中 | 无自动备份机制,需用户自行管理 `transactions.json` 副本 |
| 功能依赖 | 低 | 单一依赖 `pypdf`,社区成熟维护中 |