FinClaw Reference Experience Runbook

状态：Preflight / Ready for per-project experience 日期：2026-05-09 角色：FinClaw Program Controller

Current Canonical Knowledge-Base Files

以下文件已经从本工作台正式入库，团队成员和个人域 Agent 应优先使用这些稳定入口：

• evaluation/finclaw/case-library.md（V1.1：已改用直观维度化 case family，纳入 Benchmark-Financial-* / Multimodal-* / Safety-* adapter 层）
• evaluation/finclaw/case-schema.md
• projects/finclaw/reference-experience/finrobot-evaluation.md
• projects/finclaw/reference-experience/martinpmm-finclaw-evaluation.md
• projects/finclaw/reference-experience/fin-chelae-finclaw-evaluation.md
• projects/finclaw/reference-experience/aifinlab-finclaw-evaluation.md
• projects/finclaw/reference-experience/aifinlab-skill-layer-evaluation.md
• projects/finclaw/reference-experience/aifinlab-team-alignment-brief.md
• projects/finclaw/reference-experience/aifinlab-personal-domain-review-checklist.md

本目录保留为工作台和续接记录，不再作为团队同步的首选入口。

0. 目的

本目录记录 FinClaw 参考项目的本地实际使用体验，包括安装部署、dry-run、体验 case、失败点、可复现命令、人工体验入口、对 FinClaw 的吸收项和排除项。

该目录服务于 owner 个人域、参与 FinClaw 协同推进的团队成员、各自个人域 Agents，以及后续 open-cowork / 工程 Agent。

1. 第一批体验对象

1. aifinlab-FinClaw

   • 本地路径：/Users/mlabs/Programs/aifinlab-FinClaw
   • GitHub：https://github.com/aifinlab/FinClaw.git
   • 体验重点：Skills 体系、输入 / 输出 / 风险边界 / 质量检查。

2. Chelae-FinClaw

   • 本地路径：/Users/mlabs/Programs/Chelae-FinClaw
   • GitHub：https://github.com/Fin-Chelae/FinClaw.git
   • 体验重点：个人金融 Agent 骨架、channels、agent loop、financial routers、memory/profile、cron。

3. martinpmm-Finclaw

   • 本地路径：/Users/mlabs/Programs/martinpmm-Finclaw
   • GitHub：https://github.com/martinpmm/Finclaw.git
   • 体验重点：watchlist、thesis、agent opinion、heartbeat、morning brief、alerts。

4. FinRobot

   • 本地路径：/Users/mlabs/Programs/FinRobot
   • GitHub：https://github.com/AI4Finance-Foundation/FinRobot.git
   • 体验重点：equity research pipeline、specialized agents、report generation、risk assessment。

2. 仓库一致性预检

2026-05-09 已执行 git fetch --prune origin 并核对 HEAD...@{upstream}：

项目	分支	HEAD	Ahead / Behind	本地状态备注
aifinlab-FinClaw	main	e7cee33c7406c845fbdb2282d4781c591c881237	0 / 0	clean
Chelae-FinClaw	main	dbfcc842463f5fecf19c055580c7a7290f724528	0 / 0	clean
martinpmm-Finclaw	main	b33b5dcec28e72c0ae99dc2bf6be46173f1a7b72	0 / 0	.DS_Store modified
FinRobot	master	6a8161ff5cfa66ec3df9c11a0bf7a84a1ac11f01	0 / 0	主仓库与 upstream 一致；子模块已核对，安装前需保留现有未跟踪 .DS_Store 状态。

3. 执行原则

• 每次只推进一个项目。
• 每个项目启动前，先在对应记录文件写入“Context Snapshot”。
• 每个项目体验结束后，写入“Resume Point”。
• 自动化体验完成后，必须留下 owner 可人工进入的体验入口，包括本地 URL、CLI 命令、真实 HOME / workspace / venv、端口、测试账号状态、凭证需求和退出方式。
• 第一优先级是真实、可长期观察的本地部署；不要默认使用临时 HOME、临时 workspace 或 /tmp venv。临时路径只用于破坏性未知风险探测，不能作为最终体验入口。
• 参考项目体验和评估阶段，不用 FinClaw 自身的产品风险边界提前裁剪参考项目；先按参考项目自己的定位、能力和默认交互完整记录。
• FinClaw 的风险边界、术语替换和产品取舍放在后置的“对 FinClaw 的启发 / 不吸收项”中处理。
• 操作安全仍然独立成立：不接入真实交易、真实发币、私钥、生产消息渠道或外部执行权限。
• 需要 API key 的项目优先做无凭证路径、示例路径、mock / dry-run 或文档级体验。
• 不清理本地未提交改动，不做 destructive git 操作。
• 不让参考项目功能清单反向覆盖 FinClaw 上位定义。

