OpenClawをまだインストールしていませんか?ここをクリックしてワンライナーインストールコマンドを表示
curl -fsSL https://openclaw.ai/install.sh | bash
iwr -useb https://openclaw.ai/install.ps1 | iex
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
PCへの影響が心配ですか? ClawTank ならクラウド上で動作し、インストール不要で誤削除のリスクもありません
主要な知見
  • 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が多くのユーザーにとって第一選択なのか?

2. ステップバイステップのセットアップチュートリアル

ステップ1:Telegram Botの作成

Telegramで@BotFather(Telegram公式のBot管理ツール)を検索し、以下のメッセージを送信する:[3]

/newbot

BotFatherが順番に尋ねてくる:

  1. Bot名(表示名):例「My AI Agent」
  2. 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]

  1. Telegramで自分のBotに任意のメッセージを送信する
  2. Botが「Pairing Required」と表示し、ペアリングコードが表示される
  3. ターミナルで以下を実行する:
# 保留中のペアリングリクエストを表示
openclaw pairing list

# ペアリングを承認
openclaw pairing approve

ペアリングが完了すると、TelegramでAIエージェントと通常通りチャットできるようになる。

3. DMポリシーとグループ管理

3.1 DMポリシー

OpenClawは、ダイレクトメッセージでエージェントとやり取りできるユーザーを決定するきめ細かなアクセス制御を提供する:[1]

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]

  1. 常にowner_onlyまたはallowlistを使用する:明確な理由がない限り、DMポリシーをanyoneに設定しないこと
  2. ペアリング済みデバイスを定期的に確認するopenclaw pairing listでペアリング済みデバイスを確認し、使用していないものを削除する
  3. パブリックグループでは使用しない:プライベートグループまたはダイレクトメッセージでのみエージェントとやり取りすること
  4. Bot Tokenをローテーションする:Tokenが漏洩した疑いがある場合、BotFatherで即座に再生成(/revoke)し、OpenClawの設定を更新する
  5. エージェントのSkill権限を制限する:エージェントがデータ照会のみを行う場合、ファイル変更権限を持つSkillはインストールしないこと

まとめ

TelegramとOpenClawの連携により、AIエージェントは真の「リモートアシスタント」となる。コンピュータを開く必要はなく、Telegramのメッセージ一つでAIにタスクを完了させることができる。[6]セットアップ全体はわずか3ステップ、10分もかからない。

まだOpenClawをインストールしていない方には、まずアーキテクチャ解析&実践デプロイガイドを読んで基本的なセットアップを完了することをお勧めする。WhatsAppやDiscordなど他のチャネル設定については、メッセージ連携ガイドを参照されたい。