PhoenixClaw Ledger：零操作财务追踪系统

PhoenixClaw Ledger 可自动从您的日常对话与付款截图中提取财务交易信息，全程无需任何手动输入。

核心能力

工作流程

作为 PhoenixClaw 的插件，Ledger 在 post-moment-analysis 阶段介入：

1. 接收 Moments：从 PhoenixClaw Core 获取已识别的 Moments
2. 识别财务信号：在文本与媒体内容中扫描支出/收入线索
   • 文本：基于语义模式（参见 references/expense-detection.md）
   • 媒体：支付类截图（参见 references/payment-screenshot.md）
3. 数据提取：解析金额、商户、类别、时间戳等字段
4. 分类处理：应用 references/merchant-category-map.md 中定义的规则
5. 去重处理：防止同一笔交易被重复计入
6. 持久化存储：写入 ~/PhoenixClaw/Finance/ledger.yaml
7. 导出生成：使用 assets/daily-finance-section.md 模板生成日记对应章节

显式触发指令

尽管设计为被动运行，用户仍可主动发起交互：

• “我今天／本周／本月花了多少钱？”
• “展示我的支出明细分布”
• “将我的月度预算设为 [金额]”
• “我最主要的支出类别有哪些？”
• “生成 [时间段] 的财务报告”
• “设定一笔 [金额] 的储蓄目标，截止日期为 [日期]”
• “展示我的支出趋势”
• “浏览我所有的交易记录”
• “我在各项目标上的完成情况如何？”

输出结构

~/PhoenixClaw/
├── Journal/
│   ├── daily/2026-02-02.md    # 包含 💰 Finance 章节
│   └── weekly/2026-W05.md     # 周度财务回顾
│
└── Finance/                    # Ledger 专属目录
    ├── ledger.yaml             # 结构化交易数据
    ├── budget.yaml             # 预算配置文件
    ├── goals.yaml              # 财务目标追踪文件
    ├── transactions.md         # 交易浏览器视图
    ├── monthly/
    │   └── 2026-02.md          # 月度财务报告
    └── yearly/
        └── 2026.md             # 年度汇总报告

配置项

Ledger 专属配置位于 ~/.phoenixclaw/config.yaml 中：

plugins:
  phoenixclaw-ledger:
    enabled: true
    default_currency: CNY       # 或 USD、EUR 等
    budget_monthly: 5000        # 月度预算金额
    categories_custom: []       # 用户自定义类别列表
    screenshot_confidence: 0.7  # 截图识别自动录入所需的最低置信度

Cron 与定时报告

Ledger 复用 PhoenixClaw Core 的 Cron 基础设施，并扩展了额外的定时任务：

日度处理（全自动）

无需单独配置。Ledger 已接入 Core 的夜间 Cron 流程：

• Core 每日 22:00 运行 → 触发 post-moment-analysis
• Ledger 自动激活，完成财务信息提取与日记导出

月度报告配置

openclaw cron add 
  --name "PhoenixClaw Ledger monthly report" 
  --cron "0 8 1 * *" 
  --tz "auto" 
  --session isolated 
  --message "Generate monthly financial report for the previous month."

完整配置说明详见 references/cron-setup.md。

文档参考

参考资料（references/）

• expense-detection.md：用于对话解析的语义模式定义
• payment-screenshot.md：截图识别与 OCR 提取技术说明
• merchant-category-map.md：商户到类别的映射规则
• category-rules.md：类别定义及其层级结构
• budget-tracking.md：预算提醒机制与进度计算逻辑
• financial-insights.md：面向 Growth Notes 的模式分析方法
• cron-setup.md：定时任务与报告自动化配置指南
• goal-management.md：财务目标设定与进度追踪机制
• query-patterns.md：自然语言查询模板与匹配逻辑

资源文件（assets/）

• expense-callout.md：对话中识别出的支出条目模板
• receipt-callout.md：截图中识别出的支出条目模板
• daily-finance-section.md：日记集成所用模板
• monthly-report.md：月度总结模板
• yearly-report.md：年度总结模板