最初のチャンネルを設定する

OpenClaw は複数のメッセージング基盤に対応しています。このチュートリアルでは Telegram を使います。理由は：

• セットアップが最も簡単（ボットを作るだけ）
• 電話番号が不要
• テストや学習に最適
• どのプラットフォームでも使える

他のチャンネルについては、WhatsApp/Discord/Slack/Signal/iMessage などを含む「Channels」リファレンスを参照してください。

Telegram はボット（プログラムで操作できる特別なアカウント）を使います。作り方は次の通りです：

手順 2.1：Telegram を開いて BotFather を探す

• スマホまたは PC で Telegram アプリを開く
• @BotFather（公式のボット作成用アカウント）を検索
• BotFather とチャットを開始
• /start を送信

手順 2.2：ボットを作成する

• BotFather に /newbot を送信
• ボット名（表示名。例："My OpenClaw Assistant"）を聞かれるので入力
• ユーザー名（末尾が 'bot' 必須。例："myopenclawbot"）を聞かれるので入力
• BotFather からボットトークンが返ってくるので 必ずコピー（次の手順で使用）

手順 2.3：（任意）ボットをカスタマイズする

BotFather のコマンドでボットをカスタマイズできます：

• /setdescription - ボットの説明を設定
• /setabouttext - ボットのプロフィール文を設定
• /setuserpic - ボットのアイコン画像を設定

これらは任意です。設定しなくてもボットは動作します。

次に、Telegram ボットを OpenClaw の設定に追加します。

手順 3.1：設定ファイルを開く

OpenClaw の設定ファイルは ~/.openclaw/openclaw.json にあります。好きなテキストエディタで開いてください：

# On macOS/Linux:
nano ~/.openclaw/openclaw.json
# or
code ~/.openclaw/openclaw.json  # VS Code
# or
open ~/.openclaw/openclaw.json  # Default editor

手順 3.2：Telegram の設定を追加する

設定ファイルに Telegram チャンネルの設定を追加します。すでに設定ファイルがある場合は、channels セクションに追記してください：

{
  "agents": {
    "defaults": {
      "model": { "primary": "anthropic/claude-opus-4-5" }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN_HERE"
    }
  }
}

YOUR_BOT_TOKEN_HERE を BotFather でコピーしたトークンに置き換えてください。

手順 3.3：保存して Gateway を再起動する

設定を保存したら：

• 設定ファイルを保存する
• 新しい設定を読み込むため OpenClaw Gateway を再起動する

# If Gateway is running as a service:
openclaw gateway restart

# Or if running manually, stop and restart:
openclaw gateway --port 18789 --verbose

動作確認をしましょう！

手順 4.1：Telegram でボットを探す

• Telegram を開く
• ユーザー名（作成したもの。例："myopenclawbot"）でボットを検索
• ボットとのチャットを開始
• /start を送信して初期化

手順 4.2：テストメッセージを送る

例えば次のような簡単なメッセージを送ってみてください：

• 「こんにちは！」
• 「できることを教えて」
• 「自己紹介して」

OpenClaw アシスタントが返信してくるはずです。返信が来たら成功です。チャンネルが動作しました！ 🎉

ボットが応答しない

ボットが返信しない場合：

• Gateway が稼働中か確認：openclaw gateway status
• トークンが正しいか確認：設定ファイルのタイプミスをチェック
• Gateway ログを確認：Telegram 接続に関するエラーがないか探す
• Gateway を再起動：再起動で直ることもあります

「Bot token is invalid」エラー

たいてい次のいずれかです：

• トークンのコピーが誤っている（余計なスペースがないか確認）
• トークンが再生成されている（BotFather から新しいトークンを取得）
• 設定ファイルに構文エラーがある（JSON の書式を確認）

ボットは応答するが Gateway にエラーが出る

ボットは動くのにエラーが出る場合：

• Gateway ログで具体的なエラーメッセージを確認
• AI モデル設定が正しいか確認
• API のクレジット/クォータが残っているか確認

さらに詳しい対処は Troubleshooting ガイドを参照してください。

チャンネル接続ができたら、次はこれを試してみましょう：

他のチャンネル

他のチャンネルも設定したい場合は、各リファレンスへのクイックリンクを使えます：

• WhatsApp の設定 - WhatsApp アカウントと QR コードでペアリング
• Discord の設定 - Discord ボットを作成してサーバーに招待
• すべてのチャンネル - 対応メッセージング基盤の一覧

チャンネルごとに手順は異なりますが、流れはだいたい同じです：アカウント作成/連携 → 資格情報取得 → OpenClaw 設定 → 接続テスト。