2026年9月20日 星期日

OpenClaw 學習筆記 : 在樹莓派 Pi 4 安裝 OpenClaw (八)

在前一篇測試中我已重新編輯 workspace 下的 md 檔, 但到目前為止都只能在區網或透過 ngrok 穿透內網方式, 利用 Web UI 介面與 OpenClaw 助理對話, 接下來要開啟頻道 (Chanel ) 功能, 綁定到 社社群帳戶, 這樣就能透過社群軟體與 AI 助理對話了. 本篇先來綁定設定較簡單的 Telegram App.

本系列全部測試文章索引參考 :


在設定 Telegram 頻道之前須要先在手機安裝 Telegram App, 建立 Telegram 聊天機器人, 取得 Telegram API token 與聊天室的識別碼 (ID), 作法參考 : 


先摘要整理 OpenClaw 與頻道的連接機制 (參考旗標 "OpenClaw 超入門"), 當使用者透過社群 App 傳送訊息到 OpenCraw 的 Gateway 時, 會攜帶來源資訊, 包含使用者 ID, 聊天室 ID, 與聊天類型 (私訊/群聊), OpenClaw 首先會進行來源識別, 判斷訊息來自哪一個社群平台 (LINE, Telegram 等), 然後將訊息送到對應之平台模組, 依據 OpenClaw 的互動政策決定如何處理. 若符合政策之條件允許該使用者與 OpenClaw 互動, 進一步交由 LLM 處理; 若不符合政策條件, OpenClaw 會無視該訊息而不予回應. 

OpenClaw 的互動政策分為兩類 :
  • 私人互動政策 (DM Policy) : 決定單一使用者是否可與 OpenClaw 私訊對話.
  • 群組互動政策 (Group Policy) : 決定某個群組是否可以觸發 OpenClaw 回應. 
OpenClaw 的私如互動政策有四種 :
  • Pairing (配對) : 
    這是預設且較安全的方式, 使用者第一次私訊時, 系統會先提供一組配對碼, 使用者要將該配對碼告知 OpenClaw 管理者下指令進行配對, 成功後使用者才能取得授權與 OpenClaw 進行對話. 
  • Allowlist (允入名單) :
    這是比配對更封閉的方式, 只有在允入名單中的使用者才能與 OpenClaw 互動, 名單外的任何使用者都不會得到回應. 
  • Open (完全開放) :
    對於任何找到此帳號的使用者, OpenClaw 都會做出回應, 風險很高, 只適合用於展示與短期測試. 
  • Disabled (停用私訊) :
    完全關閉透過頻道私訊, 適合只開放群組使用群聊. 
群組互動政策則分為三種 :
  • Open (完全開放) :
    只要訊息來自群組, OpenClaw 就會做出回應.
  • Allowlist (允入名單) :
    只有在允入名單中的群組, OpenClaw 才會回應來自該群組的訊息.
  • Disabled (停用) :
    禁止任何群駔與 OpenClaw 互動. 
我之前測試 Telegram 時就已經在手機安裝好 Telegram App, 只要為 Openclaw 聊天頻道建立一個新的聊天機器人即可 :


1. 建立 Telegram Bot 聊天機器人 : 

只要跟 Telegram 上一個名叫 @BotFather 聊天即可建立一個新的聊天機器人, Telegram 上的聊天機器人都是透過 @BotFather 建立與管理的, 所以如同字面意思, 它是聊天機器人之父. 按 Telegram 右上角的搜尋鈕, 輸入 BotFather 搜尋, 點最多使用者, 穿西裝頭像那個才是正宗 BotFather, 按 Open 鈕 :




 
按 Create a New Bot 鈕 : 




填寫機器人資訊, 第一與第三欄位為必填, 第三欄位 username 須為唯一且以 "_bot" 結尾, 只要顯示 is available 即可按 Create Bot 鈕 :




按 Copy 鈕將此聊天機器人的 API Key 複製後貼到文字檔儲存備用 :




然後按左上角的 Back 就會看到這名為 mypi4claw_bot 的聊天機器人了 (如果沒有就搜尋看看) :




2. 連接 Telegram 頻道 : 

開啟終端機, 輸入 openclaw configure :

pi@pi4b:~ $ openclaw configure   

因 OpenClaw 安裝於本機, 所以 Gateway 要選擇預設的 Local, 按 Enter :




按向下鍵移動到 Channels 按 Enter : 




選擇 Add or update channels 按 Enter : 




按向下鍵移動到 Telegram 按 Enter : 




按 Enter Telegram bot token :




將上面取得的 Bot API key 貼在 "輸入 Telegram bot API" 下方按 Ebter :




移到最底下的 "完成" 按 Enter :




選擇 No 的預設配對模式, 這代表當在 Telegram 私訊 (DM) 這個機器人時, 它會要求驗證/配對你的身分, 只有通過核准的帳號才能對它下達指令, 可防止陌生人在 Telegram 隨意呼叫 OpenClaw 助理 (Yes 是開放任何人皆可下達指令) : 




向下移動到最底下的 Done 按 Enter 結束設定 : 






3. 啟用頻道與配對 : 

回到手機的 Telegram App, 進入上面建立的聊天機器人, 按底下的 Start 按鈕啟用頻道 : 




輸入 "您好" 或任何訊息, 機器人會回應配對碼, 將此配對碼填入下列指令 :

openclaw paring approve telegram <配對碼> 

pi@pi4b:~ $ openclaw pairing approve telegram BM8A7YCF   
│
◇  

OpenClaw 2026.7.1-2 (0790d9f) — Runs on a Raspberry Pi. Dreams of a rack in Iceland.

Approved telegram sender 77xxxxxx72.
Command owner configured telegram:77xxxxxx72 (commands.ownerAllowFrom was empty).

這樣就完成 Telegram 配對了, 可以回到手機 Telegram App 跟 Pi 4 上的 OpenClaw 聊天 : 



沒有留言:

張貼留言