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.Telegramを開き、@BotFatherにメッセージを送る
- 2.`/newbot` を送信
- 3.名前とユーザー名を選ぶ
- 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.discord.com/developers/applications にアクセス
- 2.「New Application」をクリックし、名前を付ける
- 3.「Bot」セクションに移動し、「Add Bot」をクリック
- 4.トークンをコピー
- 5.「Privileged Gateway Intents」でMessage Content Intentを有効化
- 6.招待URLを生成:OAuth2 → URL Generator → 「bot」スコープを選択、「Send Messages」+「Read Message History」権限を選択
- 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のチャネルシステムは加算式だ——新しいチャネルは設定ブロックの追加であり、アーキテクチャの変更ではない。