> ## Documentation Index
> Fetch the complete documentation index at: https://octop.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 Octop 中设置 IM 通道

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

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

## 在哪里配置

通道按专家配置：

```text theme={null}
个性化 → 通道
```

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

![通道](https://mintcdn.com/octop/P_aBdthWeK4YndCE/images/ui-channels.png?fit=max\&auto=format\&n=P_aBdthWeK4YndCE\&q=85\&s=46782370c551bd3e6311d0c1693a02dc)

## 各平台接入步骤

> [tab] 飞书
>
> 优先在通道抽屉里扫码注册：生成飞书 AI 机器人二维码，用飞书 App **扫一扫**扫描并在手机上确认，Octop 会自动填入并保存凭据。
>
> 也可以在[飞书开放平台](https://open.feishu.cn)创建企业自建应用，获取 **App ID** 和 **App Secret**。
>
> 1. 在**个性化 → 通道**中打开**飞书**开关
> 2. 点击二维码按钮用飞书扫码，或手填 App ID 和 App Secret
> 3. 若自行创建应用，将 Octop 显示的回调地址填入飞书应用的**事件订阅**，并保存飞书侧配置
> 4. 给机器人发一条消息，确认能收到回复。话题内回复走话题回复接口（`reply_in_thread`）
>
> 也可以用终端向导完成同样的流程：
>
> ```bash theme={null}
> octop channel feishu-setup
> ```

> [tab] 企业微信
>
> 在企业微信后台创建自建应用，获取 **CorpID**、**AgentID** 和 **Secret**。
>
> 1. 在**个性化 → 通道**中打开**企业微信**开关
> 2. 填入 CorpID、AgentID 和 Secret
> 3. 将 Octop 显示的回调 URL 配置到企业微信应用中
>
> 也可以运行 `octop channel bind`，用企业微信手机端扫码快速绑定。

> [tab] 钉钉
>
> 优先在通道抽屉里扫码注册：生成授权二维码，用同一组织账号登录的钉钉 App 扫码并确认，Octop 会自动创建并启用通道。
>
> 也可以在[钉钉开放平台](https://open.dingtalk.com)创建机器人应用，获取 **Client ID** 和 **Client Secret**。
>
> 1. 在**个性化 → 通道**中打开**钉钉**开关
> 2. 扫码绑定，或手填 Client ID 和 Client Secret
> 3. 若自行创建应用，将 Octop 提供的回调地址配置到钉钉应用的**消息接收模式**，开启相应事件权限并保存

> [tab] 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 条）
>
> 终端扫码绑定：
>
> ```bash theme={null}
> octop channel bind qq --agent main
> ```

> [tab] Telegram
>
> 通过 [@BotFather](https://t.me/BotFather) 创建 Bot，复制 **Bot Token**。
>
> 1. 在**个性化 → 通道**中打开 **Telegram** 开关
> 2. 填入 Bot Token 并保存
>
> Octop 通过 Telegram Bot API 接入，支持私聊与群组消息。
>
> > [!WARNING]
> >
> > 请妥善保管 Bot Token。一旦泄露，请立即在 BotFather 中重置并更新 Octop 中的配置。

> [tab] 其他
>
> Octop 还提供**微信**（通过 iLink Bot 接入个人微信）、**元宝**（腾讯元宝会话场景）、**小艺**（华为小艺 / OpenClaw，经 A2A 协议接入）和 **MQTT**（将 IoT 设备或机器人消息路由到 Agent）。
>
> 接入方式相同：在**个性化 → 通道**中打开开关，填写该平台所需的凭据即可。

## 选择回复展示方式

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

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

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

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

> [!TIP]
>
> 终端管理通道（`list`、`test`、`delete`、`feishu-setup`、`bind`）见[通道与定时任务](https://octop.mintlify.site/zh/cli/channel-cron-commands.md#octop-channel)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.