チュートリアル 02 — Telegram接続：AIアシスタントをチャットアプリに組み込む

目標：Telegram Botを設定し、スマートフォンからいつでもAIと会話できるようにします。プライベートチャットとグループの両方をサポートします。

仕組み

OpenClawゲートウェイが起動すると、複数の「チャンネル」をリッスンします。TelegramチャンネルはBot APIのロングポーリングでメッセージを受信し、AIエージェントにルーティングして処理し、返信をTelegramに送り返します。

あなたのスマートフォン → Telegramサーバー → Bot → OpenClawゲートウェイ → MiniMax → 返信

ステップ1：Telegram Botの作成

Telegramを開き、@BotFather を検索します
/newbot を送信し、指示に従って名前とユーザー名を入力します
Tokenを取得します。形式は以下のようになります：
```
8543054163:AAHc-yE-nfRlbGw1clvW1OwjdMZ6O_j9tWs
```

ステップ2：Tokenを設定に追加

.env（プロジェクトルートまたは ~/.openclaw/.env）を編集します：

TELEGRAM_BOT_TOKEN=あなたのtoken

または ~/.openclaw/openclaw.json の env ブロックに直接記述します：

{
  "env": {
    "MINIMAX_API_KEY": "${MINIMAX_API_KEY}",
    "TELEGRAM_BOT_TOKEN": "あなたのtoken"
  }
}

ステップ3：Telegramチャンネルの有効化

openclaw.json にchannels設定を追加します：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "${TELEGRAM_BOT_TOKEN}"
    }
  }
}

ステップ4：ゲートウェイの再起動

pnpm openclaw gateway restart

ログを確認してTelegramチャンネルが接続されているか確認します：

tail -f /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log | grep -i telegram
# Telegram channel connected のような表示が見えるはずです

ステップ5：会話のテスト

Telegramを開き、あなたのBotを見つけます
/start を送信してペアリングを開始します
メッセージを送ってみます：

"今日の天気はどうですか？分析してください"

Botは数秒以内に返信するはずです。

グループでの使用

Botをグループに追加して管理者権限を付与します
グループ内では @メンション でBotが反応します（デフォルトの動作、悪用防止）：
```
@あなたのbot名前 上の議論をまとめてください
```

よく使うスラッシュコマンド

Telegramで直接送信します：

コマンド	機能
`/new`	新しいセッションを開始（コンテキストをクリア）
`/reset`	現在のセッションをリセット
`/status`	現在のモデルと設定を確認
`/think`	深い思考モードの切り替え
`/usage`	tokenの使用量を確認

よくある質問

Botが応答しない場合は？

順番に確認してください：① pnpm openclaw gateway status を実行してゲートウェイが稼働しているか確認；② ログ tail -f /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log | grep -i telegram でチャンネルが接続されているか確認；③ プライベートチャットでBotを使用する際は先に /start でペアリングを完了する必要があります。ペアリング前のメッセージは無視されます。

グループでBotが不適切に返信する場合は？

OpenClawはデフォルトで@メンションされたメッセージにのみ反応します。Botがグループ内で不適切なメッセージに返答した場合は、openclaw.json の channels.telegram.replyToMode の設定を確認し、"mention" に設定してください。

Telegram Botは複数のユーザーを同時にサポートできますか？

できます。OpenClawのTelegramチャンネルはデフォルトでマルチユーザー同時接続をサポートし、各ユーザーは独立したセッションコンテキストを持ちます。全ユーザーが同一のAPI Keyクォータを共有するため、使用量に注意してください。

BotはImageとファイルの送受信をサポートしていますか？

画像の送受信サポートにはビジョンモデル（MiniMax VL-01など）の設定が必要です。チュートリアル 07をご覧ください。ファイル送信機能はOpenClawのバージョンによって異なります。/status で現在サポートされている機能を確認できます。

複数のデバイスで同じBotを使用するには？

Bot Tokenは openclaw.json で一度設定すれば、同じTelegramアカウントにログインしているすべてのデバイスから同じBotとやり取りできます。Botのセッションはchat_idで分離されているため、互いに干渉することはありません。

次のステップ

チュートリアル 03 — 独自のSkillを作成してAIに新しい能力を追加する
チュートリアル 04 — AIにWebページの自動操作を手伝ってもらう