跳轉到內容
最近更新

OpenClaw Telegram 接入指南

Telegram 仍然是驗證 OpenClaw 是否安裝正確、網關是否能正常回復消息、以及第一條真實通道工作流是否跑通的最快方式。本指南覆蓋完整的 OpenClaw Telegram 接入流程，包括 Bot 創建、Bot Token 設定、網關重啟、配對和不回覆排查。

為什麼建議先用 Telegram

  • Telegram 往往是最容易驗證的 OpenClaw 通道
  • 只要拿到 Bot Token 並收到一條成功回覆，就能確認網關主鏈路已經跑通
  • 在繼續接入更多通道、技能或 browser relay 之前，它是最穩妥的第一步

你將完成什麼

  • 創建 Telegram Bot 並拿到 Bot Token
  • 在 OpenClaw 中啟用 Telegram 通道
  • 重啟 gateway 並驗證機器人能回覆
  • 學會處理不回覆、網絡受限和配對失敗等常見問題

Step 0：確認 OpenClaw gateway 正常運行

Command
openclaw gateway status || trueopenclaw gateway --detach

如果 gateway 已經在運行，這一步只是確認 OpenClaw 運行時是否可用。如果進程拉不起來，先去看 /docs/troubleshooting。

Step 1：通過 BotFather 創建機器人

  • 搜尋 @BotFather
  • 執行 /newbot
  • 複製拿到的 Telegram Bot Token

Step 2：寫入 Telegram Bot Token 設定

Command
openclaw config set channels.telegram.botToken "YOUR_TELEGRAM_BOT_TOKEN"openclaw config set channels.telegram.enabled true

這是最關鍵的 OpenClaw Telegram 設定。如果 token 錯誤或缺失，機器人可能顯示在線，但普通消息不會收到回覆。

Step 3：重啟 gateway

Command
openclaw gateway restart

重啟後網關才會重新加載 Telegram 通道設定。如果你跳過這一步，新寫入的 bot token 很可能不會生效。

Step 4：在 Telegram 中測試

  • 搜尋你的 bot
  • 發送 /start
  • 再發送一條普通文本消息，確認機器人能回覆

Step 5：如有配對碼則批准

Command
openclaw pairing approve telegram <配對碼>

處理不回覆、網絡受限或 token 異常

  • 用 openclaw config get channels.telegram.botToken 再次確認 token 已保存
  • 每次修改 Telegram 設定後都重啟一次 gateway
  • 確認服務器可以訪問 https://api.telegram.org
  • 如果仍然不回覆，再對照 /docs/advanced-config 和 /docs/troubleshooting 中的 gateway token、運行時和網絡排查步驟

代理問題（國內常見）

Command
export https_proxy=http://127.0.0.1:7890export http_proxy=http://127.0.0.1:7890openclaw gateway restart

相關鏈接