OpenClaw OpenClaw
← 返回首頁
2026 最新 Telegram Bot API OpenClaw 零基礎

【2026 最新】OpenClaw × Telegram 完整安裝教學 用 BotFather 打造你的 AI 助理

透過 BotFather 建立 Telegram Bot,接通 OpenClaw AI 助手,不需要 Webhook 設定,免費方案,零基礎也能在 30 分鐘內完成。

閱讀時間 約 10 分鐘 2026 年 4 月更新 Windows / macOS / Linux
Telegram Bot 教學封面

前言

Telegram 是全球最受歡迎的即時通訊軟體之一,擁有強大的 Bot API、豐富的多媒體支援, 以及跨平台(手機、桌面、網頁)的完整體驗。相較於其他通訊平台,Telegram Bot 的建立完全免費, 而且不需要 Webhook 設定——預設使用 Long Polling 模式,你的電腦直接就能跟 Telegram 伺服器溝通。

OpenClaw 是一套完全免費的開源軟體,只要在你自己的電腦上安裝好, 再透過幾個步驟串接 Telegram Bot,就能讓你的 Bot 直接跟 Claude AI 對話, 資料全部存在你自己的電腦上,不經第三方雲端。

注意事項

申請 Claude API 需要信用卡或虛擬卡,每月費用約 US$20-100(依使用量而定)。詳情請參考 Claude API 使用付費說明

費用一覽

OpenClaw 免費(開源)
Telegram Bot 免費
Claude API 用量 約 US$20-100 / 月

為什麼選 Telegram?

Telegram 在全球擁有超過 9 億月活躍用戶,以隱私、速度和開放的 Bot 生態系聞名。 用 Telegram 來串接 AI 助理,有以下幾個明顯優勢:

  • 建立 Bot 完全免費,沒有訊息數量限制
  • API 功能最豐富——按鈕、檔案、語音、貼圖、位置,全部支援
  • 任何裝置都能用——手機、桌面、網頁版,無縫切換
  • 不需要 Webhook——預設 Long Polling,本地電腦也能直接連,不用公開 HTTPS 網址
  • 資料存在自己電腦,不經第三方雲端

安裝流程總覽

整個設定分成 4 大步驟,依序完成即可:

1

建立 Telegram Bot

2

安裝 OpenClaw

3

設定 Bot Token

4

連接測試完成

Step 1

建立 Telegram 機器人

Telegram 的 Bot 系統透過官方的 @BotFather 管理,所有 Bot 的建立、設定、刪除都在 BotFather 對話中完成。 整個流程只需要幾分鐘。

1-1 搜尋 @BotFather

打開 Telegram,在搜尋欄輸入 @BotFather, 點擊官方認證的 BotFather(帶有藍色勾勾),按「Start」開始對話。

搜尋 BotFather

1-2 建立新 Bot

發送 /newbot 給 BotFather,接著依照提示輸入 Bot 名稱和 username。 BotFather 會回傳你的 Bot Token,這是後面連接 OpenClaw 的關鍵憑證。

你:/newbot
BotFather:Alright, a new bot. How are we going to call it? Please choose a name for your bot.
你:My AI Assistant
BotFather:Good. Now let's choose a username for your bot. It must end in `bot`. Like this, for example: TetrisBot or tetris_bot.
你:my_ai_assistant_bot
BotFather:Done! Congratulations on your new bot. Use this token to access the HTTP API:
7234567890:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
取得 Bot Token

重要:複製 Bot Token 保存

把 Bot Token 複製到記事本存好,格式類似 7234567890:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。 這個 Token 等同你 Bot 的密碼,不要分享給其他人。

1-3 取得你的 User ID

在 Telegram 搜尋 @userinfobot, 對它按「Start」,它會自動回覆你的 User ID(一串數字,例如 123456789)。 把這個數字也記下來。

為什麼需要 User ID?

設定 User ID 作為管理員,確保只有你才能跟助手對話,避免其他人使用你的 Claude API 額度。 這是安全設定中很重要的一步。

到這裡你應該有以下資料存在記事本:

  • Bot Token(格式:數字:英數字串)
  • 你的 User ID(純數字)
Step 2

安裝 OpenClaw

OpenClaw 提供一鍵安裝腳本,透過 Windows PowerShell 執行即可。 先確認你的系統環境,然後按照以下步驟進行。

2-1 以系統管理員開啟 PowerShell

按下 Windows 鍵,搜尋「PowerShell」,對它按右鍵選「以系統管理員身分執行」。

