OpenClawでTelegramボットを接続する方法

Telegramは世界で最も人気のあるメッセージアプリの一つで、強力なBot APIエコシステムを備えています。OpenClawが提供するオープンソースのセルフホスト型AIアシスタントを使えば、自分専用のTelegram AIボットを簡単に作成し、Claude、GPTなどの大規模言語モデルといつでもどこでも会話できます。このチュートリアルでは、OpenClawとTelegramの接続をゼロから行う完全な手順をご説明します。

前提条件

作業を始める前に、以下の準備が整っていることを確認してください。

Node.js 22 以上がインストール済み
OpenClaw のインストールと初期設定が完了済み（openclaw onboard）
Telegram アカウントを所有していること
OpenClaw の Gateway が正常に稼働中（デフォルトポート 18789）

OpenClaw がまだインストールされていない場合は、以下のコマンドですぐにインストールできます。

npm install -g openclaw@latest
openclaw onboard

インストール時に、AI モデルプロバイダーの選択と API キーの設定を含む基本的な初期設定が案内されます。

ステップ1：BotFatherでTelegramボットを作成する

Telegram のすべてのボットは、公式の @BotFather を通じて作成・管理します。Telegram で @BotFather を検索して会話を開始し、以下の手順で操作してください。

/newbot コマンドを送信する
BotFather がボットの表示名を尋ねてくるので入力する（例：My AI Assistant）
次にユーザー名の設定を求められるので、bot で終わる名前を入力する（例：my_ai_assistant_bot）
作成が完了すると、BotFather が Bot Token を返してくる（7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx のような形式）

重要： この Token は大切に保管し、決して他人に漏らさないでください。Token を持っていれば、ボットを完全にコントロールできてしまいます。

BotFather では、さらにボットのカスタマイズも可能です。

/setdescription - ボットの説明を設定
/setabouttext - 「について」の情報を設定
/setuserpic - アイコンを設定

ステップ2：OpenClawでTelegramチャンネルを設定する

Bot Token を取得したら、OpenClaw の設定ファイルに追加します。設定ファイルを開いてください。

nano ~/.config/openclaw/openclaw.json5

設定ファイルの channels セクションに Telegram チャンネルの設定を追加します。

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      // オプション：ボットの使用を許可するユーザーIDリスト
      allowedUsers: [],
      // オプション：グループでのボットのトリガー方式
      groupBehavior: "mention", // "mention" @メンションが必要, "always" 常に応答
    }
  }
}

ファイルを保存したら、OpenClaw の Gateway を再起動して設定を反映させます。

openclaw gateway restart

ステップ3：接続状態を確認する

設定後、内蔵の診断ツールで接続が正常かどうかを確認します。

openclaw doctor

このコマンドは設定済みのすべてのチャンネルの接続状態をチェックします。Telegram チャンネルが緑色または「connected」と表示されれば、設定は成功です。Dashboard からさらに詳しい状態情報も確認できます。

openclaw dashboard

ここで Telegram を開き、先ほど作成したボットを見つけてメッセージを送ってみましょう。すべてが正常であれば、ボットから返信があるはずです。

ステップ4：ボットをグループに追加する

OpenClaw の Telegram ボットは、個人チャットだけでなく、グループに追加して複数人で利用することもできます。手順は以下のとおりです。

対象の Telegram グループの設定を開く
「メンバーを追加」をタップし、ボットのユーザー名を検索する
ボットをグループに追加する

デフォルトでは、ボットはグループ内で mention モードで動作します。つまり、メッセージ内で @メンションされた場合のみ応答します。これにより、すべてのメッセージに返信して通常のチャットを妨げることがなくなります。

ボットがグループ内のすべてのメッセージに応答するようにしたい場合は、groupBehavior を "always" に変更しますが、これは通常、AI 専用のディスカッショングループでのみ使うべきです。

ステップ5：プライバシーモードを設定する

Telegram ボットにはデフォルトでプライバシーモード（Privacy Mode）が有効になっており、グループ内では以下の種類のメッセージしか受け取れません。

/ で始まるコマンド
ボットを直接 @メンションしたメッセージ
ボットのメッセージへの返信

コンテキストを理解するためにグループ内のすべてのメッセージをボットに読ませる必要がある場合は、BotFather でプライバシーモードを無効にします。

@BotFather に /mybots を送信する
対象のボットを選択する
Bot Settings → Group Privacy に進む
Turn off を選択する

注意：プライバシーモードを無効にした後、ボットをグループから一度削除して再追加しないと変更が反映されません。

セキュリティに関する推奨事項

Telegram ボットをデプロイする際は、セキュリティ面に十分注意してください。

ユーザーアクセスの制限： allowedUsers に使用を許可する Telegram ユーザー ID を設定し、知らない人に AI の利用枠を消費されないようにする
Gateway ポートの保護： 18789 ポートを直接インターネットに公開してはいけません。必ず Nginx などのリバースプロキシを使用してください
Token の定期的な更新： Token が漏洩した疑いがある場合は、BotFather の /revoke コマンドで直ちに再生成してください

自分の Telegram ユーザー ID は、@userinfobot に任意のメッセージを送ると確認できます。

まとめ

このチュートリアルで、OpenClaw と Telegram の接続が完了し、プライベートな AI チャットボットが手に入りました。個人チャットでの素早い質問にも、ワークグループに追加してのチーム協業にも活用できます。より高度な設定や使い方のコツについては、OpenClaw公式ドキュメントを参照してください。設定中に問題が発生した場合は、OpenClaw GitHub リポジトリで Issue を確認するかフィードバックを送ることができます。