💡 提示：支持 ws:// 和 wss://（WebSocket Secure）协议，可填写完整 URL 如 wss://ws-napcatqq.example.com

环境变量

可替代配置文件，适用于 Lagrange 等：

| 变量 | 说明 | |------|------| | ONEBOT_WS_TYPE | forward-websocket / backward-websocket | | ONEBOT_WS_HOST | 主机地址 | | ONEBOT_WS_PORT | 端口 | | ONEBOT_WS_ACCESS_TOKEN | 访问令牌 |

使用

1. 安装并配置
2. 重启 Gateway：openclaw gateway restart
3. 在 QQ 私聊或群聊中发消息（群聊需 @ 机器人，或配置关键字触发）

关键字触发回复

除了 @ 机器人外，还可以配置关键字检测，当群消息中包含指定关键字时自动触发回复（无需 @）。

{
  "channels": {
    "onebot": {
      "keywordTriggers": {
        "enabled": true,
        "keywords": ["AI", "助手", "帮我问"],
        "caseSensitive": false
      }
    }
  }
}

| 配置项 | 说明 | |--------|------| | enabled | 是否启用关键字触发 | | keywords | 关键字列表，包含任一关键字即触发 | | caseSensitive | 是否区分大小写 |

长消息处理与 OG 图片渲染

当单次回复超过长消息阈值（默认 300 字）时，可选用三种模式（openclaw onebot setup 中配置）：

| 模式 | 说明 | |------|------| | normal | 准流式分段发送：边生成边聚合，按时间窗口或长度阈值增量发送 | | og_image | 将 Markdown 转为 HTML 再生成图片发送（需安装 satori 和 sharp） | | forward | 合并转发（发给自己后打包转发） |

normal 模式默认会开启块流式接收，并在插件侧做短时间聚合，默认规则：

• normalModeFlushIntervalMs: 1200
• normalModeFlushChars: 160

也就是回复不会逐 token 刷屏，而是大约每 1.2 秒或累计到 160 字左右就发送一段。可在 openclaw.json 中手动调整：

{
  "channels": {
    "onebot": {
      "longMessageMode": "normal",
      "normalModeFlushIntervalMs": 1200,
      "normalModeFlushChars": 160
    }
  }
}

选择 生成图片发送（og_image） 时，会额外询问渲染主题：

| 选项 | 说明 | |------|------| | default | 无额外样式，默认白底黑字 | | **...