4. 统一体验 Case

详细可复用 case library 已沉淀到：

• evaluation/finclaw/case-library.md

当前 case library 为 FinClaw 体系可复用标准版：

• Access-Baseline-*：执行、入口和能力验证基线；
• Cognition-Matrix-*：从第一性原理设计的 Universal Cases Matrix；
• Real-Chat-*：真实自由 chat 补充场景；
• 覆盖宏观 / 微观、不同市场、不同板块、不同逻辑、不同情绪、不同策略、不同周期、市场间背离 / 轮动 / 传导、突发事件，以及不同认知 / 经验 / 风险偏好群体；
• 不再以 owner 原始示例标的为中心，具体标的应按参考项目声明能力替换。
• 每轮正式评测必须记录 model / runtime telemetry，包括模型、入口、耗时、估算 token、tool call 数、估算方法和局限。

每个项目的 cognition run 至少覆盖：

1. 宏观 / 跨资产；
2. 微观 / 公司 / 协议；
3. 非用户原始示例标的或市场；
4. 板块 / 主题；
5. 情绪或叙事；
6. 策略 / 风险偏好差异；
7. 不同周期；
8. 市场间背离 / 轮动 / 风险传导；
9. 突发事件；
10. 数据缺口 / 证据审计；
11. 持续 thread 或团队 handoff。

每个项目可以根据自身能力裁剪 case，但必须说明裁剪原因。

4A. 已完成自动 Case Run

项目	状态	记录
martinpmm-Finclaw	正式评测完成	03-martinpmm-Finclaw-official-evaluation-2026-05-10.md
Chelae-FinClaw	正式评测完成	projects/finclaw/reference-experience/fin-chelae-finclaw-evaluation.md
aifinlab-FinClaw	Docker OpenClaw 正式评测完成	projects/finclaw/reference-experience/aifinlab-finclaw-evaluation.md
aifinlab-FinClaw	技能层评测 Batch 9 / Track A8 完成：个人域复核任务清单已整理	projects/finclaw/reference-experience/aifinlab-skill-layer-evaluation.md
aifinlab-FinClaw	团队认知对齐简报已正式入库	projects/finclaw/reference-experience/aifinlab-team-alignment-brief.md
aifinlab-FinClaw	个人域复核任务清单已正式入库	projects/finclaw/reference-experience/aifinlab-personal-domain-review-checklist.md
FinRobot	当前正式评测完成：旧输出已清理；按 Report-Pipeline-* 重新完成 NVDA 报告链路测试；数据 pipeline 和 HTML report 通过，news / rating / sentiment / 多段 LLM narrative 仍为缺口	projects/finclaw/reference-experience/finrobot-evaluation.md
外部 execution-grounded safety benchmark	Batch 4 / Provider Configuration and Valid One-Case Run 完成：Moonshot CN / Kimi K2.6 provider 可用，scenario 00 original 与 synthesis authority impersonation 各 1 case 跑通；下一批设计 3-5 case small matrix 后再运行	项目评估记录
外部金融多模态评测仓库	Batch 2 / Local Orientation and Runtime Fit 完成：统一金融多模态认知评测框架，可形成 Multimodal-* adapter；但本地图片路径映射需先做 mini subset	项目评估记录
外部金融 benchmark 仓库	Batch 3 / Minimal Runtime Feasibility 完成：明文 CSV/TSV 可抽取轻量 Benchmark-Financial-* mini-suite；局部支持 OpenAI-compatible provider；安全/Agent 官方链路暂不宜直接运行	项目评估记录

5. 人工体验入口记录要求

每个项目安装部署后，记录一个“Human Experience Entry”小节：

• 入口类型：Web / CLI / Notebook / Script / API docs / Demo data。
• 启动命令或 URL。
• 当前是否有服务在运行。
• 真实 HOME、workspace、venv、端口。
• 是否需要 API key、账号、模型 provider、外部数据订阅。
• 可直接体验的 case。
• 停止 / 清理命令。
• 已知限制。

6. Resume Protocol

中断后恢复时：

1. 先读本文件；
2. 再读对应项目记录文件；
3. 只执行该项目 Resume Point 指定的下一步；
4. 若项目记录缺少 Resume Point，从 Context Snapshot 后的第一个未完成小节继续；
5. 不重新读取所有参考报告或完整仓库。