> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 把专家接到飞书、钉钉或 QQ

配好通道之后，你在原来的聊天软件里发消息，专家在同一条会话里回复。每个通道只属于一位专家。

先打开：

```text
个性化 → 通道
```

在页面顶部选中专家，再打开对应平台。


![通道](/images/ui-channels.png "通道")

## 各平台怎么接

能扫码的平台，先走扫码。手动创建应用放在每节最后，留给公司要求自建应用的时候。


**飞书**

在通道抽屉里生成飞书 AI 机器人二维码，用飞书 App **扫一扫**，在手机上确认。Octop 会填入并保存凭据。然后给机器人发一条消息，确认能收到回复。话题里的回复走话题回复接口（`reply_in_thread`）。
终端里可以走同一套向导：
```bash
octop channel feishu-setup
```

**公司要求自建应用时**

在[飞书开放平台](https://open.feishu.cn)创建企业自建应用，拿到 **App ID** 和 **App Secret**。在**个性化 → 通道**里打开**飞书**，手填这两项。把 Octop 显示的回调地址填进飞书应用的**事件订阅**，并保存飞书侧配置。


**企业微信**

在通道抽屉里点**生成扫码二维码**，用企业微信手机端扫码。也可以在终端运行 `octop channel bind`，用手机扫码完成绑定。

**需要填写自建应用时**

在企业微信后台创建自建应用，拿到 **CorpID**、**AgentID** 和 **Secret**。打开**企业微信**，填入这三项，再把 Octop 显示的回调 URL 配到企业微信应用里。


**钉钉**

1. 打开**个性化 → 通道**，选择**钉钉**。
2. 留在**快捷配置（扫码）**，点**生成钉钉扫码二维码**。
3. 用同一组织账号登录的钉钉 App 扫描，并确认创建应用。
4. 授权成功后，Octop 会创建并启用这条通道。

**改为手动填写时**

切到**手动填写**，填入在[钉钉开放平台](https://open.dingtalk.com)创建的机器人的 **Client ID** 和 **Client Secret**。把 Octop 提供的回调地址配到钉钉应用的**消息接收模式**。


**QQ**

在通道抽屉里点**生成 QQ 扫码二维码**，用手机 QQ 扫码并确认。也可以：
```bash
octop channel bind qq --agent main
```
群聊可以再设可见范围（`auto` / `all` / `mention_recent` / `mention_only`）。可见范围为 `all` 时，回复时机可选 `mention` 或 `always`。
QQ 私聊默认走官方 `stream_messages`。保存通道时写入 `c2c_streaming: true`。只有显式设成 `c2c_streaming: false` 才会改回一条静态回复。旧键 `streaming` 和 `response_mode` 对私聊无效。群聊、频道和频道私信没有 stream API，仍然只发静态消息。工具过程提示会额外占用被动回复配额，每条入站大约 4 条。

**改为手填 App ID 时**

打开 **QQ**，填入开放平台上的 **App ID** 和 **Client Secret**，然后保存。


**Telegram**

在 [@BotFather](https://t.me/BotFather) 创建 Bot，复制 **Bot Token**。打开**个性化 → 通道 → 更多通道**。

![Telegram 通道](/images/ui-channel-telegram.png "Telegram")

1. 选择 **Telegram**。
2. 填入 **Bot Token**。
3. 可选：填写**允许的 Telegram 用户 ID**（逗号或换行分隔）。留空表示不限制。
4. 打开**启用频道**并保存。

> **注意**
> 
> 请保管好 Bot Token。泄露后先在 BotFather 里重置，再更新 Octop 里的配置。
> 



**Discord**

在 [Discord Developer Portal](https://discord.com/developers/applications) 创建机器人，复制 **Bot Token**，并把机器人邀请进服务器（需要消息相关权限）。

![Discord 通道](/images/ui-channel-discord.png "Discord")

1. 在**个性化 → 通道 → 更多通道**里选择 **Discord**。
2. 填入 Bot Token。不需要 Public Key 或 Client Secret。
3. 默认允许机器人能看到的全部频道。要收紧时，关闭「允许所有可访问频道」，并填写频道 ID。私聊请填写允许的用户 ID，留空表示不接受私聊。
4. 启用并保存。


**其他**

**微信**、**元宝**也可以在抽屉里扫码。**小艺**和 **MQTT** 打开对应开关，填写该平台要求的凭据。


## 群聊里怎么显示回复

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

- **仅最终回复**会在专家完成后一次发完。工具调用前的过程说明不会发到 IM，生成的媒体和最终文本一起送达。适合群聊。
- **实时过程**会分阶段更新。适合你要看着它执行的时候。

从页面新建外部 IM 通道时，默认是**实时过程**。**显示思考过程**和**显示工具调用提示**仍是单独的开关。QQ 私聊不看这个开关，改用 `c2c_streaming`。


> **注意**
> 
> 凭据等于机器人的控制权。只保存在这台 Octop 上，不要贴到聊天记录里。
> 



> **提示**
> 
> 终端里的 `list`、`test`、`delete`、`feishu-setup`、`bind` 见[通道与定时任务](/cli/channel-cron-commands.md#octop-channel)。
> 

