
ZeaburOpenClaw 🦞(原 Clawdbot、Moltbot)是一個個人 AI 助手,可在本地運行並透過 WebSocket Gateway 架構連接多個訊息平台。
⚠️ 本模板使用 ghcr.io/openclaw/openclaw:2026.3.7。OpenClaw 🦞 正在快速開發中,可能存在尚未發現的 bug。更改版本後也無法確保穩定性。
⚠️ 如果遇到任何問題,歡迎到 GitHub issues 尋找解決方案或回報新問題。Zeabur 平台相關問題請聯繫 Zeabur 支援。
⚠️ macOS 特有的軟體與套件(如 Homebrew)無法在此容器環境中使用,請尋找其他替代方案。
⚠️ 此模板需要在 Zeabur 上使用專用伺服器,無法在共享叢集上運行。
⚠️ 本模板已預先設定好可直接使用,不需要執行 openclaw onboard。如果要重新設定,請在 Zeabur 控制台開啟指令執行:
openclaw onboard --gateway-bind lan
完整參數請參考 Wizard Reference。
glm-4.7-flash):若部署時已輸入 API Key,直接前往步驟 3。也可之後在 Zeabur 控制台的變數頁籤新增 ZEABUR_AI_HUB_API_KEY(新增後記得重新啟動服務)。anthropic/claude-opus-4-6。前往 Web UI Settings 或環境變數新增 API 金鑰。詳情請見:https://docs.openclaw.ai/providers/anthropicAI 模型設定請參閱官方文件。
此模板內建 failover 模型,當主模型不可用時會自動切換。預設鏈:glm-4.7-flash → grok-4-fast-non-reasoning → minimax-m2.5 → kimi-k2.5 → qwen-3-235b → gpt-5-mini。
可透過 Web UI Chat 或 Zeabur 控制台的指令管理模型。
透過 Web UI Chat — 在對話框直接輸入 slash command:
/model zeabur-ai/glm-4.7-flash — 切換主模型/model — 查看目前模型/models — 列出模型供應商/models <provider> — 列出指定供應商的模型(例如 /models zeabur-ai)透過指令(Zeabur 控制台)— 在終端機執行相同指令:
openclaw models set zeabur-ai/glm-4.7-flash
openclaw models status
openclaw models list --all
openclaw models fallbacks list
openclaw models fallbacks add zeabur-ai/gpt-5-mini
openclaw models fallbacks remove zeabur-ai/gpt-5-mini
openclaw models fallbacks clear
或直接編輯設定檔(~/.openclaw/config.json5):
"agents": {
"defaults": {
"model": {
"primary": "zeabur-ai/glm-4.7-flash",
"fallbacks": ["zeabur-ai/grok-4-fast-non-reasoning", "zeabur-ai/minimax-m2.5"]
}
}
}
編輯設定檔後需重新啟動服務。
除了 Zeabur AI Hub,您也可以新增 Anthropic、OpenAI、Google 等外部供應商。
方法一:環境變數 — 在 Zeabur 控制台的變數頁籤新增 API key:
ANTHROPIC_API_KEY — Claude 模型OPENAI_API_KEY — GPT 模型GOOGLE_API_KEY — Gemini 模型新增後重新啟動服務,然後切換模型:
/model anthropic/claude-opus-4-6openclaw models set anthropic/claude-opus-4-6方法二:Auth token — 在 Zeabur 控制台開啟指令:
# 貼上供應商的 API key
openclaw models auth paste-token --provider anthropic
# 或使用互動式認證助手
openclaw models auth add
方法三:設定檔 — 編輯 ~/.openclaw/config.json5:
"models": {
"providers": {
"anthropic": { "apiKey": "sk-ant-..." },
"openai": { "apiKey": "sk-..." }
}
}
所有支援的供應商請參閱官方文件。
從 BotFather 取得 Token:
/newbot 建立新機器人123456789:ABCdefGHIjklMNOpqrsTUVwxyz)將 Token 加入 Zeabur:
TELEGRAM_BOT_TOKEN 並填入您的 Token"plugins": { "entries": { "telegram": { "enabled": true } } }。如需停用,將 enabled 設為 false。配對您的 Telegram 帳號:
/startJN4MSY23)openclaw pairing approve telegram <配對碼>openclaw pairing approve telegram <配對碼>Approved telegram sender <user-id>. 表示配對成功步驟 1:設定 WhatsApp 頻道 透過 OpenClaw Web UI(Settings → Config)或貼到對話框新增以下設定:
"channels": {
"whatsapp": {
"selfChatMode": true,
"dmPolicy": "allowlist",
"allowFrom": ["+15551234567"]
}
}
將 +15551234567 替換為您的 WhatsApp 電話號碼(含國碼)。儲存後重新啟動服務。
步驟 2:連結 WhatsApp
openclaw channels login建立 LINE Messaging API 頻道:
將憑證加入 Zeabur:
LINE_CHANNEL_ACCESS_TOKEN 並填入您的 Channel access tokenLINE_CHANNEL_SECRET 並填入您的 Channel secret"plugins": { "entries": { "line": { "enabled": true } } }設定 Webhook:
https://<your-domain>/line/webhookhttps://<your-domain>/line/webhook配對您的 LINE 帳號:
JN4MSY23)openclaw pairing approve line <配對碼>openclaw pairing approve line <配對碼>Approved line sender <user-id>. 表示配對成功如需設定其他通訊平台(Discord、Slack 等),請參閱 Channels 文件。
確認模型是否正常運作:
zeabur-ai/glm-4.7-flashanthropic/claude-opus-4-6(需要 API 金鑰)切換本次對話的模型(透過聊天指令):
/models - 查看可用模型/model <model-id> - 僅在本次對話中切換模型(不影響其他對話)修改所有新對話的預設模型(透過 Web UI Settings):
gemini-2.5-flash-lite、gpt-5-nano)。當模型無法使用時,可用 /new 開啟新對話,自動切回預設模型。新增 AI 供應商(透過 Web UI Settings 或環境變數):
修改 Zeabur AI Hub 模型(透過 Zeabur 控制台):
/opt/openclaw/providers/zeabur-ai-hub.json5,然後重新啟動服務(變更會在啟動時同步)/home/node/.openclaw/openclaw.json,將以下內容加入 models.providers.zeabur-ai.models 陣列:{ "id": "gpt-5.2", "name": "GPT-5.2", "reasoning": false, "input": ["text", "image"], "cost": { "input": 1.75, "output": 14, "cacheRead": 0.18, "cacheWrite": 0 }, "contextWindow": 400000, "maxTokens": 8192 },
{ "id": "gpt-5.1", "name": "GPT-5.1", "reasoning": false, "input": ["text", "image"], "cost": { "input": 1.25, "output": 10, "cacheRead": 0.13, "cacheWrite": 0 }, "contextWindow": 400000, "maxTokens": 8192 },
{ "id": "gpt-5-nano", "name": "GPT-5 Nano", "reasoning": false, "input": ["text", "image"], "cost": { "input": 0.05, "output": 0.4, "cacheRead": 0.01, "cacheWrite": 0 }, "contextWindow": 400000, "maxTokens": 8192 },
{ "id": "glm-4.7", "name": "GLM-4.7", "reasoning": false, "input": ["text", "image"], "cost": { "input": 0.4, "output": 1.9, "cacheRead": 0.08, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 8192 },
{ "id": "glm-4.7-flash", "name": "GLM-4.7 Flash", "reasoning": false, "input": ["text", "image"], "cost": { "input": 0.06, "output": 0.4, "cacheRead": 0, "cacheWrite": 0 }, "contextWindow": 204800, "maxTokens": 8192 },
{ "id": "kimi-k2.5", "name": "Kimi K2.5", "reasoning": false, "input": ["text"], "cost": { "input": 0.45, "output": 2.25, "cacheRead": 0.07, "cacheWrite": 0 }, "contextWindow": 131072, "maxTokens": 8192 }
Web UI 是用於設定、監控與聊天的管理工具 — 訊息平台(Telegram、WhatsApp、Discord 等)不需要 Web UI 也能獨立運作。如果你只使用不需要 inbound webhook 的平台(Telegram、WhatsApp、Discord、Signal、iMessage),可以在 Zeabur 控制台的網路頁籤移除網域綁定,避免將 Gateway 暴露在公網上。所有管理操作也可以在 Zeabur 的指令終端透過 CLI 完成(openclaw config set、openclaw models set 等)。若需在不綁定公網網域的情況下存取 Web UI,請參考 Tailscale 私有網路存取。也可以在變數頁籤將 OPENCLAW_GATEWAY_BIND 設為 loopback(設定後重新啟動服務),進一步限制 Gateway 只接受本地連線。
需要公網網域(inbound webhook)的平台:LINE、Slack、Google Chat。
所有資料儲存在 /home/node:
/home/node/.openclaw - 設定、會話、裝置和憑證/home/node/.openclaw/workspace - 工作區和記憶檔案💡 建議: 在完成初始設定或進行重大設定變更後,建議先建立備份。
備份:
backup → 從檔案頁籤的 /home/node 下載(例如 backup-1430.tar.gz)
cd /home/node && tar -czvf backup.tar.gz .openclaw還原:
/home/node 資料夾restore <備份檔名> --strip 2(例如 restore data-2026-02-27.zip --strip 2)restore <備份檔名>(例如 restore backup-1430.tar.gz)cd /home/node && tar -xzvf <備份檔名>/home/node 中已上傳的備份檔,釋放磁碟空間⚠️ 還原會覆蓋新服務上現有的設定和資料。記得也要將相關的環境變數(如 TELEGRAM_BOT_TOKEN)設定回去。Channel 的備份還原目前只測試過 Telegram 和 WhatsApp 可以成功還原。
預設啟動指令:
/opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh
當 Gateway 停止時,服務網址會顯示輔助頁面,包含錯誤資訊與修復步驟:
/home/node/.openclaw/openclaw.json)並修正問題如果您的部署沒有輔助頁面,請依照以下步驟操作:
sleep 3600,然後點擊重新啟動 — 這樣容器會持續運行,方便您編輯檔案/home/node/.openclaw/openclaw.json)並修正問題/opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh,然後點擊重新啟動💡 如需啟用輔助頁面,請重新部署此模板。
ghcr.io/openclaw/openclaw,標籤:從目前版本(例如 2026.2.26)改為新版本(例如 2026.3.7)⚠️ 避免使用
latest作為標籤 — 它會在每次重啟時拉取最新版本,可能引入破壞性變更或無法預期的錯誤。建議固定使用特定版本號以確保穩定性。
💡 啟動腳本會在每次開機時自動遷移設定 — 若缺少新設定(如
trustedProxies、dangerouslyDisableDeviceAuth)會自動補上。既有設定不會被覆蓋。
表示 Web UI 尚未與 Gateway Token 配對。修復方式:
Gateway Token 可在 Zeabur Dashboard 的說明頁籤或環境變數(OPENCLAW_GATEWAY_TOKEN)中找到。
表示您的裝置(瀏覽器/應用程式)尚未與 Gateway 完成配對。配對方式:
openclaw devices list — 查看待配對的請求,找到 requestIdopenclaw devices approve <requestId> — 核准該裝置升級映像檔至 2026.2.23 或更新版本後,若未更新設定檔會出現此錯誤。修復方式:編輯 /home/node/.openclaw/openclaw.json,在 gateway.controlUi 下加入 "dangerouslyAllowHostHeaderOriginFallback": true:
{
"gateway": {
"controlUi": {
"dangerouslyAllowHostHeaderOriginFallback": true
}
}
}
然後重新啟動服務。從此模板新部署的服務已自動包含此設定。
⚠️ 此功能僅適用於全新部署。舊版部署不包含 Tailscale 啟動腳本,請重新部署模板才能使用此功能。
除了使用公開網域,您也可以透過 Tailscale 讓 OpenClaw 僅在您的私有網路(tailnet)中存取,無需暴露到公網。
前置需求:
步驟 1:設定環境變數 在 Zeabur 控制台的環境變數頁籤新增:
TS_AUTHKEY(必填):您的 Tailscale Auth Key(tskey-auth-xxx)。前往 Tailscale Admin Console → Keys 建立。未設定此變數時,Tailscale 設定會被完全跳過。TS_HOSTNAME(選填):在 tailnet 上的機器名稱,決定您的存取網址(https://<TS_HOSTNAME>.<tailnet>.ts.net)。未設定時預設為 openclaw。步驟 2:切換啟動指令 前往設定 → 啟動指令,改為:
/opt/openclaw/startup.sh && /opt/openclaw/start_gateway_tailscale.sh
重新啟動服務。
步驟 3:在本機安裝 Tailscale 在您要存取 OpenClaw 的裝置上安裝 Tailscale(macOS、Windows、iOS、Android、Linux),並使用建立 Auth Key 時的同一個 Tailscale 帳號登入。
步驟 4:首次登入 Web UI 啟動完成後,在瀏覽器開啟(需在同一個 tailnet 的裝置上):
https://<TS_HOSTNAME>.<您的tailnet>.ts.net
您的 tailnet DNS 名稱可在 Tailscale 管理控制台 → DNS 查詢,完整網址也可在 Zeabur 控制台的服務紀錄中確認。
使用以下任一方式登入:
https://<TS_HOSTNAME>.<您的tailnet>.ts.net?token=<GATEWAY_TOKEN>Gateway Token 可在 Zeabur 控制台的使用說明頁籤或環境變數中找到(OPENCLAW_GATEWAY_TOKEN)。
步驟 5:連接 OpenClaw app(選用,以 macOS 為例)
wss://<TS_HOSTNAME>.<您的tailnet>.ts.netiOS 和 Android 的設定請參閱官方文件。
切換回公開網域模式:
將啟動指令改回 /opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh 並重新啟動即可。
此模板針對 Zeabur 雲端環境預先配置了以下設定:
gateway.trustedProxies:設為 ["10.0.0.0/8", "172.16.0.0/12"],讓 Gateway 能正確辨識 Zeabur 反向代理後的用戶端 IP。未設定時,Web UI 可能會出現「device identity required」錯誤。dangerouslyDisableDeviceAuth:停用 Web UI 裝置配對(裝置配對是為區域網路設計的功能,雲端部署改用 Gateway Token 驗證)。/usr/local/bin 符號連結:openclaw、backup、restore 指令已建立符號連結至 /usr/local/bin,可直接在 Zeabur 的命令終端中使用。OPENCLAW_DISABLE_BONJOUR=1:停用 mDNS/Bonjour,因為 Zeabur 容器主機名稱可能超過 63 bytes 的 DNS 標籤限制。mDNS 僅用於區域網路發現,雲端環境中不需要。OPENCLAW_TELEGRAM_DISABLE_AUTO_SELECT_FAMILY=true:修復容器環境中的 Telegram 連線問題(2026.2.17 及之後的映像檔版本需要)。2026/3/8
2026.3.7 — context engine plugin 介面、ACP 持久頻道綁定、Telegram 主題 agent 路由、Docker 多階段建置、gateway SecretRef 支援,橫跨 5 個版本(2026.3.3–2026.3.7)共 30+ 新功能及 40+ 修復gateway.auth.token 和 gateway.auth.password 時,須明確設定 gateway.auth.mode — 模板已預設 mode: "token"(既有部署啟動時自動遷移)gemini-3.1-pro-preview、gemini-3.1-flash-lite-preview、gemini-3.1-flash-image-preview、kimi-2.5gateway.auth.mode: "token"(防禦未來 gateway 驗證變更)--port 參數(port 自動透過環境變數/設定檔/預設值解析)2026/3/4
2026.3.2 — PDF 工具、Ollama 嵌入、Telegram 串流預設改為 partial、容器健康檢查端點(/healthz)、OpenAI WebSocket 優先傳輸,橫跨 3 個版本(2026.3.1、2026.3.2)共 200+ 修復及 20+ 安全強化api.registerHttpHandler(...) 的 plugin 須遷移至 api.registerHttpRoute(...),Zalouser 頻道須重新登入(openclaw channels login --channel zalouser)2026/3/2
claude-opus-4-6、minimax-m2.5、step-3.5-flashllama-3.3-70b → llama-3.1-8b、qwen-3-32 → qwen-3-235bZEABUR_AI_HUB_API_KEY 後重啟即可生效(移除 envsubst,改為 runtime 解析 ${VAR})/opt 同步 — 模板模型更新和 Configs 編輯重啟後即生效OPENCLAW_GATEWAY_BIND=loopback 指引2026/2/27
dangerouslyDisableDeviceAuth — 雲端部署改用 Gateway Token 驗證,取代裝置配對zeabur-ai/glm-4.7-flash,備援鏈(grok-4-fast-non-reasoning → minimax-m2.5 → kimi-k2.5 → qwen-3-235b → gpt-5-mini)2026.2.26 — Telegram DM allowlist 繼承修復、容器 temp dir 權限修復、非 root Docker 中 CLI gateway --force 修復、Gemini model ID 正規化,及額外安全強化2026/2/26
2026.2.25 — 跨 2026.2.23→2026.2.25 共 100+ 安全修復、新 provider(Kilo Gateway、Mistral、Volcano Engine)、heartbeat directPolicy 設定、gateway WebSocket 驗證強化、跨頻道路由隔離、Discord 語音 DAVE 可靠性、Telegram webhook 卡住修復,及大量穩定性改善2026/2/24
2026.2.23 — 包含 30+ 安全修復、新 provider(Kilo Gateway、Mistral、Volcano Engine)、統一頻道串流設定、多語言停止詞、所有頻道的 reasoning/thinking 過濾,及大量穩定性改善dangerouslyAllowHostHeaderOriginFallback — 2026.2.23 起非 loopback 部署必須設定2026/2/22
rescue.sh)— 已由輔助頁面取代2026/2/20
2026.2.19 — 新增 OPENCLAW_TELEGRAM_DISABLE_AUTO_SELECT_FAMILY=true 環境變數以修復 Telegram 連線問題(2026.2.17 及之後的版本需要)2026/2/16
latest,以跟上快速的安全性修正2026/2/15
start_gateway_tailscale.sh,透過 tailnet 私有 HTTPS 存取,無需暴露到公網2026.2.142026/2/10
/v1/chat/completions API,預設模型改為 gemini-2.5-flash-imagegpt-oss-120b、llama-3.3-70b、qwen-3-32 HTTP 500:加入 supportsStore: false 相容性設定gpt-oss-120b reasoning 標記(設為 true).zip 格式(Zeabur 備份服務)TELEGRAM_BOT_TOKEN、DISCORD_BOT_TOKEN、SLACK_BOT_TOKEN、SLACK_APP_TOKEN、LINE_CHANNEL_ACCESS_TOKEN、LINE_CHANNEL_SECRET)同步寫入設定檔2026/2/7
2026/2/4
backup 和 restore 全域指令2026/2/2
Zeabur