StockLobster

使用此技能，可通过 hooks 网关将 StockLobster 告警接入 OpenClaw，并投递至 Telegram 或其他受支持的出站通道。

已确认的有效载荷结构

请参阅 references/payload-format.md 了解已确认的有效载荷 Schema 及示例。

推荐的 OpenClaw Hook 映射配置

当目标为直接投递至 Telegram 时，请使用 agent 映射，而非 wake。

脱敏后的示例：

{
  "hooks": {
    "enabled": true,
    "path": "/hooks",
    "token": "",
    "mappings": [
      {
        "id": "stocklobster-ingest",
        "name": "StockLobster ingest",
        "match": {
          "path": "/stocklobster",
          "method": "POST"
        },
        "action": "agent",
        "wakeMode": "now",
        "agentId": "main",
        "sessionKey": "hook:stocklobster",
        "messageTemplate": "{{payload.text}}",
        "deliver": true,
        "channel": "telegram",
        "to": ""
      }
    ]
  }
}

配置步骤

1. 在 ~/.openclaw/openclaw.json 中启用 hooks 功能。
2. 设置专用的 hooks token，不要复用共享网关 token。
3. 使用 hook 路径 /hooks 和映射路径 /stocklobster，使最终端点为：
   • http://:18789/hooks/stocklobster
4. 请使用 messageTemplate，而非 textTemplate，因为该流程需通过 action: "agent" 实现通道投递。
5. 通过 payload 引用传入 webhook 的字段，例如 {{payload.text}}。
6. 请显式设置以下字段：
   • deliver: true
   • channel: "telegram"
   • to: ""
7. 配置修改后，请重启网关：

openclaw gateway restart

使用 curl 测试

curl -X POST 'http://:18789/hooks/stocklobster' 
  -H 'Authorization: Bearer ' 
  -H 'Content-Type: application/json' 
  -d '{"text":"StockLobster alertnSymbol: TESTnEvent: screen_hitnMessage: TEST hit momentum criterianPrice: 4.92nChange: 3.4%nVolume: 1234567nStrategy: momentumnTimestamp: 2026-04-08T02:21:00.000Z"}'

预期响应：

{"ok":true,"runId":""}

若仅需唤醒会话而不立即推送至 Telegram，请改用 action: "wake" 配合 textTemplate，但该方式属于另一类流程。

故障排查

• hook mapping requires text
  • 对于 wake 类型：渲染后的 textTemplate 为空。
  • 对于 agent 类型：渲染后的 messageTemplate 为空。
  • 当前版本的 OpenClaw 中，模板变量解析上下文为 payload，而非 json。
• Hook 请求已接收，但未收到 Telegram 消息
  • 请确认映射中使用了 action: "agent"。
  • 请确认设置了 deliver: true。
  • 请确认 channel 和 to 字段均已显式指定。
  • 配置文件修改后请重启网关。
• Hook 返回 {"ok":true,"mode":"now"}
  • 这表示触发了一次唤醒事件，但不等同于成功执行了 Telegram 出站投递。
• Hook 返回 {"ok":true,"runId":"..."}
  • 这表示已创建一个 agent 运行实例，用于支持投递能力的处理流程。