2-2 執行安裝指令

複製以下指令貼入 PowerShell,按 Enter 執行:

PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex

可能遇到的問題

如果出現「無法執行指令碼」的錯誤,請先執行:

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

2-3 執行初始設定精靈

PowerShell
openclaw onboard --install-daemon

2-4 確認安裝成功

執行以下指令,瀏覽器會自動開啟控制台,看到介面代表安裝成功:

PowerShell
openclaw dashboard
Step 3

設定 Bot Token 與連接

OpenClaw 安裝完成後,需要把 Telegram Bot Token 和你的 User ID 填入設定, 讓 OpenClaw 知道該連接哪個 Bot、誰有權使用。

3-1 在設定精靈中選擇 Telegram

執行 openclaw onboard 時,系統會詢問你要串接的頻道,選擇 Telegram

選擇 Telegram 頻道

3-2 貼上 Bot Token

把 Step 1 取得的 Bot Token 貼入。

3-3 設定管理員 User ID

輸入你的 Telegram User ID,只有這個 ID 的使用者才能跟 Bot 對話。

設定管理員 User ID

3-4 手動設定(進階)

如果你偏好手動編輯設定檔(路徑:C:\Users\你的名字\.openclaw\openclaw.json), 加入以下 Telegram 設定:

openclaw.json
{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "貼上你的 Bot Token",
      "dmPolicy": "allowlist",
      "allowlist": ["你的 User ID"]
    }
  }
}

或者透過環境變數設定:

環境變數
TELEGRAM_BOT_TOKEN=your_bot_token

不需要設定 Webhook!

Telegram 預設使用 Long Polling 模式,你的電腦會主動去問 Telegram 伺服器有沒有新訊息, 所以不需要公開的 HTTPS 網址,也不需要設定 Cloudflare Tunnel 或 ngrok。 這讓整個設定流程簡單很多!

Step 4

測試連接

設定完成後,來測試 Bot 是否正常運作。

4-1 傳訊息給你的 Bot

在 Telegram 搜尋你剛才建立的 Bot(用 username 搜尋,例如 @my_ai_assistant_bot), 按「Start」後傳送一則訊息:

傳送給 Bot 的訊息
你好!你是誰?

如果一切正常,Bot 會回覆 Claude AI 的回答。

4-2 確認 Gateway 狀態

你也可以在 PowerShell 中執行以下指令確認連線狀態:

PowerShell
openclaw gateway status

恭喜完成!

現在打開 Telegram,跟你的 Bot 傳訊息,Claude AI 就會自動回覆了!整個過程不需要 Webhook、不需要公開網址,就這麼簡單。

安全設定

OpenClaw 提供多種存取策略(dmPolicy),你可以根據需求選擇適合的模式:

模式 說明
pairing 新使用者需要輸入配對碼,你審核通過後才能使用
allowlist 只有白名單中的 User ID 可以使用(推薦個人使用)
open 任何人都能跟 Bot 對話(注意 API 費用)
disabled 暫時關閉 Telegram 頻道

配對模式指令

如果你使用 pairing 模式,可以用以下指令管理:

PowerShell
# 查看待配對清單
openclaw pairing list telegram

# 審核配對(把 CODE 換成配對碼)
openclaw pairing approve telegram CODE

群組隱私模式

如果你想在 Telegram 群組中使用 Bot,預設情況下 Bot 只能收到 /command 格式的訊息。 要讓 Bot 收到所有訊息,需要在 BotFather 中關閉 Privacy Mode(發送 /setprivacy → 選擇你的 Bot → Disable), 或者將 Bot 設為群組管理員。

常見問題 FAQ

Bot 沒有回覆?
請依序檢查:
  1. Bot Token 是否正確填入設定檔
  2. 你的 User ID 是否在允許清單中
  3. OpenClaw Gateway 是否在執行中(openclaw gateway status
  4. Claude API Key 是否有效且有足夠額度
  5. 查看日誌檔確認錯誤訊息(openclaw logs
如何在群組中使用?
預設情況下,Telegram Bot 在群組中只能收到以 / 開頭的指令。要讓 Bot 收到所有訊息,有兩個方法:
  1. 在 BotFather 中關閉 Privacy Mode:發送 /setprivacy → 選擇你的 Bot → Disable
  2. 將 Bot 設為群組管理員(管理員可以收到所有訊息)
想重新配置?
隨時可以重新執行設定精靈:
openclaw onboard

或者直接編輯設定檔:

openclaw configure