OpenClawをまだインストールしていませんか?ここをクリックしてワンライナーインストールコマンドを表示
curl -fsSL https://openclaw.ai/install.sh | bashiwr -useb https://openclaw.ai/install.ps1 | iexcurl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd- TelegramはOpenClawで最も人気のあるメッセージングチャネルの一つであり、スマートフォンからいつでもどこでもAIエージェントにコマンドを送り、レポートを受け取り、コンピュータを操作できる[1]
- 連携プロセスは3つのステップで構成される:(1) BotFatherでTelegram Botを作成、(2) Bot TokenをOpenClawの設定に書き込む、(3) ペアリング認証を完了する[2]
- ペアリング機構はOpenClawのセキュリティの要である。ペアリング認証を完了したTelegramアカウントのみがエージェントを制御でき、他者がBotを通じてコンピュータにアクセスすることを防止する[5]
- DMポリシーとグループ設定により、エージェントとやり取りできるユーザーとその操作コンテキストを精密に制御でき、不正アクセスを防止する[1]
1. なぜTelegramを選ぶのか?
OpenClawはWhatsApp、Discord、LINE、Slackなど複数のメッセージングチャネルをサポートしている。では、なぜTelegramが多くのユーザーにとって第一選択なのか?
- 完全オープンなBot API:TelegramのBot APIは無料で、制限がなく、ドキュメントも充実している。ビジネスアカウントや承認プロセスは不要[3]
- コードフォーマット対応:TelegramはMarkdownとコードブロックをネイティブサポートしており、エージェントの応答が適切にフォーマットされる
- 無圧縮ファイル転送:ファイルを圧縮や変換なしで直接エージェントに送信して処理させることができる
- クロスプラットフォーム同期:モバイル、デスクトップ、Web版がリアルタイムで同期し、いつでもデバイスを切り替え可能
- グループ機能:グループを作成してチームメンバーで同じAIエージェントを共有できる
2. ステップバイステップのセットアップチュートリアル
ステップ1:Telegram Botの作成
Telegramで@BotFather(Telegram公式のBot管理ツール)を検索し、以下のメッセージを送信する:[3]
/newbot
BotFatherが順番に尋ねてくる:
- Bot名(表示名):例「My AI Agent」
- Botユーザー名(一意の識別子、
botで終わる必要がある):例「my_openclaw_agent_bot」
完了するとBotFatherがBot Tokenを返信する。フォーマットは以下の通り:
7123456789:AAHx1234567890abcdefghijklmnopqrstuv
このTokenを安全に保管すること。Tokenを入手した者は誰でもBotを制御できる。
ステップ2:Bot TokenをOpenClawに書き込む
ターミナルに戻り、以下のコマンドでTokenをOpenClawの設定に保存する:[1]
openclaw config set channels.telegram.botToken "YOUR_BOT_TOKEN"
次にGatewayを再起動して設定を反映させる:
openclaw gateway restart
ステップ3:ペアリング認証
この時点でBotはTelegram上でオンラインになっているが、エージェントをまだ制御できない。ペアリング(OpenClawのセキュリティ機構で、自分だけがエージェントを制御できるようにする仕組み)を完了する必要がある。[2]
- Telegramで自分のBotに任意のメッセージを送信する
- Botが「Pairing Required」と表示し、ペアリングコードが表示される
- ターミナルで以下を実行する:
# 保留中のペアリングリクエストを表示
openclaw pairing list
# ペアリングを承認
openclaw pairing approve
ペアリングが完了すると、TelegramでAIエージェントと通常通りチャットできるようになる。
3. DMポリシーとグループ管理
3.1 DMポリシー
OpenClawは、ダイレクトメッセージでエージェントとやり取りできるユーザーを決定するきめ細かなアクセス制御を提供する:[1]
- owner_only(デフォルト):ペアリング済みのオーナーのみが使用可能
- allowlist:許可リストに登録されたTelegramユーザーのみが使用可能
- anyone:誰でも使用可能(テスト専用、本番環境では絶対に使用しないこと)
openclaw config set channels.telegram.dmPolicy "owner_only"
3.2 グループ設定
BotをTelegramグループに追加して、チームメンバーでAIエージェントを共有できる。グループ内のアクセス制御はgroupPolicyで管理する:
openclaw config set channels.telegram.groupPolicy "allowlist"
セキュリティに関する注意:グループモードでは、エージェントのすべてのアクションがコンピュータ全体に影響を与える可能性がある。グループメンバー全員が信頼できる人物であることを確認すること。[5]
4. よくあるユースケース
4.1 リモート開発
外出中にサーバー上のコードを修正する必要がある場合、Telegramからエージェントにコマンドを送信できる:
"config.jsのAPI_URLをstagingからproductionに変更してからデプロイスクリプトを実行して"
エージェントがサーバー上で変更を行い、デプロイを実行し、結果をTelegramに報告する。
4.2 定期レポート
OpenClawのCron機能と組み合わせて、毎朝システムステータスレポートをTelegramに送信するよう設定できる:
"毎日午前9時にサーバーのCPU、メモリ、ディスク使用量を確認して、サマリーをTelegramに送信して"
4.3 ファイル処理
Telegramでファイルを直接エージェントに送信して処理させることができる。例えば、CSVファイルを送り、データ分析とグラフ生成を依頼するなど。[6]
5. トラブルシューティング
| 問題 | 原因 | 解決策 |
|---|---|---|
| Botがまったく応答しない | Gatewayが動作していないかBot Tokenが正しくない | Gatewayが動作中か確認(openclaw gateway status)、Tokenが正しいか検証する |
| 「Pairing Required」が繰り返し表示される | ペアリングが完了していないか期限切れ | openclaw pairing approveを再実行する |
| Botがグループで応答しない | Botがグループ管理者に設定されていないかgroupPolicyがアクセスを制限している | Botをグループ管理者に設定し、groupPolicy設定を確認する |
| メッセージの遅延が30秒を超える | LLMの応答が遅いかネットワーク遅延 | より高速なモデル(Haiku)に切り替え、Gatewayサーバーのネットワークを確認する |
| 日本語の返信が文字化けする | モデルに日本語の優先設定がされていない | エージェントのSystem Promptに言語設定を追加する |
6. セキュリティのベストプラクティス
TelegramでAIエージェントを操作することは、本質的にコンピュータの制御権限をネットワーク上に拡張することを意味する。以下のセキュリティ原則を遵守すること:[5][8]
- 常にowner_onlyまたはallowlistを使用する:明確な理由がない限り、DMポリシーをanyoneに設定しないこと
- ペアリング済みデバイスを定期的に確認する:
openclaw pairing listでペアリング済みデバイスを確認し、使用していないものを削除する - パブリックグループでは使用しない:プライベートグループまたはダイレクトメッセージでのみエージェントとやり取りすること
- Bot Tokenをローテーションする:Tokenが漏洩した疑いがある場合、BotFatherで即座に再生成(
/revoke)し、OpenClawの設定を更新する - エージェントのSkill権限を制限する:エージェントがデータ照会のみを行う場合、ファイル変更権限を持つSkillはインストールしないこと
まとめ
TelegramとOpenClawの連携により、AIエージェントは真の「リモートアシスタント」となる。コンピュータを開く必要はなく、Telegramのメッセージ一つでAIにタスクを完了させることができる。[6]セットアップ全体はわずか3ステップ、10分もかからない。
まだOpenClawをインストールしていない方には、まずアーキテクチャ解析&実践デプロイガイドを読んで基本的なセットアップを完了することをお勧めする。WhatsAppやDiscordなど他のチャネル設定については、メッセージ連携ガイドを参照されたい。



