Telegram 連接教學

Telegram 是所有通訊平台裡最容易設定的。完全免費、不需要 Business 帳號、沒有 API 費用、手機/桌面/網頁同步。第一次連接建議從這個開始。

---

流程總覽

① 用 BotFather 建立 Bot     ← 2 分鐘
② 拿到 Bot Token           ← 即時
③ 在 管理儀表板（Admin Panel） 貼上 Token  ← 30 秒
④ 綁定 AI 夥伴（Rose/Ada/Vi） ← 選一個
⑤ 在 Telegram 對 Bot /start  ← 即時
⑥ 開始對話                  ← 完成！

---

準備工作

你需要：

• Telegram 帳號（手機 App 或 網頁版）
• 管理儀表板 登入權限

---

步驟 1：建立 Telegram Bot

在 Telegram 搜尋 @BotFather（官方認證帳號，有藍色勾勾）。

[截圖：BotFather 對話視窗，顯示官方認證標記]

傳訊息 /newbot 給它，依序回答：

Q1: “Alright, a new bot. How are we going to call it?”
→ 輸入 Bot 的顯示名稱，中文英文都可以（例如：我的 AI 助理）

Q2: “Good. Now let’s choose a username for your bot.”
→ 輸入 Bot 的 username，必須以 bot 結尾（例如：my_ai_assistant_bot）

若 username 已被使用會被要求重填。建議規則：[你的名字]_[用途]_bot。

BotFather 回覆成功訊息並給你一組 Bot Token：

Done! Congratulations on your new bot. ...

Use this token to access the HTTP API:
123456789:ABCdefGHIjklMNOpqrSTUvwxyz

Keep your token secure and store it safely, it can be used by anyone to control your bot.

Token 格式：數字:英數字混合字串（約 46 字元）

---

步驟 2：在 管理儀表板 設定

1. 登入 管理儀表板
2. 切換到要連接的 AI 夥伴 Tab（例如 Ada (oc-2)）
3. 進 Settings → Messaging → Telegram
4. 貼上剛才的 Bot Token
5. 按 Save

[截圖：管理儀表板 > Ada > 設定 > Messaging > Telegram 設定畫面]

管理儀表板 會即時驗證 Token，成功會顯示：

• ✅ Bot Username
• ✅ Bot ID
• ✅ Webhook Status: Connected

失敗常見原因：Token 複製時多了空白、少了字元。

---

步驟 3：開始對話

回到 Telegram，搜尋你剛建立的 Bot username（例如 @my_ai_assistant_bot）。

點 Bot 對話視窗底部的 Start 按鈕（或傳 /start）。

AI 夥伴會回覆歡迎訊息。傳任意訊息即可開始對話。

[截圖：Telegram Bot 對話視窗，顯示歡迎訊息]

---

進階設定

限制誰可以使用（白名單）

預設所有人都能對你的 Bot 傳訊息（Bot username 是公開的）。限制只有你或團隊能用，最簡單的方式是直接告訴 Rose：

「請限制 Ada 的 Telegram Bot 只有我能用，我的 Telegram User ID 是 123456789」

Rose 會幫你執行底層設定。

取得自己的 Telegram User ID： 在 Telegram 搜尋 @userinfobot，傳任意訊息，它會回你的 User ID。

---

進階：手動設定

如果你熟悉終端機，也可以直接 SSH 進主機執行：

openclaw config set channels.telegram.dmPolicy "allowlist"
openclaw config set channels.telegram.allowFrom '["tg:你的用戶ID"]'

在群組中使用

把 Bot 加到 Telegram 群組：

1. 群組設定 → 新增成員 → 搜尋 Bot username
2. 加入後在 BotFather 開啟 Group Privacy：/mybots → 選 Bot → Bot Settings → Group Privacy → Turn off（讓 Bot 能看所有訊息）

群組中的觸發規則：

預設在群組裡 Bot 只回覆有 @mention 的訊息。要改變此行為，告訴 Rose：

「群組 XXX 裡的訊息，Ada 都回覆，不用 @mention」

或手動：

openclaw config set channels.telegram.groups."*".requireMention true
openclaw config set channels.telegram.groups.GROUPID.requireMention false

串流回覆（逐字顯示）

讓 AI 的回覆像 ChatGPT 一樣逐字出現。告訴 Rose：

「把 Ada 的 Telegram 回覆改成串流顯示」

或手動：

openclaw config set channels.telegram.streaming "partial"

媒體支援

Telegram Bot 支援：

• ✅ 文字訊息
• ✅ 圖片（自動讀取，可以問「這張圖是什麼」）
• ✅ 語音訊息（自動轉文字）
• ✅ 文件（PDF、Word、Excel）
• ✅ 貼圖
• ❌ 影片分析（不支援）

---

常見問題

Bot 沒有回應

1. 確認 Token 正確 — 管理儀表板 的 Telegram 設定頁應顯示「Connected」
2. 確認有按 /start — Telegram Bot 第一次對話必須用 /start 開始
3. 檢查容器狀態 — Ada Dashboard → 主頁 → 容器應為 Running
4. 看 活動 紀錄 — 訊息是否被接收？有無錯誤？
5. 重啟容器 — Ada Dashboard → Restart

訊息延遲很高

• 正常情況 1-3 秒回應
• 超過 10 秒表示 AI 模型繁忙或網路異常
• 看 用量分頁，若 Token 消耗正常但慢 → 可能模型限流
• 換輕量模型（GPT-4o-mini、Claude Haiku）通常更快

可以同時建多個 Bot 嗎？

可以。每個 Bot 獨立綁定一個 AI 夥伴。

實用組合：

• Bot 1 → Ada（客服公開）
• Bot 2 → Ada（內部員工私用）
• Bot 3 → Rose（系統告警群組）

Bot Token 外洩怎麼辦

立刻到 BotFather：

/mybots → 選該 Bot → API Token → Revoke current token

BotFather 會發新 Token，舊的立刻失效。記得更新 管理儀表板 的設定。

可以改 Bot 頭像、名稱嗎？

可以，透過 BotFather：

/mybots → 選 Bot →
  - Edit Bot Picture（改頭像）
  - Edit Name（改名字）
  - Edit Description（改描述，Bot 對話視窗底部顯示）
  - Edit About（改 About，使用者點頭像顯示）

---

下一步

• WhatsApp 連接教學 — 企業 API，較複雜但覆蓋全球
• LINE 連接教學 — 台灣、日本、泰國首選
• 通訊平台總覽 — 其他支援的平台
• Ada 設定指南 — 設定客服人格、FAQ、知識庫