在 Octop 中设置 IM 通道

将 Octop 专家连接到飞书、企业微信、钉钉、QQ、微信、Telegram 等平台，让您的团队在日常使用的工具里直接与 AI 专家对话。

将 Octop 专家连接到飞书、企业微信、钉钉、QQ、微信、Telegram 等平台，让您的团队能在日常使用的工具里直接与 AI 专家对话。

​

在哪里配置

通道按专家配置：

个性化 → 通道

在页面顶部选择专家，打开对应平台的开关并填写凭据。

​

各平台接入步骤

飞书

优先在通道抽屉里扫码注册：生成飞书 AI 机器人二维码，用飞书 App 扫一扫扫描并在手机上确认，Octop 会自动填入并保存凭据。

也可以在飞书开放平台创建企业自建应用，获取 App ID 和 App Secret。

1. 在个性化 → 通道中打开飞书开关
2. 点击二维码按钮用飞书扫码，或手填 App ID 和 App Secret
3. 若自行创建应用，将 Octop 显示的回调地址填入飞书应用的事件订阅，并保存飞书侧配置
4. 给机器人发一条消息，确认能收到回复。话题内回复走话题回复接口（reply_in_thread）

也可以用终端向导完成同样的流程：

octop channel feishu-setup

企业微信

在企业微信后台创建自建应用，获取 CorpID、AgentID 和 Secret。

1. 在个性化 → 通道中打开企业微信开关
2. 填入 CorpID、AgentID 和 Secret
3. 将 Octop 显示的回调 URL 配置到企业微信应用中

也可以运行 octop channel bind，用企业微信手机端扫码快速绑定。

钉钉

优先在通道抽屉里扫码注册：生成授权二维码，用同一组织账号登录的钉钉 App 扫码并确认，Octop 会自动创建并启用通道。

也可以在钉钉开放平台创建机器人应用，获取 Client ID 和 Client Secret。

1. 在个性化 → 通道中打开钉钉开关
2. 扫码绑定，或手填 Client ID 和 Client Secret
3. 若自行创建应用，将 Octop 提供的回调地址配置到钉钉应用的消息接收模式，开启相应事件权限并保存

QQ

在 QQ 机器人开放平台注册应用，或在通道抽屉 / CLI 中扫码绑定。

1. 在个性化 → 通道中打开 QQ 开关
2. 优先在通道抽屉中使用扫码绑定（手机 QQ 扫码），或手动填入 App ID 与 Client Secret 并保存
3. 群聊可选配置群聊上下文：可见范围（auto / all / mention_recent / mention_only），以及回复时机（可见范围为 all 时可选 mention 或 always）
4. QQ 私聊默认走官方 stream_messages。保存通道时写入 c2c_streaming: true。只有显式设 c2c_streaming: false 才改回一条静态回复。旧键 streaming / response_mode 对 C2C 无效。群聊、频道、频道私信没有 stream API，仍只发静态消息。工具过程提示会额外占用被动回复配额（每条入站大约 4 条）

终端扫码绑定：

octop channel bind qq --agent main

Telegram

通过 @BotFather 创建 Bot，复制 Bot Token。

1. 在个性化 → 通道中打开 Telegram 开关
2. 填入 Bot Token 并保存

Octop 通过 Telegram Bot API 接入，支持私聊与群组消息。

请妥善保管 Bot Token。一旦泄露，请立即在 BotFather 中重置并更新 Octop 中的配置。

其他

Octop 还提供微信（通过 iLink Bot 接入个人微信）、元宝（腾讯元宝会话场景）、小艺（华为小艺 / OpenClaw，经 A2A 协议接入）和 MQTT（将 IoT 设备或机器人消息路由到 Agent）。

接入方式相同：在个性化 → 通道中打开开关，填写该平台所需的凭据即可。

​

选择回复展示方式

打开通道设置抽屉，在消息展示 → 回复模式中选择：

• **仅终稿（推荐）**会在专家完成后一次性发送回复。工具调用前的过程说明不会发到 IM，生成的媒体会与最终文本一起送达。
• 实时进度保留分阶段的流式更新，适合需要观察执行过程的工作流。

新建外部 IM 通道默认使用仅终稿。显示思考过程与显示工具提示仍是独立的展示开关。QQ 私聊忽略该开关，改用 c2c_streaming。

请将所有凭据安全存放。这些凭据授予对您平台账号的机器人控制权。

终端管理通道（list、test、delete、feishu-setup、bind）见通道与定时任务。