自架 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),用來驗證控制台來源與產生回呼網址。
- 先在你的 DNS 服務商新增一條指向伺服器 IP 的
A記錄,例如assistant.example.com。 - 在 Zenavo 中連接一台 Linux 伺服器(範本建議至少預留 2 GB 記憶體)。
- 開啟 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. 綁定網域並登入控制台
部署完成後:
- 開啟
openclaw服務的 網路(Networking) 頁,為連接埠18789綁定剛才填寫的同一個網域(如assistant.example.com),等待 HTTPS 憑證自動簽發。詳見網域與 HTTPS。 - 開啟
openclaw服務的 變數(Variable) 頁,複製OPENCLAW_GATEWAY_TOKEN的值。 - 在瀏覽器造訪
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 頁面新增你常用的通訊工具:
- 建立機器人憑證:例如在 Telegram 中找
@BotFather傳送/newbot建立機器人並拿到 Bot Token;或在 Discord Developer Portal / Slack App 後台建立 Bot。 - 填入憑證並啟用頻道:把 Token 填入 OpenClaw 對應頻道設定並儲存。
- 限制誰能和機器人對話:公開平台上的機器人一旦上線,任何知道帳號名稱的人都可能傳訊息給它。務必在頻道設定裡開啟使用者白名單(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 兩個磁碟區裡:
- 在維護時段停止專案,在
openclaw服務的 備份與還原(Backup & Restore) 頁為這兩個磁碟區建立備份,完成後啟動專案並下載備份妥善保管。步驟見備份與還原。 - 範本預設固定在驗證過的版本(
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 助理放進手機聊天軟體裡。
這是 coding agent 讀到的內容,網址是 https://zenavo.app/zh-TW/blog/self-host-openclaw.md。
無法載入 Markdown,請直接開啟: https://zenavo.app/zh-TW/blog/self-host-openclaw.md