$cd ../tutorials/
popularchannels15 min read • March 2026
$ cat telegram-setup.md
export TelegramSetup
/** 自己ホストのOpenClawで動くTelegram AIボットを作成する */
// WhatsAppよりTelegramを選ぶ理由
• 公式Bot API — 無料、非公式ゲートウェイ不要
• 音声メッセージ — OpenClawが自動文字起こし
• 画像・ファイルサポート — レシート、文書、写真を分析用に送信
• BANリスクなし — 公式統合のため
• インラインボタン — よりリッチなインタラクティブ応答
table-of-contents.ts
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 openclawsection_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モデルを切り替えnext_steps.md