$cd ../tutorials/
popularchannels15 min read • March 2026
$ cat telegram-setup.md

export TelegramSetup

/** 自己ホストのOpenClawで動くTelegram AIボットを作成する */

// WhatsAppよりTelegramを選ぶ理由
公式Bot API — 無料、非公式ゲートウェイ不要
音声メッセージ — OpenClawが自動文字起こし
画像・ファイルサポート — レシート、文書、写真を分析用に送信
BANリスクなし — 公式統合のため
インラインボタン — よりリッチなインタラクティブ応答
section_01_botfather.md

## 🤖 BotFatherでボットを作成

ステップ1:BotFatherを開く
Telegramで@BotFather(青い認証チェックマーク付き)を検索して/startをタップします。
ステップ2:新しいボットを作成
/newbotを送信します。BotFatherが名前とユーザー名(botで終わる必要あり)を尋ねます。例:MyOpenClawBot。
ステップ3:ボットトークンを保存
BotFatherからトークンが発行されます。これはボットの鍵となるため、安全に保管してください。
7123456789:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw
section_02_user_id.md

## 🪪 TelegramユーザーIDを取得

ユーザーIDはあなたを識別する固有の番号です。OpenClawはこれを使用してボットアクセスをあなただけに制限します。

1. Telegramで@userinfobotにメッセージを送ります。
2. あなたの情報が返信されます。Idを記録してください:
Id: 123456789
First: John
Username: @johndoe
section_03_config.yaml

## ⚙️ OpenClawを設定

OpenClaw設定ファイルにTelegramチャンネルを追加します:

# openclaw/config.yaml
channels:
telegram:
enabled: true
bot_token: "YOUR_BOT_TOKEN"
allowed_user_ids:
- 123456789 # Your Telegram user ID
enable_voice: true
enable_vision: true
Restart OpenClaw: docker restart openclaw
section_04_webhook.sh

## 🔗 Webhookを設定

Telegramはメッセージの送信先を知る必要があります。サーバーが公開アクセス可能な場合(ドメイン付きVPSまたはTailscale)、ゼロレイテンシのWebhookメソッドを使用します:

# Replace with your actual bot token and server URL
$ curl -X POST \
"https://api.telegram.org/botYOUR_BOT_TOKEN/setWebhook" \
-d "url=https://your-server.com/telegram/webhook"
// response: {"ok":true,"result":true,"description":"Webhook was set"}

// 💡 パブリックURLなしでローカル実行している場合も問題ありません。OpenClawは自動的にポーリングモードにフォールバックします — ローカル設定にWebhookは不要です。

section_05_voice_vision.md

## 🎙️ 音声&ビジョンを有効化

ここがTelegramが他のチャンネルより際立つ点です。OpenClawは聞いて見ることができます。

音声メッセージ
ボイスノートを送信 → OpenClawがWhisper(ローカルまたはAPI)でテキスト化 → テキストで応答。enable_voice: trueが必要、プライバシーのためローカルWhisperモデル推奨。
画像&ビジョン
レシート、ホワイトボード、文書の写真を送信 → OpenClawが設定されたビジョンモデル(GPT-4o、Claude、またはローカルLLaVA)で分析。
ファイル分析
PDF、CSV、テキストファイルを送信。TelegramはBot経由で最大2GBのファイルアップロードをサポート(インラインは20MB)。大きなファイルには共有ディレクトリをマウントしてください。
section_06_test.md

## 🧪 ボットをテスト

Telegramでボットのユーザー名を検索し、テストメッセージを送信してください:

You → /start
Bot → 🦞 OpenClaw online. How can I help?
You → Summarize the top HackerNews posts today
Bot → Fetching... Here are today's top 5 stories on HN:
1. "Llama 4 released with 400B parameters..."
2. "Why Rust won the systems programming war..."
...
BotFather(/setcommands)で設定する便利なボットコマンド:
/status — OpenClawのステータスを確認
/memory — 会話メモリを表示
/clear — コンテキストをクリア
/model — AIモデルを切り替え
$ cd ../tutorials/* END_OF_TUTORIAL */