tutorial channels

ZeroClawマルチチャネル設定:1つのエージェントでTelegram + Discord + WhatsApp同時接続

ZeroClaws.io

ZeroClaws.io

@zeroclaws

April 1, 2026

7 分で読める

ZeroClawマルチチャネル設定:1つのエージェントでTelegram + Discord + WhatsApp同時接続

3月31日、TelegramがBot API史上最大のプラットフォームアップデートをリリースした。Bot APIがボットの自律的な作成・管理を可能にし、AIパワードのテキストエディタがすべてのTelegramクライアントに搭載された。AIエージェント開発者にとって、Telegramはさらに魅力的なデプロイ先になった。

しかし、ほとんどのAIエージェントは単一のプラットフォームだけで動いているわけではない。チームはDiscordを使い、家族はWhatsAppを使い、個人プロジェクトはTelegramで動いている。ZeroClawのマルチチャネルアーキテクチャの力は、一つのエージェントをこれらすべてで同時に動かすことだ——同じパーソナリティ、同じメモリ、同じツール、異なるインターフェース。

3つすべてのセットアップ方法を説明する。

アーキテクチャ概要

ZeroClawのチャネルシステムは、各メッセージングプラットフォームを個別のチャネル実装として扱う。チャネルはRust trait——各プラットフォームが同じインターフェースを実装し、その下にプラットフォーム固有のロジックが置かれる。エージェントはメッセージがどのプラットフォームから来たかを知らないし、気にもしない。メッセージを処理し、レスポンスを生成し、元のチャネルを通じて送り返す。

メモリはチャネル間で共有される。Telegramで行った会話は、Discordでチャットするときにコンテキストとして利用可能だ。エージェントは一つのエージェント——チャネルはそこへの異なる窓に過ぎない。

チャネル1:Telegram

Telegramはセットアップが最も簡単で、AIエージェント用途に最も適したチャネルだ。

ボットを作成する:

  1. 1.Telegramを開き、@BotFatherにメッセージを送る
  2. 2.`/newbot` を送信
  3. 3.名前とユーザー名を選ぶ
  4. 4.APIトークンをコピーする

ZeroClawの設定:

`~/.zeroclaw/config.toml` に追加:

```bash [[channels]] type = "telegram" token = "YOUR_BOT_TOKEN_HERE" allowed_users = [123456789] # あなたのTelegramユーザーID ```

ユーザーIDはTelegramで@userinfobot にメッセージを送ると確認できる。

Telegramの機能:

  • ボットレスポンスでのMarkdownフォーマット
  • インタラクティブなプロンプトのためのインラインキーボード
  • ファイルと画像の送受信
  • グループチャットサポート(ボットがグループの会話に参加可能)
  • ボイスメッセージ(ZeroClawはWhisper統合でこれを処理可能)
  • 新しいBot API(2026年3月)はボット管理ボットをサポート——ZeroClawエージェントが理論的に特定タスク用の専門サブボットを作成可能

Telegramの利点: APIの摩擦がゼロ。ボットを作成し、トークンを取得し、チャット開始。ビジネス認証なし、承認プロセスなし、使用料なし。これがTelegramがAIボットデプロイの開発者デフォルトプラットフォームである理由だ。

チャネル2:Discord

Discordの統合はTelegramとほぼ同じくらい簡単で、チーム/コミュニティのユースケースにより適している。

ボットを作成する:

  1. 1.discord.com/developers/applications にアクセス
  2. 2.「New Application」をクリックし、名前を付ける
  3. 3.「Bot」セクションに移動し、「Add Bot」をクリック
  4. 4.トークンをコピー
  5. 5.「Privileged Gateway Intents」でMessage Content Intentを有効化
  6. 6.招待URLを生成:OAuth2 → URL Generator → 「bot」スコープを選択、「Send Messages」+「Read Message History」権限を選択
  7. 7.招待URLを開き、ボットをサーバーに追加

ZeroClawの設定:

```bash [[channels]] type = "discord" token = "YOUR_DISCORD_BOT_TOKEN" allowed_guilds = ["your_server_id"] command_prefix = "!" # オプション:! で始まるメッセージにのみ応答 ```

Discordの機能:

  • フォーマットされたレスポンスのリッチエンベッド
  • スレッドサポート(ボットが長い会話用にスレッドを作成可能)
  • 構造化されたインタラクションのスラッシュコマンド
  • チャネル固有の権限(ボットを特定のチャネルに制限可能)
  • ボイスチャネル統合(ZeroClawでは実験的)

