octop v0.9.24 不支持 qq 消息通道,需通过外部机器人平台(如 openclaw)中转:qq bot 接收消息 → openclaw 鉴权路由 → 调用 octop 的 openai 兼容 api → 格式化响应返回 qq。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Octop v0.9.24 本身不直接支持 QQ 消息通道,它是一个面向 LLM 接口调用与工作流编排的轻量级工具(类似简易版 LangChain + API 网关),原生只支持 HTTP、OpenAI 兼容接口、本地模型等通道。QQ 消息接入需依赖外部机器人平台中转,Octop 仅作为后端推理服务被调用。
要让 Octop 处理来自 QQ 的消息,实际是构建「QQ Bot → 中间网关(如 OpenClaw)→ Octop」的链路。以下是具体可行路径:
QQ 消息进 Octop 的标准流程
- QQ 用户发送消息给 Bot(私聊或频道)
- Bot 收到事件后,通过 Webhook 或 SDK 将消息内容(含 sender、content、channel_id 等)转发给中间网关(例如 OpenClaw)
- OpenClaw 对请求鉴权、过滤、路由后,以标准 OpenAI
/v1/chat/completions格式调用 Octop 的 API 端点 - Octop 返回响应,OpenClaw 再将结果格式化为 QQ 支持的消息体(文本/Markdown/图片等)发回
关键配置步骤
-
确保 Octop 已启用 HTTP 服务
启动时加参数:octop serve --host 0.0.0.0:8000 --allow-origin "*"
或在config.yaml中开启:server: host: "0.0.0.0" port: 8000 cors: true
-
在 OpenClaw 中配置 Octop 为模型后端
进入 OpenClaw 控制台 →「模型管理」→ 新增自定义模型 → 填写:- 模型名称:
octop-local - API 地址:
http://your-server-ip:8000/v1/chat/completions - 请求头:
Authorization: Bearer your_octop_api_key(若启用了 key) - 注意勾选「启用流式响应」和「兼容 OpenAI schema」
- 模型名称:
QQ Bot 侧无需修改 Octop 配置
Octop 不感知 QQ 协议,也不需要 AppID/AppSecret。所有 QQ 相关凭证(如AppID、AppSecret、Token)均由 OpenClaw 或你自建的 Bot 服务管理。
补充说明
- 若你跳过 OpenClaw,想自己写一个轻量 Bot 服务桥接 QQ 和 Octop,可用 Python +
qq-bot-sdk或 Node.js +qq-guild-sdk实现:监听DIRECT_MESSAGE事件 → 提取d.content→ POST 到http://localhost:8000/v1/chat/completions→ 解析 Octop 返回的choices[0].message.content→ 调用sendMessage回复。 - Octop v0.9.24 尚未内置 QQ 协议适配器,未来版本可能通过插件机制支持,但当前必须靠外部服务衔接。
不复杂但容易忽略:QQ 消息体中的 @用户、表情、引用消息等需在中间层做清洗或保留,否则 Octop 可能误判意图。建议在 OpenClaw 的「预处理脚本」中统一 strip 或转换。











