Cloudo AgentsCloudo Agents

把您的代理人連到 Telegram

大約 5 分鐘。完成後，您會擁有一個 Telegram 機器人，能從手機或桌面真實的 Telegram 對話中與您的代理人對談。

開始之前

  • 一個已經部署、在入口網站顯示為 active 的代理人
  • 一個 Telegram 帳號（手機或桌面皆可，免費，不需要開發者帳號）
  • 大約 5 分鐘
先理解一個概念

Telegram 的「機器人」其實就是一個由軟體（而非真人）操作的 Telegram 帳號。Telegram 內建一個叫做 @BotFather 的機器人，專門用來建立其他機器人。您傳訊息給 @BotFather，拿到一組 token，把它貼進 OpenClaw，您的代理人就能用 Telegram 對話的形式被使用了。

步驟 1 — 打開 Telegram，找 BotFather 對話

  1. 打開 Telegram（手機或桌面都可以）。
  2. 在搜尋列輸入 @BotFather，點選有藍色驗證勾勾的那個結果。不要選到外觀相似的假帳號 — 只有官方帳號才有勾勾。
  3. 按 Start。

步驟 2 — 建立一個新機器人

  1. 以聊天訊息傳送 /newbot。
  2. BotFather 會問您要的 顯示名稱。這是使用者在對話最上方看到的名字 — 任何容易閱讀的名稱都可以。範例：Acme Support。
  3. BotFather 接著會問 使用者名稱。它必須：
    • 以 bot 結尾（例如 acme_support_bot）
    • 在整個 Telegram 全球唯一（可能要試幾個才會過）
    • 只能使用英文字母、數字和底線
  4. BotFather 會回一則訊息，內含您的 HTTP API token。看起來像這樣：
    123456789:ABCdefGHIjklMNOpqrSTUvwxYZ1234567890
把 token 當成密碼來保管

任何拿到這個 token 的人，都能以您的機器人身分發訊息和讀訊息。不要把它貼到公開聊天、截圖或 git commit 裡。如果不小心洩漏了，傳送 /revoke 給 BotFather，作廢舊的並產生新的。

步驟 3 — 把 token 貼進 OpenClaw

  1. 在 Cloudo 入口網站，點您想連接的代理人上的 Open my OpenClaw。您會進到自己專屬子網域上的 OpenClaw 介面。
  2. 打開 Channels 分頁。
  3. 點 Telegram，然後點 Connect。
  4. 把步驟 2 取得的 token 貼到 Bot Token 欄位。
  5. 點 Save。OpenClaw 會呼叫 Telegram 的getMe 端點來驗證 token，並回應類似：
    Connected as @acme_support_bot (Acme Support)

步驟 4 — 傳送第一則訊息

  1. 在 Telegram 搜尋您機器人的使用者名稱（以 bot 結尾的那個）。
  2. 點 Start。
  3. 隨便傳一則訊息。您的代理人應該在幾秒內，以設定好的語氣回覆。

如果大約 10 秒內還沒收到回覆，請跳到下方的 疑難排解。

選擇性的進階設定

設定機器人指令（讓使用者看到選單）

回到 @BotFather，傳送 /setcommands，挑選您的機器人，然後傳送一份像這樣的清單：

help - Show what I can do
reset - Start over
contact - Talk to a human

Telegram 會在對話中以選單方式呈現這些指令。請務必確保代理人的 SOUL 知道每個指令該做什麼 — 否則這份選單就只是裝飾。

頭像與描述

一樣透過 @BotFather：

  • /setuserpic — 上傳一張正方形圖片（您的 logo 就可以）
  • /setdescription — 第一次打開對話時，使用者會看到的簡短文字
  • /setabouttext — 顯示在機器人個人檔案中、更精簡的一段文字

隱私模式（群組對話）

預設情況下，群組中的機器人只能看到提及自己或回覆自己的訊息（「隱私模式」）。如果您希望代理人讀取群組中的每一則訊息，傳送 /setprivacy 給 BotFather 並選 Disable。大部分機器人都應該保持開啟 — 讀取群組中每一則訊息很侵入性，也會更快消耗您的額度。

疑難排解

機器人顯示「線上」但不回覆

依序檢查：

  1. OpenClaw 的 Channels 分頁 — 連線是否仍顯示為 connected？
  2. 入口網站中您的 額度餘額 — 如果已歸零，代理人就無法回覆。請儲值後再試一次。
  3. 您代理人的 對話記錄 — 打開代理人的儀表板，檢視最近的訊息。如果看得到收到的訊息但沒有送出回覆，請附上細節聯絡客服，我們會協助您診斷。

「401 Unauthorized」或「invalid token」

token 錯了或被撤銷了。回到 @BotFather，傳送 /mybots，挑選您的機器人，然後選 API Token。複製目前的 token，貼進 OpenClaw 的 Telegram channel 設定，儲存。

我傳了訊息，但 OpenClaw 沒收到

Telegram 透過 webhook 或長輪詢來傳遞訊息。OpenClaw 預設使用 webhook，這表示 Telegram 必須能連到您代理人的子網域。請確認：

  • 您代理人的子網域 — 在入口網站 Open my OpenClaw 旁邊有顯示 — 在瀏覽器中可以打開並顯示 OpenClaw 介面。這代表 TLS 與連通性都沒問題。（sslip 格式的子網域使用自簽憑證，第一次載入會跳瀏覽器警告 — 這對開發環境的租戶來說是正常的。）
  • OpenClaw 裡的 bot token 與 BotFather 目前顯示的 token 一致。
  • 您沒有不小心把同一個機器人連到兩個 OpenClaw 實例。Telegram 的 webhook 只有一個端點 — 後設定的會覆蓋先前的。

如果還是卡住，請從入口網站開一張支援單，附上：您的 tenant ID、機器人的使用者名稱（不要附 token），以及一則沒成功送達的訊息的時間戳。我們可以從 VM 上撈出代理人的記錄檔。

我想刪除這個機器人

在 @BotFather 傳送 /deletebot，挑選機器人，確認。請注意：使用者名稱在刪除後會被保留約 24 小時 — 您無法立刻重複使用。

就這樣。同一個機器人可以在 Telegram 上回覆客戶，OpenClaw 也能同時處理您的 Discord 和 Slack — 一個代理人、所有管道、每個介面都不必額外設定。下一步： 連接 Discord 或 Slack。

連接 Telegram — Cloudo 文件