チャネル

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

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

まず接続するプラットフォームを選び、次に【追加】をクリックします。プラットフォームごとに用意するアカウントと認証情報は異なります。

手動設定の手順

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

1

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

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

2

まずテスト済みの Agent をバインドし、許可するチャット範囲を制限します。認証情報と権限は、タスク完了に必要な部分だけを公開してください。

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

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

3

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

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

4

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

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

推奨設定

設定項目	製品のデフォルト値	推奨の開始値	役割	適用場面	注意事項
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

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

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

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

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

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