> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/jp/advanced-basic/automation/channels.md).

# チャンネル

チャネルは1つの Agent を外部メッセージプラットフォームに接続します。現在は飛書、Telegram、QQ、微信、Discord、Slack を設定可能です。各プラットフォームで必要なボット認証情報と会話識別子は異なります。

{% hint style="success" %}
まず【作業】で Agent にこう伝えるのがおすすめです。「現在の Agent に飛書チャネルを設定し、グループメッセージの受信とタスク結果の送信に使います。」Agent は用途に応じて必要情報を尋ねるので、すべてのプラットフォーム項目を直接見比べるより速いです。正確に変更したい場合は、【設定】→【チャネル】を使ってください。
{% endhint %}

<figure><img src="/files/0f458c7714cf07b444cb2af24c8ac34ae3d14e58" alt="频道设置中的飞书、Telegram、QQ、微信、Discord 和 Slack 平台入口"><figcaption><p>まず接続するプラットフォームを選び、次に【追加】をクリックします。プラットフォームごとに用意するアカウントと認証情報は異なります。</p></figcaption></figure>

## 手動設定の手順

【設定】→【チャネル】→プラットフォームを選択→【追加】。

{% stepper %}
{% step %}

### 1. プラットフォームのアカウントを準備する

プラットフォームのルールに従ってボットまたはアプリを作成します。飛書と微信で QR コード関連の手順が利用できる場合は、チャネルを有効化した後に画面の案内に従って完了できます。その他のプラットフォームでは、対応する Token またはアプリ認証情報を入力します。
{% endstep %}

{% step %}

<figure><img src="/files/f398266325f7fb969db149b161ecf0c4114c347a" alt="飞书频道配置中的 Agent、应用凭据、允许聊天范围和权限模式"><figcaption><p>まずテスト済みの Agent をバインドし、許可するチャット範囲を制限します。認証情報と権限は、タスク完了に必要な部分だけを公開してください。</p></figcaption></figure>

### 2. Agent とワークスペースをバインドする

すでに利用可能であることを確認した Agent を選び、チャネルメッセージ用のワークスペースを指定します。外部メッセージはこのコンテキストで実行されるため、無関係な機密ファイルを含むディレクトリは選ばないでください。
{% endstep %}

{% step %}

### 3. メッセージソースを制限する

許可する Chat ID、チャネル ID、またはユーザー ID を入力します。空欄にするとすべて許可を意味する場合があります。詳細は現在のプラットフォームの項目説明に従ってください。まずボットに次を送信してもかまいません `/whoami` 正しい形式の識別子を取得します。
{% endstep %}

{% step %}

### 4. 権限モードを選択して有効化する

既定では【エージェント設定を継承】を使用します。公開グループ、複数人グループ、または信頼できないソースでは、より厳格なモードを使用してください。有効化後は、まず副作用のないテストメッセージを送信します。
{% endstep %}
{% endstepper %}

## 推奨設定

| 設定項目          | 製品のデフォルト値          | 推奨の開始値                        | 役割                    | 適用場面                 | 注意事項                 |
| ------------- | ------------------ | ----------------------------- | --------------------- | -------------------- | -------------------- |
| Agent をバインドする | 選択が必要              | チャネル専用の Agent を用意する           | メッセージを誰が処理するかを決める     | グループチャット、ボットとの個別チャット | 高権限の開発用 Agent と混用しない |
| ワークスペース       | 選択が必要              | 個人情報を含まない専用ディレクトリを使用する        | 処理できるファイルを制限する        | グループ内での収集、日報の配信      | ユーザーのホームディレクトリを選ばない  |
| 許可するメッセージソース  | プラットフォームの項目によって異なる | まずはテスト用アカウントまたはテストグループのみを許可する | 誰が Agent を起動できるかを制限する | 内部テスト、チームグループ        | 空欄にする前に項目説明を読む       |
| 権限モード         | 【エージェント設定を継承】      | 外部入口ではより厳しい承認を使う              | ツール操作を制御する            | 公開グループ、複数人グループ       | 【完全アクセス】の使用は推奨しない    |

## 使用シーン：チームの当番グループ

当番マニュアルだけを処理する Agent を作成し、想起テスト済みのナレッジベースと専用ワークスペースをバインドして、当番グループからのみ起動できるようにします。まず「規定を1件調べる」と「答えが見つからない」の2種類のメッセージをテストし、その後、機密情報を含まない引き継ぎ要約の生成をテストします。

### 完了基準

許可されていないソースからはタスクを起動できません。回答は指定グループに返せます。ナレッジベースに内容がない場合は明確にその旨を説明します。ファイルの書き込みでは引き続き承認を求めます。

## プラットフォーム設定の要点

| プラットフォーム  | 主な認証情報                         | 会話範囲の要点                  |
| --------- | ------------------------------ | ------------------------ |
| 飛書 / Lark | App ID、App Secret、または QR コード手順 | チャット ID と国内/国際ドメイン       |
| Telegram  | Bot Token                      | Chat ID                  |
| QQ        | App ID、Client Secret           | 個別チャット、グループ、またはチャネルの識別形式 |
| 微信        | QRコードログインまたは認証情報のパス            | 許可するユーザー ID              |
| Discord   | Bot Token                      | チャネルまたは個別チャットの ID        |
| Slack     | Bot Token、App Token            | Socket Mode とチャネル ID     |

{% hint style="danger" %}
ボット Token、App Secret、検証トークンはアカウントのパスワードと同等です。Agent の長期記憶、タスクプロンプト、スクリーンショット、公開 Issue に書き込まないでください。漏えいした場合は、直ちにプラットフォーム側で無効化し再生成してください。
{% endhint %}

<details>

<summary>定期タスクでチャネルの受信先が選べない場合はどうする？</summary>

まず該当プラットフォームでボットにメッセージを1件送信し、Cherry Studio に利用可能な Chat ID を記録させてから、定期タスクに戻って通知先を選択してください。

</details>

<details>

<summary>チャネルは接続済みなのに応答しない場合は？</summary>

許可された会話 ID、バインドされた Agent、ワークスペース、権限モードを確認し、チャネルログも確認してください。プラットフォーム側でメッセージは受信しているのに Agent が実行されない場合は、API ゲートウェイと Agent のタスク状態を続けて確認します。

</details>


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.cherryai.com.cn/docs/jp/advanced-basic/automation/channels.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.