自架 OpenClaw:把個人 AI 助理接進 Telegram、Slack 與 Discord(附 Hermes Agent 比較)

用 Zenavo 的範本在自己的伺服器上部署 OpenClaw,設定公開網址與閘道令牌,串接自己的模型 API 或自架閘道,並綁定 Telegram、Discord、Slack 機器人,打造 24 小時在線的個人 AI 助理。

本文亦提供 English、简体中文、日本語、Español 和 Bahasa Indonesia。

在自己電腦上跑 AI 助理,闔上筆電就斷線,出門在外想從手機 Telegram 或 Discord 發句話查資料、跑任務都不方便。OpenClaw 把個人 AI 助理做成常駐閘道:你在網頁控制台裡配好模型服務商和聊天頻道,就能隨時從 Telegram、Slack、Discord 等通訊軟體裡跟它對話。

本文用 Zenavo 的 OpenClaw 範本把它部署到你自己的 Linux 伺服器上,做到 24 小時在線,並介紹如何串接自架模型閘道,以及與另一個熱門開源智慧體 Hermes Agent 的差異。伺服器、Zenavo 平台與上游模型 API 分別計費。

1. 部署前準備:先準備好一個網域

OpenClaw 在第一次啟動時會把你的公開 HTTPS 網址寫進設定檔(publicOrigin 與 controlUi.allowedOrigins),用來驗證控制台來源與產生回呼網址。

  1. 先在你的 DNS 服務商新增一條指向伺服器 IP 的 A 記錄,例如 assistant.example.com。
  2. 在 Zenavo 中連接一台 Linux 伺服器(範本建議至少預留 2 GB 記憶體)。
  3. 開啟 OpenClaw 範本,在 公開網址(SITE_URL) 一欄填入完整 HTTPS 網址(結尾不要加斜線,例如 https://assistant.example.com),選擇伺服器並部署。

目前範本包含以下設定:

設定 值或用途
映像檔 ghcr.io/openclaw/openclaw:2026.11.3
HTTP 連接埠 18789
狀態與設定磁碟區 /home/node/.openclaw(存放 openclaw.json 與 workspace 工作區)
憑證磁碟區 /home/node/.config/openclaw
OPENCLAW_GATEWAY_TOKEN 建立專案時自動產生的隨機令牌,用於登入網頁控制台
SITE_URL 部署時填寫的公開網址,首次啟動時寫入 openclaw.json

2. 綁定網域並登入控制台

部署完成後:

  1. 開啟 openclaw 服務的 網路(Networking) 頁,為連接埠 18789 綁定剛才填寫的同一個網域(如 assistant.example.com),等待 HTTPS 憑證自動簽發。詳見網域與 HTTPS。
  2. 開啟 openclaw 服務的 變數(Variable) 頁,複製 OPENCLAW_GATEWAY_TOKEN 的值。
  3. 在瀏覽器造訪 https://assistant.example.com,貼上 OPENCLAW_GATEWAY_TOKEN 登入 Control UI。

注意:OPENCLAW_GATEWAY_TOKEN 相當於你的助理管理員密碼,拿到它就能呼叫你綁定的模型和聊天機器人。請把它存進密碼管理器(例如自架的 Vaultwarden),不要發在群組或截圖裡。

3. 串接模型服務商或自架閘道

登入 Control UI 後,先新增模型服務商(Model Provider):

  • 直連官方 API:填入 OpenAI、Anthropic、Gemini 或 DeepSeek 的官方 API Key。
  • 串接自架模型閘道(推薦):如果你在 Zenavo 上部署了 Magpie、New API 或 LiteLLM,可以在閘道裡專門為 OpenClaw 簽發一把有每日額度上限的金鑰,再把 OpenClaw 的模型位址指向閘道。這樣即使機器人被頻繁觸發,也不會刷爆你的上游帳單。
  • 走同專案私有網路:如果閘道和 OpenClaw 在同一個 Zenavo 專案裡(用 新增服務 → 範本 加入),可以直接填內網位址(例如 http://new-api.zenavo.internal:3000/v1 或 http://litellm.zenavo.internal:4000/v1),請求不經過公網,詳見私有網路。

4. 綁定 Telegram、Discord 或 Slack 頻道

在 Control UI 的 Channels 頁面新增你常用的通訊工具:

  1. 建立機器人憑證:例如在 Telegram 中找 @BotFather 傳送 /newbot 建立機器人並拿到 Bot Token;或在 Discord Developer Portal / Slack App 後台建立 Bot。
  2. 填入憑證並啟用頻道:把 Token 填入 OpenClaw 對應頻道設定並儲存。
  3. 限制誰能和機器人對話:公開平台上的機器人一旦上線,任何知道帳號名稱的人都可能傳訊息給它。務必在頻道設定裡開啟使用者白名單(Allowlist),只允許你自己的 Telegram User ID、Discord 帳號或指定的私人伺服器頻道觸發助理。

5. OpenClaw 與 Hermes Agent 怎麼選?

Zenavo 範本庫裡還有另一個同樣支援 Telegram、Discord 和 Slack 的開源智慧體範本——Hermes Agent(由 Nous Research 開源)。兩者的比較如下:

比較項目 OpenClaw Hermes Agent
映像檔與預設連接埠 ghcr.io/openclaw/openclaw:2026.11.3,連接埠 18789 nousresearch/hermes-agent:v0.23.1,連接埠 9119
持久化目錄 /home/node/.openclaw 與 /home/node/.config/openclaw /opt/data
控制台登入方式 使用 OPENCLAW_GATEWAY_TOKEN 令牌登入 使用者名稱 admin,密碼在 HERMES_DASHBOARD_BASIC_AUTH_PASSWORD 變數中
側重點 個人多頻道 AI 助理與工作區閘道,設定輕量直覺 強調長期記憶(Memory)、技能(Skills)累積與自主任務執行

如果你想快速架一個跨通訊軟體互通的隨身助理,從 OpenClaw 開始最順手;如果你更看重 Nous Research 生態的長期記憶與技能擴充,可以直接一鍵部署 Hermes Agent 範本。

6. 備份與升級

OpenClaw 的設定、工作區檔案與頻道憑證都在 /home/node/.openclaw 與 /home/node/.config/openclaw 兩個磁碟區裡:

  1. 在維護時段停止專案,在 openclaw 服務的 備份與還原(Backup & Restore) 頁為這兩個磁碟區建立備份,完成後啟動專案並下載備份妥善保管。步驟見備份與還原。
  2. 範本預設固定在驗證過的版本(2026.11.3)。需要升級時,先備份磁碟區,閱讀上游發行說明,再於服務 設定 → 來源 中修改映像檔標籤。

常見問題

打開網域提示來源不被允許(Origin not allowed)或無法連線? 檢查兩點:一是部署時填寫的 SITE_URL 是否與實際綁定的網域完全一致(必須帶 https://,且結尾不能有 /);二是如果你在首次啟動之後才修改了 SITE_URL 變數,由於啟動腳本只在 /home/node/.openclaw/openclaw.json 不存在時產生設定,你需要同步修改該檔案中的 publicOrigin 和 controlUi.allowedOrigins,再重新啟動服務。

為什麼容器啟動後健康檢查要等一會兒才變綠燈? OpenClaw 首次啟動需要初始化設定與閘道程序,範本設定了 60 秒的啟動寬限期(start_period: 60)。如果超過兩分鐘仍未就緒,可以在控制台右側呼出內建的 Zenavo Agent 或用 Claude Code MCP 查看啟動日誌。

機器人在群組裡不回覆訊息? 以 Telegram 為例,Bot 預設開啟隱私模式(Privacy Mode),在群組裡只能收到 / 開頭的指令或直接 @ 它的訊息。如果需要讓它在群組裡回應一般訊息,可以在 @BotFather 的 /setprivacy 中關閉隱私模式,同時確認該群組或你的帳號已加入白名單。

還需要網頁版聊天介面嗎? OpenClaw 適合從現有的即時通訊軟體(Telegram、Slack、Discord)隨手呼叫;如果你還想要一個支援檔案上傳、知識庫與多人帳號的獨立聊天網站,可以在同一台伺服器上搭配部署 Open WebUI 或 LobeHub。

準備好網域,從 OpenClaw 範本或 Hermes Agent 範本開始,幾分鐘就能把你的個人 AI 助理放進手機聊天軟體裡。