Telegram 機器人設定

逐步教學：將 Claw Buff Agent 連接到 Telegram

將您的 Claw Buff AI Agent 連接到 Telegram，讓使用者可以透過私訊或群組與它聊天。設定大約需要 5 分鐘。

前置需求

一個 Telegram 帳號
已部署的 Claw Buff Agent（快速入門）

步驟 1：使用 BotFather 建立機器人

開啟 BotFather

開啟 Telegram，搜尋 @BotFather（認明藍色勾勾的官方驗證標誌）。這是 Telegram 官方用來建立和管理機器人的工具。

建立機器人

傳送 /newbot 給 BotFather，並依照提示操作：

機器人名稱 — 機器人的顯示名稱（例如「我的 AI 助理」）
機器人使用者名稱 — 必須以 bot 結尾（例如 my_claw_bot）

儲存 Bot Token

BotFather 會回覆一組 Bot Token，格式如下：

123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11

複製這組 Token — 下一步會用到。

請妥善保管 Bot Token。任何擁有此 Token 的人都能控制您的機器人。切勿在公開聊天室分享或提交至 Git。

步驟 2：連接至 Claw Buff

開啟 Claw Buff 管理後台 → 頻道頁面
找到 Telegram 卡片並點擊連接
貼上步驟 1 取得的 Bot Token
點擊儲存並啟用

幾秒鐘內 Agent 就會連接到 Telegram。您會看到狀態變更為已連接。

步驟 3：授權存取

預設情況下，您的機器人使用配對模式 — 新使用者必須經過核准才能聊天。當有人第一次向機器人傳送訊息時，會看到：

OpenClaw: access not configured.
Your Telegram user id: 1234567890
Pairing code: ABCD1234
Ask the bot owner to approve with:
openclaw pairing approve telegram ABCD1234

透過待處理請求核准

前往 Claw Buff 管理後台 → 頻道頁面。當有人請求存取時，會自動出現待處理的配對請求區塊，顯示待核准的配對碼。點擊請求旁的核准即可。

配對碼會在 1 小時後過期。如果已過期，使用者只需再次向機器人傳送訊息即可取得新的配對碼。

管理已授權使用者

您也可以直接管理存取權限。點擊 Telegram 頻道卡片上的管理即可：

檢視所有目前已授權的使用者
新增使用者 — 輸入其 Telegram 使用者 ID（主動授權）
移除使用者以撤銷其存取權限

步驟 4：開始聊天

開啟 Telegram，透過使用者名稱找到您的機器人，傳送一則訊息。您的 AI Agent 就會回應！

群組聊天設定

若要在 Telegram 群組中使用機器人：

將機器人加入群組
機器人預設會在被 @提及 時回應

在群組中，機器人只會在被提及時回應（例如 @my_claw_bot 今天天氣如何？）。這可以避免機器人在繁忙的群組中回應每一則訊息。

功能一覽

功能	支援狀態
私人訊息	是
群組聊天	是（需提及）
串流回應	是（即時輸入）
豐富格式	是（HTML/Markdown）
論壇主題	是
檔案附件	是

常見問題

1. 機器人沒有回應？

檢查 Token — 確認您貼上的 Token 完整無誤，沒有多餘的空格
檢查管理後台 — 頻道頁面會顯示連線狀態與錯誤紀錄
網路問題 — 您的 Agent 需要能透過 443 埠連線至 api.telegram.org

2. 機器人回應很慢？

串流回應預設為啟用狀態。機器人會在 AI 產生回覆的同時即時編輯訊息。如果感覺延遲，請在管理後台 → Agent → 模型中確認模型設定。

3. 出現「Forbidden: bot was blocked by the user」？

使用者已在 Telegram 上封鎖了您的機器人。他們需要解除封鎖並重新傳送 /start。