核心用法
InvestorClaw 是一款运行在本地 Docker 容器中的确定性投资组合分析工具，通过 MCP-HTTP 协议与 AI Agent 交互。用户将券商导出的持仓文件（CSV/XLS/PDF）放入指定目录后，调用 portfolio_ask 即可获取持仓概览、业绩指标、风险分析等自然语言回答。引擎内部采用 Python 实现，遵循 FINOS CDM 5.x 规范，所有计算结果经 HMAC 签名，确保不可伪造。
显著优点
1. 确定性优先架构：所有财务指标（夏普比率、索蒂诺比率、债券久期、收益率曲线等）均由引擎本地计算，非 LLM 生成，避免"幻觉"风险
2. 隐私本地化处理：原始持仓文件、账户信息、成本基础等敏感数据全程留在本地容器，仅将计算后的摘要信封发送至配置的大模型进行叙事合成
3. 多券商兼容：支持 Schwab、Fidelity、Vanguard、UBS、ETrade、Robinhood 等主流券商导出格式，自动识别并提取持仓数据
4. 冷热缓存机制：容器启动时自动预热缓存（IC_INITIALIZE_ON_BOOT=1），首次查询响应时间从 5-15 分钟降至 1-3 秒
5. 弹性降级能力：无 API Key 时仍可使用 yfinance 基础功能；支持 Together AI、Ollama 等多种大模型后端，可完全离线运行
潜在缺点与局限性
1. 冷启动耗时：200+ 持仓品种的大型组合，首次初始化需 5-15 分钟，依赖上游 API 速率限制
2. 大持仓依赖付费服务：超过 200 个品种时，必须配置 Massive API Key（付费）以避免 Yahoo Finance 全局限流
3. Narrative 合成质量依赖外部 LLM：若未配置 TOGETHER_API_KEY，引擎仅返回结构化数据目录，缺乏自然语言解读
4. 单用户本地绑定：设计为单用户本地运行，未内置多用户认证机制，跨网络访问需自行配置反向代理
5. Docker 环境依赖：需预装 Docker/Podman，Windows 用户需配置 WSL2 后端
适合人群
- 注重隐私、希望持仓数据本地化处理的个人投资者
- 需要夏普比率、债券久期等专业指标计算的进阶用户
- 已使用 Claude Code、OpenClaw 等 MCP 兼容 Agent 的技术型用户
- 持仓品种 50-200 只、愿意配置少量免费 API Key 的中等规模投资者
常规风险
- API Key 管理：密钥持久化存储于 Docker 卷，虽权限设为 0600，但仍需防范主机层面的未授权访问
- 数据时效性：行情数据默认 TTL 60 秒、新闻 30 秒，快速波动市场下可能滞后
- 非投资建议声明：引擎输出为教育性质，不含买卖建议，用户需自行承担投资决策责任
- 模型降级风险：大型组合未配置 Massive Key 时，可能遭遇 Yahoo Finance 429 限流，导致分析中断
合规与认证说明
本技能附带的安全认证报告为系统自动生成的占位文档，未实际执行安全扫描。来源可信度基于开源代码（MIT-0/Apache 2.0 许可）及公开容器镜像，但用户部署后需自行承担运行环境的安全责任。