Key Findings
  • Telegram 是 OpenClaw 最受歡迎的通訊渠道之一，允許使用者從手機隨時隨地向 AI 代理下達指令、接收報告與控制電腦[1]
  • 整合流程分為三步：(1) 透過 BotFather 建立 Telegram Bot → (2) 將 Bot Token 寫入 OpenClaw 設定 → (3) 完成 Pairing 配對驗證[2]
  • Pairing 機制是 OpenClaw 的安全核心——只有經過配對驗證的 Telegram 帳號才能控制你的代理，防止他人透過你的 Bot 存取你的電腦[5]
  • DM Policy 與群組設定讓你精確控制誰可以與代理互動、在什麼場景下互動，避免未授權存取[1]

一、為什麼選擇 Telegram？

OpenClaw 支援多種通訊渠道，包括 WhatsApp、Discord、LINE 與 Slack。那為什麼 Telegram 是許多使用者的首選？

二、Step-by-Step 設定教學

Step 1：建立 Telegram Bot

在 Telegram 中搜尋 @BotFather（Telegram 官方的 Bot 管理工具），發送以下訊息：[3]

/newbot

BotFather 會依序詢問：

  1. Bot 名稱（顯示名稱）：例如「My AI Agent」
  2. Bot 使用者名稱（唯一識別碼，必須以 bot 結尾）：例如「my_openclaw_agent_bot」

完成後，BotFather 會回覆一段 Bot Token，格式類似：

7123456789:AAHx1234567890abcdefghijklmnopqrstuv

務必妥善保管這個 Token——擁有它的人可以控制你的 Bot。

Step 2：將 Bot Token 寫入 OpenClaw

回到終端機，執行以下指令將 Token 寫入 OpenClaw 的設定：[1]

openclaw config set channels.telegram.botToken "你的BOT_TOKEN"

然後重啟 Gateway 讓設定生效：

openclaw gateway restart

Step 3：Pairing 配對驗證

此時你的 Bot 已經在 Telegram 上線，但還無法控制代理。你需要完成 Pairing（配對）——這是 OpenClaw 確保只有你本人能控制代理的安全機制。[2]

  1. 在 Telegram 中向你的 Bot 發送任意訊息
  2. Bot 會回覆「Pairing Required」並顯示一個配對碼
  3. 在終端機中執行：
# 查看待配對的裝置
openclaw pairing list

# 批准配對
openclaw pairing approve

配對完成後，你就可以在 Telegram 中與 AI 代理正常對話了。

三、DM 政策與群組管理

3.1 DM Policy（私訊政策）

OpenClaw 提供精細的存取控制，決定誰可以透過私訊與代理互動：[1]

openclaw config set channels.telegram.dmPolicy "owner_only"

3.2 群組設定

你可以將 Bot 加入 Telegram 群組，讓團隊成員共同使用 AI 代理。群組中的存取控制同樣由 groupPolicy 管理：

openclaw config set channels.telegram.groupPolicy "allowlist"

安全建議：群組模式下，代理的每次操作都可能影響到你的整台電腦。務必確保群組中的所有成員都是可信任的人。[5]

四、常見使用場景

4.1 遠端開發

人在外面但需要修改伺服器上的程式碼？透過 Telegram 向代理發送指令：

「幫我把 config.js 中的 API_URL 從 staging 改成 production，然後執行部署腳本」

代理會在你的伺服器上執行修改、運行部署，並將結果回報到 Telegram。

4.2 定時報告

搭配 OpenClaw 的 Cron 功能，設定代理每天早上透過 Telegram 發送系統狀態報告：

「每天早上 9 點，檢查伺服器的 CPU、記憶體與磁碟使用率，將摘要傳到 Telegram」

4.3 檔案處理

直接在 Telegram 中傳送檔案給代理處理——例如丟一份 CSV 檔案，請代理分析資料並產生圖表。[6]

五、常見問題排解

問題原因解法
Bot 沒有任何回應Gateway 未啟動或 Bot Token 錯誤確認 Gateway 運行中（openclaw gateway status）；檢查 Token 是否正確
「Pairing Required」反覆出現配對未完成或已過期重新執行 openclaw pairing approve
群組中 Bot 不回應Bot 未被加為管理員或 groupPolicy 限制將 Bot 設為群組管理員；檢查 groupPolicy 設定
訊息延遲超過 30 秒LLM 回應慢或網路延遲切換到更快的模型（Haiku）；檢查 Gateway 所在伺服器的網路
中文回覆出現亂碼模型未設定中文偏好在代理的 System Prompt 中加入語言偏好設定

六、安全最佳實踐

透過 Telegram 控制 AI 代理，本質上是把你的電腦控制權延伸到了網路上。以下是必須遵守的安全原則：[5][8]

  1. 永遠使用 owner_only 或 allowlist：除非你有明確理由，否則永遠不要將 DM Policy 設為 anyone
  2. 定期檢查配對裝置：使用 openclaw pairing list 查看所有已配對的裝置，移除不再使用的
  3. 不要在公開群組使用：只在私人群組或私訊中與代理互動
  4. 輪換 Bot Token：如果懷疑 Token 洩漏，立即在 BotFather 中重新產生（/revoke）並更新 OpenClaw 設定
  5. 限制代理的 Skill 權限：如果代理只需要查詢資料，不要安裝具有檔案修改權限的 Skill

結語

Telegram 與 OpenClaw 的整合讓 AI 代理真正成為你的「遠端助理」——不需要打開電腦，一條 Telegram 訊息就能讓 AI 幫你完成任務。[6] 整個設定過程只需要三個步驟、不到十分鐘。

如果你還沒有安裝 OpenClaw，建議先閱讀《架構解析與實戰部署全指南》完成基礎部署。如果你想了解 WhatsApp、Discord 等其他通道的設定，可以參閱《通訊整合指南》。