OpenClaw Telegram 設定教學

Author: Kelvin Huang

當 Telegram 與 OpenClaw 整合並妥善設定 channels 之後，將成為一個穩定且彈性的遠端控制介面。Telegram 本身提供高度開放的 Bot API，訊息傳輸穩定、延遲低，並且支援文字、圖片、文件與多媒體格式，這使它非常適合用來觸發像是各稱 OpenClaw 自動化流程。相較於其他通訊方案需要較複雜的驗證或綁定機制，Telegram Bot 的建立流程相對簡單，對於技術導向的開發者而言非常友善。更重要的是，Telegram 支援群組與頻道模式，可以讓您建立公司內部專用的 AI 控制群組，將 OpenClaw 當作公司 AI 助理使用，例如讓行政人員上傳文件、讓技術人員查詢伺服器狀態、讓業務查詢專案進度，全部都在同一個通訊入口完成。

使用 Telegram 的優點不只是聊天工具，而是遠端 AI 控制！不再受限在電腦前操作，也可以從手機發送指令控制電腦、處理文件、搜尋資料或啟動特定腳本。這種行動化控制能力，在實際專案部署或企業環境中會非常實用，也能減少對圖形化介面的依賴。

1. 申請 Telegram 帳號

若您沒有 Telegram 帳號，可先在手機或電腦上安裝 Telegram App，開啟後將會看到使用手機號碼註冊的流程。因為 Telegram 帳號是綁定您的手機號碼，所以只要輸入手機號碼、接收簡訊驗證碼，基本上就能完成建立帳號。

完成登入後會進到聊天列表畫面。建議先做個檢查，確認能正常收發訊息。最簡單的方法就是在搜尋欄輸入「Telegram」或「BotFather」，找到官方機器人帳號並點進去。這一步能先排除「App 連線不穩」造成的問題。

2. 使用 BotFather 建立 Bot 並取得 Token

在 Telegram 的搜尋欄中輸入 BotFather，將會找到一個帶有藍色驗證勾勾的官方帳號。請務必確認是官方帳號，名稱通常顯示為「BotFather」，使用者名稱為 @BotFather，旁邊會有 Telegram 的驗證標記。

點進去之後，按下「Start」或輸入 /start，BotFather 會顯示它能管理機器人的指令清單。這個帳號的角色就是 Telegram 官方的「機器人管理員」，所有 Bot 都是透過它建立。

在對話框輸入 /newbot。 BotFather 會開始一步一步引導你完成建立流程。第一步會請你輸入機器人的顯示名稱，這是使用者在 Telegram 看到的名稱，例如你可以輸入「OpenClaw Assistant」或公司名稱相關的名稱。這個名稱之後仍然可以修改。

接著，會要求你設定使用者名稱（username）。這個名稱必須是全球唯一，並且必須以 bot 結尾，例如 openclaw_company_bot 或 kelvin_openclaw_bot。如果名稱已被使用，BotFather 會要求你重新輸入，直到通過為止。

當這兩步都完成後，BotFather 會回傳一段訊息，其中包含一串很長的字串，

格式通常像這樣： 1234567890:AAE_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx

這一串字就是你的 Bot Token。它相當於這個機器人的「API 金鑰」，建議你立即把這串 Token 複製下來，存放在安全的地方，等一下我們會把它放進 OpenClaw 的設定檔。

注意！任何擁有這個 Token 的人，都可以透過程式控制你的 Bot，請勿公開在網頁或分享給不認識的人。

現在你的 Telegram Bot 已經誕生了，但它目前尚未與 OpenClaw 連接，也還沒設定允許那些人可以使用。

3. 將 Bot Token 寫進 OpenClaw 設定

現在已經取得 BotFather 提供的 Bot Token，接著就是把它寫進 OpenClaw 的設定，然後用一次配對（pairing）流程確認：只有你本人能用這個 Bot 對 OpenClaw 下指令。

在 macOS 上最穩的做法是直接編輯 OpenClaw 的主要設定檔。OpenClaw 官方預設會把設定放在 ~/.openclaw/openclaw.json，

你可以先在終端機開啟這個檔案，例如：

open ~/.openclaw/openclaw.json

接著，在檔案中加入 Telegram 的設定區塊。最小可用版本大概長這樣：把 botToken 換成你剛剛拿到的那串 Token，並保留 dmPolicy: "pairing"（這是預設的安全模式，陌生人私訊會先被要求配對，避免一開始就完全開放）。

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "1234567890:AAE_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      dmPolicy: "pairing",
      groups: { "*": { requireMention: true } },
    },
  },
}

存檔之後，重新啟動 OpenClaw Gateway 載入設定。依照官方文件，Telegram 的 token 設定好之後不需要做「登入」指令，而是直接啟動 gateway 即可。

openclaw gateway

到這裡 OpenClaw 端就準備好了，接下來換 Telegram 端做第一次測試：回到 Telegram，打開你剛剛建立的 Bot，對它送出 /start 或隨便一句話。因為我們把 DM 安全策略設定成 pairing，所以第一次私訊時，OpenClaw 會產生一組配對碼，暫時把你視為「待核准」的使用者。

這時回到終端機，輸入： openclaw pairing list telegram

將會出現一筆待核准的配對請求與配對碼。接著用下面這行核准（把 <CODE> 換成你看到的配對碼）：

openclaw pairing approve telegram <CODE>

核准成功後，你再回 Telegram 跟 Bot 說一句話，理論上就會收到 OpenClaw 的回覆，這就代表「Token 設定正確、Gateway 正常運行、而且你的帳號已通過配對」全部都打通了。配對碼預設有效時間是一小時，所以建議你在拿到配對碼後就直接完成核准。

首先在 Telegram 建立一個 Bot 聊天機器人，您可以使用 Telegram 手機版、網頁版、電腦版操作。

打開 Telegram 搜尋 @BotFather （官方機器人管理帳號），按下 Launch 按鈕。

輸入 Bot 的顯示名稱（例如：CG AI 助理）、Bot 的 username（一定要以 bot 結尾），按下 Create a New Bot 建立新的機器人。

此時 BotFather 會提供一串 Bot Token（長得像 123456789:AA...）。