核心用法
stockClaw-yingyan 是 OpenClaw 与鹰眼量化平台的官方对接 Skill，面向量化交易用户提供四类核心能力：
1. 量化图生成：用户发送单只股票名称或代码（如「平安银行」或「000001」），调用 POST /api/openclaw/stock/message 生成可视化量化图表，返回图片 URL。
2. 行情问答诊断：用户发送「股票名称/代码 + 行情」（如「平安银行行情」），接口返回 TDX 截面数据与结构化提示词，由 OpenClaw 大模型按预设系统提示词完成趋势诊断，输出「趋势判断 / 关键依据 / 风险与反证 / 操作建议」四段式分析。
3. 自然语言 AI 搜股：用户以自然语言描述选股条件（如「涨幅超过 8% 的科技股按换手率排序取前 20 只」），调用 POST /api/openclaw/stock/query，最多返回 20 只股票的精简字段列表（代码、名称、涨幅、换手、细分行业等 19 个固定字段）。单独提供「涨停股」专用接口 GET /api/openclaw/stock/limit-up，自动识别主板（10%）、双创（20%）、北交所（30%）、ST（5%）涨停阈值。
4. WebSocket 实时监控：用户需接收实时信号推送时，先调用 GET /api/openclaw/stock/monitor/stream 获取连接模板，替换 {apikey} 与 {user_id} 后建立原生 WebSocket 长连接至 wss://yingyan.chatface.com/ws/monitor/open，持续监听评级变化信号（prev_rating → latest_rating），过滤 await 无操作状态。
显著优点
- 凭证持久化机制：
config.json中的openclawCredentials对象实现 user_id / apikey 的本地持久化，配置有效期内禁止重复索要，支持对话中动态更新或手动文件编辑，大幅降低交互摩擦。 - 多模态输出：量化图直接返回图片 URL，行情诊断返回结构化 Markdown 分析，搜股返回表格化列表，满足多样化展示需求。
- 意图识别精细：文档明确定义「量化图」「行情诊断」「自然语言搜股」「涨停股查询」「实时监控」五类意图的边界条件，避免接口误调用。
- 安全约束完备：强制 12 位 apikey 格式校验、鉴权失败归因提示、WebSocket 连接失败码（1008）策略拒绝解读，降低调试成本。
潜在缺点与局限性
- 凭证依赖：所有功能依赖鹰眼量化平台会员身份与 API 权限，非公开免费服务，用户需自行注册并获取凭证。
- 搜股字段受限：自然语言搜股仅返回 19 个固定字段，无法自定义扩展；默认 20 只上限，无法突破。
- 监控信号被动：WebSocket 服务端不发送心跳或欢迎包，连接后沉默不代表故障，用户需理解「无消息即无信号」的推送模型。
- 平台绑定：Skill 深度耦合鹰眼量化私有协议，无法迁移至其他行情数据源。
适合人群
- A 股量化投资者：需要快速生成个股量化图表、获取技术面诊断的散户或小型机构。
- 策略研究者：通过自然语言快速筛选股票池，验证选股因子有效性。
- 实时监控需求者：希望接收算法评级变更信号（如从「买入」变为「卖出」）的事件驱动交易者。
常规风险
1. 凭证泄露风险：config.json 以明文存储 apikey，若 Skill 目录权限配置不当，可能导致密钥泄露。建议配合文件级权限管控。
2. 服务可用性风险：WebSocket 长连接可能因网络抖动、会员到期、策略权限变更（返回 1008 关闭码）而中断，需具备基础排障能力。
3. 数据时效性风险：行情数据为 TDX 截面数据，非实时 tick 级数据，高频交易场景不适用。
4. 模型幻觉风险：行情诊断由 OpenClaw 大模型基于提示词生成，虽受 system_prompt 约束禁止绝对化表述，但仍存在概率性语言误读，需配合免责声明使用。