教程 02 — 接入 Telegram：讓 AI 助手住進你的聊天軟體
目標：配置 Telegram Bot，讓你能在手機上隨時和 AI 對話，支援私聊和群組。
原理
OpenClaw 網關啟動後會監聽多個「頻道」。Telegram 頻道通過 Bot API 長輪詢接收訊息，再路由給 AI 代理處理，回覆發回 Telegram。
你的手機 → Telegram 伺服器 → Bot → OpenClaw 網關 → MiniMax → 回覆
第一步：建立 Telegram Bot
-
打開 Telegram，搜尋 @BotFather
-
發送
/newbot，按提示填寫名字和使用者名稱 -
取得 Token，格式類似：
8543054163:AAHc-yE-nfRlbGw1clvW1OwjdMZ6O_j9tWs
第二步：把 Token 寫入配置
編輯 .env（專案根目錄或 ~/.openclaw/.env）：
TELEGRAM_BOT_TOKEN=你的token或者直接寫進 ~/.openclaw/openclaw.json 的 env 區塊：
{
"env": {
"MINIMAX_API_KEY": "${MINIMAX_API_KEY}",
"TELEGRAM_BOT_TOKEN": "你的token"
}
}第三步：啟用 Telegram 頻道
在 openclaw.json 中加入 channels 配置：
{
"channels": {
"telegram": {
"enabled": true,
"token": "${TELEGRAM_BOT_TOKEN}"
}
}
}第四步：重啟網關
pnpm openclaw gateway restart查看日誌確認 Telegram 頻道已連接：
tail -f /tmp/openclaw/openclaw-$(date +%Y-%m-%d).log | grep -i telegram
# 應看到類似：Telegram channel connected第五步：測試對話
-
打開 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 支援發送圖片和檔案嗎？
收發圖片支援需要配置視覺模型（如 MiniMax VL-01），參見教程 07。檔案發送功能取決於 OpenClaw 版本，可通過 /status 查看當前支援的能力。
如何在多台設備上使用同一個 Bot？
Bot Token 在 openclaw.json 中配置一次，所有登入了你 Telegram 帳號的設備都可以與同一個 Bot 對話。Bot 會話是按 chat_id 隔離的，不會互相干擾。