Discordの利点: コミュニティ向けに設計されている。エージェントがチームやDiscordサーバーにサービスを提供するなら、Discordの権限モデルとチャネル構成がエージェントのアクセスと可視性をスコープするのに自然だ。

チャネル3:WhatsApp

WhatsAppはグローバルで最も人気のあるメッセージングプラットフォームだが、AIエージェントとの統合が最も難しい。

公式の方法: WhatsApp Business APIはビジネス認証、Facebook Business Managerアカウント、Metaからの承認が必要。プロセスには数日から数週間かかる。商用デプロイにはこれが正しいパスだ。

コミュニティの方法: BaileysライブラリはWhatsApp Webセッションをシミュレートする非公式WhatsApp Web APIを提供する。ZeroClawはこの統合をサポートしている。

Baileysでのセットアップ:

```bash [[channels]] type = "whatsapp" method = "baileys" data_dir = "~/.zeroclaw/whatsapp" allowed_numbers = ["+1234567890"] ```

初回起動時、ZeroClawはターミナルにQRコードを表示する。スマホのWhatsAppでスキャンする(設定 → リンク済みデバイス → デバイスをリンク)。これでWhatsAppアカウントがZeroClawにリンクされる。

Baileysの注意点:

  • Metaが公式サポートしていない——プロトコルがいつブロックされてもおかしくない
  • WhatsAppがインストールされたアクティブなスマホが必要
  • セッションが定期的に期限切れする(その際はQRコードを再スキャン)
  • Telegram/Discordよりレート制限が厳しい
  • 商用や大量利用には不適

WhatsAppの利点: リーチ。テクニカルでない家族、クライアント、知り合いはWhatsAppにいる。TelegramやDiscordを使わない人にAIアシスタントをアクセスさせたいなら、WhatsAppが正解だ。

3チャネル同時実行

完全なマルチチャネル設定:

```bash [provider] type = "openai-compatible" base_url = "http://localhost:11434/v1" model = "llama3.1:8b"

[agent] name = "Assistant" personality = "Helpful and concise. Adapt response length to the platform — shorter on WhatsApp, can be longer on Discord."

[memory] type = "sqlite" path = "~/.zeroclaw/memory.db"

[[channels]] type = "telegram" token = "TELEGRAM_TOKEN" allowed_users = [123456789]

[[channels]] type = "discord" token = "DISCORD_TOKEN" allowed_guilds = ["guild_id"]

[[channels]] type = "whatsapp" method = "baileys" data_dir = "~/.zeroclaw/whatsapp" allowed_numbers = ["+1234567890"] ```

ZeroClawを1回起動するだけ。3つのチャネルが同時に接続する。どのチャネルからのメッセージも、同じメモリとツールを持つ同じエージェントが処理する。

クロスチャネルメモリ

マルチチャネルセットアップの最も強力な側面は、共有メモリだ。Telegramでエージェントにプロジェクトについて尋ね、そのままDiscordで会話を続けられる。メモリはチャネルごとではなく中央に保存されるため、コンテキストが引き継がれる。

ZeroClawは各メモリエントリにソースチャネルをタグ付けするため、「昨日Telegramで何を議論した?」と尋ねれば、エージェントは適切にフィルタリングできる。ただしデフォルトでは、現在使っているチャネルに関係なく、すべてのコンテキストが利用可能だ。

プラットフォーム選択ガイド

| ユースケース | 最適なプラットフォーム | 理由 | |-------------|----------------------|------| | パーソナルアシスタント | Telegram | セットアップが最速、最良のBot API | | チーム/コミュニティボット | Discord | チャネル構成、権限管理 | | ファミリーアシスタント | WhatsApp | 全員が既に使っている | | 開発/テスト | CLI | 外部依存なし | | 上記すべて | マルチチャネル | 1つのエージェント、どこにでも |

1つのチャネルから始めて、必要に応じて追加する。ZeroClawのチャネルシステムは加算式だ——新しいチャネルは設定ブロックの追加であり、アーキテクチャの変更ではない。

ZeroClaw で AI Agent の構築を始めよう

新リリース、連携、Rust製エージェントインフラの最新情報をお届け。スパムなし、いつでも解除可能。