> For the complete documentation index, see [llms.txt](https://docs.cherry-ai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherry-ai.com/docs/zhong-wen-fan-ti/advanced-basic/agent-channels.md).

# 頻道

當你喺 Cherry Studio 入面配置好一個智能體（如「研報機械人」、「客服助手」），如果希望佢**駐留喺 IM 群入面**要服務多人，可以使用「頻道」功能。

**頻道**將 [智能體](/docs/zhong-wen-fan-ti/cherry-studio/preview/agent.md) **接入 IM 平台**作為機械人對外提供服務。

目前支援嘅平台：

* 飛書 / Lark（中國版 + 國際版）
* Telegram
* QQ（官方機械人 API）
* 微信（透過 iLink Bot API）
* Discord
* Slack

適用場景例子：

* **公司內部知識機械人**：飛書群成員 @ 機械人提問，佢會喺綁定嘅 [知識庫](/docs/zhong-wen-fan-ti/knowledge-base/knowledge-base.md) 檢索答案
* **個人助理**：Telegram 私聊機械人協助管理日程、查詢資訊、提供翻譯
* **客服值班**：Discord 機械人按設定話術接待用戶

> 建議先閱讀 [概念入門](/docs/zhong-wen-fan-ti/advanced-basic/concepts-101.md) 了解 Agent、頻道、定時任務嘅關係。

## 唔識自己配？叫 AI 幫你配

頻道功能涉及「建立第三方平台機械人 → 拎到憑據 → 填入 Cherry Studio」幾個步驟，對非技術用戶嚟講門檻偏高。**如果唔熟呢啲操作，最簡單嘅方式就係直接將任務交俾具備自主權限嘅 Agent（如內置嘅 Cherry Claw）**。

喺 Cherry Claw 嘅對話視窗入面描述你嘅目標就得，例如：

> 「請幫我設定一個頻道：每日朝早 10 點將虎嗅、36 氪、機器之心三家媒體嘅 AI 相關新聞匯總成 5 個要點，發到我嘅飛書。」

Cherry Claw 會自動判斷需要做咩事，向你索取必要嘅憑據（飛書 App ID 等），然後幫你完成頻道建立同 [定時任務](/docs/zhong-wen-fan-ti/advanced-basic/scheduled-tasks.md) 配置。

{% hint style="warning" %}
**核心前提說明**：

* 內置嘅 **Cherry Claw** 同埋你自建嘅智能體，預設狀態都係 **「自主模式關閉 + 普通模式」**。
* **喺使用頻道（或者定時任務）前，必須手動入去該智能體嘅編輯面板開啟「自主模式」**。
* 開啟「自主模式」後，底層嘅工具調用授權會全自動接管，原有嘅「權限模式」配置項會隨之隱藏，無需再手動設定。詳見 [智能體](/docs/zhong-wen-fan-ti/cherry-studio/preview/agent.md)。
  {% endhint %}

如果你想了解每一步嘅細節，或者需要自訂配置，可以繼續跟住下面嘅手動流程操作。

## 手動配置流程

### 前置要求

1. 已建立一個 [智能體](/docs/zhong-wen-fan-ti/cherry-studio/preview/agent.md)
2. 已啟用 [API 伺服器](/docs/zhong-wen-fan-ti/advanced-basic/api-server.md)
3. **取得目標 IM 平台嘅機械人憑據**（詳見下方「按平台準備憑據」，各平台命名唔同，本質都係平台官方頒發嘅 token / key，用嚟驗證機械人身份）

### 頻道喺邊

打開 `設定 → 頻道`，可以睇到所有支援平台嘅列表：

<figure><img src="/files/ca996c54c0ed55b38948e5c17dae72759e7db057" alt=""><figcaption><p>頻道選單：每個平台都有一行簡介，未綁定時右邊係空白狀態</p></figcaption></figure>

### 建立一個頻道（以飛書為例）

1. 喺左邊列表入面撳 **飛書**
2. 喺右邊空白狀態撳 **+ 新增**，彈出新增表單：

<figure><img src="/files/8dc59448d408aa4586aba267398c50bd5a2e34ba" alt=""><figcaption><p>飛書頻道欄位</p></figcaption></figure>

各欄位含義：

| 欄位               | 說明                                  |
| ---------------- | ----------------------------------- |
| **名稱**           | 頻道嘅顯示名，方便喺多頻道時辨認                    |
| **綁定 Agent**     | 揀一個已建立嘅 Cherry Agent。若唔綁定，則會用通用模型回覆 |
| **應用 ID / 應用密鑰** | 飛書開放平台 → 自建應用 → 憑證與基礎資訊             |
| **加密密鑰 / 驗證令牌**  | 飛書開放平台 → 事件訂閱，可選                    |
| **域名**           | `飛書（中國）` / `Lark（國際版）`，二揀一          |
| **允許嘅聊天 ID**     | 留空代表唔限制；填入就只喺指定群/單聊入面回應             |
| **頻道權限模式**       | `繼承智能體設定` / 自訂。建議保持繼承               |

填完之後撳 **儲存**。頻道啟用後會自動開始訂閱飛書訊息事件。

### 按平台準備憑據

{% tabs %}
{% tab title="飛書 / Lark" %}
**有兩種接入方式，推薦掃碼方式**：

* **掃碼註冊（推薦）**：喺飛書頻道詳情留空 **應用 ID / 應用密鑰**，啟用頻道後會自動彈出二維碼。用手機飛書掃描就可以自動建立機械人應用，**唔使去開放平台手動配置**。
* **手動接入（進階）**：
  * 喺 [開放平台](https://open.feishu.cn) 建立一個 **自建應用**
  * 複製 **App ID** 同 **App Secret** 填入表單
  * 喺飛書應用嘅 **事件訂閱** 入面啟用長連接（WebSocket）
  * 喺 **權限管理** 入面至少開啟：接收單聊訊息、接收群聊訊息、發送訊息
    {% endtab %}

{% tab title="Telegram" %}

* 同 [@BotFather](https://t.me/BotFather) 對話，`/newbot` 建立機械人
* 複製 **Bot Token**
* 喺表單入面填入 Bot Token 就得
* （可選）如果想限制只喺某啲對話回應，先將機械人拉入群或者私聊，再用 [@get\_id\_bot](https://t.me/get_id_bot) 取得 Chat ID 填入「允許嘅會話 ID」
  {% endtab %}

{% tab title="QQ" %}

* 喺 QQ 開放平台申請機械人 → 建立應用 → 複製 **App ID** 同 **Client Secret**
* 填入表單
* （可選）允許嘅會話 ID 格式：`c2c:openid`（私聊）、`group:groupid`（群）、`channel:channelid`（頻道）
  {% endtab %}

{% tab title="微信" %}

* **微信頻道嘅接入方式係掃碼登入**，唔需要任何預先註冊：
  * 喺頻道詳情入面撳 **新增微信帳號**
  * 啟用頻道後會彈出二維碼
  * 用手機微信掃描就可以登入
* （可選）允許嘅用戶 ID 格式：`wxid_xxxxx`，多個用逗號分隔
  {% endtab %}

{% tab title="Discord" %}

* 喺 [Discord Developer Portal](https://discord.com/developers/applications) 新建 Application
* 喺 Bot 子頁生成 **Bot Token** 同埋填入表單
* 邀請機械人去你嘅伺服器
* （可選）如果想限制頻道範圍：將機械人加入目標頻道後，向佢發送 `/whoami` 就可以攞到格式正確嘅頻道 ID
  {% endtab %}

{% tab title="Slack" %}

* 喺 [Slack API](https://api.slack.com/apps) 新建 App
* 啟用 **Socket Mode**，分別生成 **App-Level Token**（`xapp-...`）同 **Bot Token**（`xoxb-...`）
* 兩個 Token 都填入表單
* （可選）頻道範圍限制：向機械人發送 `/whoami` 取得 Slack 頻道 ID
  {% endtab %}
  {% endtabs %}

### 一個 Agent 可以接多個頻道咩？

可以。你可以令同一個「研報助手」Agent 同時接入飛書內部群（向同事匯報）同你嘅 Telegram 私聊（向自己推送），互不干擾。每個頻道獨立維護會話同權限。

### 同定時任務聯動

* 頻道可以 **接收** 用戶訊息觸發 Agent 回覆
* [定時任務](/docs/zhong-wen-fan-ti/advanced-basic/scheduled-tasks.md) 可以 **主動** 調用 Agent 並透過頻道將結果發送到 IM 平台
* 兩者組合可以實現完整嘅「日報機械人」形態

### 常見問題

#### 加咗之後機械人冇反應

* 確認 [API 伺服器](/docs/zhong-wen-fan-ti/advanced-basic/api-server.md) 處於 **運行中** 狀態
* 確認綁定嘅 Agent 模型 Provider 餘額充足
* 檢查「允許嘅聊天 ID」係咪填錯（留空代表唔限）

#### 飛書機械人加入群但收唔到 @ 訊息

* 喺飛書開放平台 → 權限管理，確認已開啟「獲取群組中嘅所有訊息」
* 喺群組入面右鍵機械人 → 設定，開啟「機械人可喺本群被 @」

#### 微信頻道斷線

* 微信機械人接入相對脆弱，建議優先用飛書 / Telegram
* 長時間冇用會被微信主動下線，重新登入 iLink 就得

{% hint style="warning" %}
唔同平台對自建機械人有唔同嘅合規要求。喺企業內部群啟用前請確認已取得所在組織 / 平台嘅許可。
{% endhint %}

***

### 💡 獲取幫助同提交反饋

如果您喺配置或使用過程中遇到任何疑問、Bug，或者有功能改進建議，請參考 [反饋與建議](/docs/zhong-wen-fan-ti/question-contact/suggestions.md) 入面提供嘅官方渠道。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cherry-ai.com/docs/zhong-wen-fan-ti/advanced-basic/agent-channels.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.