InvestorClaw 综合评估
InvestorClaw 是一款确定性优先（deterministic-first）的本地化投资组合分析工具，采用容器化架构运行，通过 MCP-HTTP 协议为 AI 助手提供标准化工具接口。其核心定位为：让 AI 助手能够真实、可验证地回答用户的持仓相关问题，而非依赖训练数据中的通用金融知识。
核心用法
1. 架构模式：以 Docker Compose 部署，引擎镜像约 600MB，暴露两个本地端口（18090 用于 MCP/REST，18092 用于 Web 仪表板）。数据完全本地存储，PII（账号、SSN 等）在导入时即被脱敏。
2. 典型工作流：
- 用户将券商持仓文件（CSV/XLS/PDF/截图）放入
portfolios/目录 - 引擎自动初始化：setup → refresh → seed_ask，冷启动约 1-3 分钟（200+ 持仓可能 5-15 分钟）
- 此后通过
portfolio_ask工具以自然语言提问，返回带 HMAC 签名的确定性计算结果 + 叙事化总结
3. 二十项工具：涵盖持仓快照、绩效指标（夏普/索提诺比率、最大回撤）、债券久期与到期收益率、行业配置、情景再平衡、新闻与分析师评级、FRED 收益率曲线等。
显著优点
| 维度 | 表现 |
|------|------|
| **确定性验证** | 所有数字经 ic-engine 计算并附加 HMAC 签名，杜绝 LLM 幻觉 |
| **数据主权** | 持仓明细、计算中间态完全本地留存，仅问题与汇总指标送往配置的 LLM 服务商做叙事合成 |
| **多源聚合** | 内置 yfinance、Finnhub、Massive、FRED、Frankfurter 等十余家数据源自动降级策略 |
| **券商兼容** | 支持 Schwab、Fidelity、Vanguard、UBS、E*Trade、Robinhood 等主流导出格式 |
| **成本可控** | 小组合（≤50 标的）仅需 Together AI key（$0.0008/1K tokens），中大组合可选配 Finnhub/Massive |
| **合规设计** | 输出强制标注 "educational only"，工具响应末尾需带 `Verification: ic-engine ask completed` 行供 harness 校验 |
潜在缺点与局限
1. 冷启动延迟：200+ 持仓且无付费数据源时，首问可能耗时 5-15 分钟（引擎需串行拉取行情、新闻、分析师数据）。虽然 IC_INITIALIZE_ON_BOOT=1 可缓解，但大组合仍需配置 Massive key 才能流畅使用。
2. 本地部署门槛：要求用户/代理具备 Docker/Podman 操作能力，且需预创建 portfolios/ 目录避免 UID 权限陷阱。Windows 用户需 WSL2 后端，macOS 需 Docker Desktop。
3. 叙事质量依赖外部 LLM：确定性计算虽可靠，但最终自然语言回答的质量取决于配置的 narrative provider（默认 Together AI Gemma-4-31B）。若 key 缺失，仅返回 stub catalog blurb。
4. 无交易执行能力：纯分析工具，不提供下单、转账等 brokerage API 操作。
5. 版本迭代中的稳定性风险：v4.0.x → v4.1.0 期间曾出现 P1 并行阶段超时、litellm 依赖缺失、模型路由错误等连锁 bug，虽已在 v4.1.1/v4.4.2 修复，但提示早期版本可能存在生产风险。
适合人群
- 隐私敏感型投资者：不愿将完整持仓上传至云端券商或第三方分析平台
- AI 助手重度用户：希望 Claude、OpenClaw、Hermes 等运行时能基于真实持仓回答问题
- 多账户/多券商用户：需要聚合分析跨平台持仓
- 债券与固收投资者：内置久期、YTM、收益率曲线分析，对固收组合支持较好
- 技术背景用户：能接受 Docker 本地部署、API key 配置等运维成本
常规风险
| 风险类别 | 具体表现 | 缓解措施 |
|----------|----------|----------|
| **数据新鲜度** | 新闻 TTL 30s、其他 60s，极端行情下可能滞后 | 用户显式请求 "refresh before answering" |
| **API 速率限制** | yfinance 对 200+ 标的组合易触发 429 | 配置 Massive/Finnhub 付费 key |
| **容器安全风险** | 镜像来自 ghcr.io，虽 pinned SHA256 但仍需信任 Argonaut Systems 构建链 | 自行扫描镜像、审查 Dockerfile |
| **密钥持久化** | keys.env 以 0600 模式存于命名卷，容器内 uid=1000 | 宿主机需保证 docker 组权限安全 |
| **升级/迁移摩擦** | 跨主机迁移需手动处理加密备份或重新录入 key | 首次配置后立即执行 `portfolio_keys_backup` |
来源可信度说明
- 代码开源：引擎代码 Apache 2.0，分发边缘（SKILL.md、compose.yml）MIT-0，可在 GitHub 审计
- 供应链：镜像 pinned 至 SHA256 摘要，支持 reproducible build 验证
- 安全披露：SECURITY.md、PRIVACY.md 完整文档化威胁模型与数据流向
- 历史问题：v4.0.x 版本曾因多 bug 导致功能退化，但维护团队响应及时，v4.4.2 已稳定
综上，InvestorClaw 是技术型投资者实现"AI 助手 + 真实持仓"闭环的严肃工具，其确定性优先架构有效解决了 LLM 金融幻觉问题，但需承担本地部署与数据源配置的运维成本。