OpenClaw 🦞

OpenClaw 🦞（原 Clawdbot、Moltbot）是一個個人 AI 助手，可在本地運行並透過 WebSocket Gateway 架構連接多個訊息平台。

⚠️ 本模板使用 ghcr.io/openclaw/openclaw:2026.5.28。OpenClaw 🦞 正在快速開發中，可能存在尚未發現的 bug。更改版本後也無法確保穩定性。

⚠️ 如果遇到任何問題，歡迎到 GitHub issues 尋找解決方案或回報新問題。Zeabur 平台相關問題請聯繫 Zeabur 支援。

⚠️ 此模板需要在 Zeabur 上使用專用伺服器，無法在共享叢集上運行。

⚠️ 本模板已預先設定好可直接使用，不需要執行 openclaw onboard。如果執行了，需要自行修改對應的設定。請參考官方文件。

部署變數

部署時需填寫以下變數：

變數	必填	說明
網域	是	用來存取 OpenClaw 的子網域（例如 `my-openclaw` → `my-openclaw.zeabur.app`）。切換為 loopback 模式後可移除。
啟用 Control UI	是	`true`（預設）— 透過公開網域啟用 Control UI。`false` — 僅綁定本地迴路，無公開網頁存取（較安全，搭配 Tailscale 或 Tailscale 或 Telegram 等支援的通訊頻道使用）
Zeabur AI Hub API 金鑰	否	可留空跳過。本模板預設模型為 `zeabur-ai/glm-4.7-flash`（便宜、快速），需要此金鑰才能運作 — 若未填入，需自行切換模型並提供其他供應商（Anthropic、OpenAI 等）的 API Key。之後可在服務的「環境變數」分頁新增。

建議資源配置

最低配置：2 vCPU / 4 GB RAM
建議配置：4 vCPU / 8 GB RAM

功能擴充

瀏覽器：如需瀏覽器功能（網頁瀏覽、截圖等），請部署 Browser 模板
Devbox：如需多語言程式執行（Python、Go、Rust、C/C++），請將 Devbox 模板部署到同一個專案

使用方式

部署完成後，從網路頁籤開啟服務網址。在登入頁面貼上 Gateway Token（可在使用說明頁籤或環境變數 → OPENCLAW_GATEWAY_TOKEN 中找到），點擊 Connect
設定 AI 模型（二擇一）：
- Zeabur AI Hub（預設模型：glm-4.7-flash）：若部署時已輸入 API Key，直接前往步驟 3。也可之後在 Zeabur 控制台的變數頁籤新增 ZEABUR_AI_HUB_API_KEY（新增後記得重新啟動服務）。
- 其他供應商（Anthropic、OpenAI 等）：模板預設仍是 zeabur-ai/glm-4.7-flash。要改用其他供應商，請透過環境變數新增該供應商的 API Key,接著在聊天中用 /model <id> 或透過 Control UI Settings 切換模型。詳情請見：https://docs.openclaw.ai/providers/anthropic
前往 Chat 頁面測試 AI 模型是否正常運作
（選擇性）設定 Telegram、WhatsApp 等通訊平台

AI 模型設定請參閱官方文件。

模型切換與 Failover

此模板內建 failover 模型，當主模型不可用時會自動切換。預設鏈：glm-4.7-flash → grok-4-fast-non-reasoning → minimax-m2.5 → kimi-k2.5 → qwen-3-235b → gpt-5-mini。

可透過 Control UI Chat 或 Zeabur 控制台的指令管理模型。

透過 Control 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 模型

新增後重新啟動服務，然後切換模型：

Control UI Chat：/model anthropic/claude-opus-4-7
指令：openclaw models set anthropic/claude-opus-4-7

方法二：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-..." }
  }
}

所有支援的供應商請參閱官方文件。

Telegram 機器人設定

從 BotFather 取得 Token：

開啟 Telegram 並搜尋 @BotFather
發送 /newbot 建立新機器人
依照提示設定機器人的名稱和使用者名稱
BotFather 會傳送 Token 給您（例如 123456789:ABCdefGHIjklMNOpqrsTUVwxyz）

將 Token 加入 Zeabur：

前往 Zeabur 控制台的服務環境變數頁籤
新增 TELEGRAM_BOT_TOKEN 並填入您的 Token
重新啟動服務
重啟後，請前往 Settings → Config 啟用 Telegram 外掛："plugins": { "entries": { "telegram": { "enabled": true } } }。如需停用，將 enabled 設為 false。

配對您的 Telegram 帳號：

在 Telegram 向您的機器人發送 /start
機器人會回覆配對碼（例如 JN4MSY23）
使用以下任一方式核准配對：
- 網頁 Chat：在 OpenClaw 網頁介面的對話框輸入 openclaw pairing approve telegram <配對碼>
- 終端機：在 Zeabur 控制台開啟指令進入容器終端，執行 openclaw pairing approve telegram <配對碼>
看到 Approved telegram sender <user-id>. 表示配對成功
現在可以開始與機器人對話了！

WhatsApp 設定

步驟 1：設定 WhatsApp 頻道 透過 OpenClaw Control UI（Settings → Config）或貼到對話框新增以下設定：

"channels": {
  "whatsapp": {
    "selfChatMode": true,
    "dmPolicy": "allowlist",
    "allowFrom": ["+15551234567"]
  }
}

將 +15551234567 替換為您的 WhatsApp 電話號碼（含國碼）。儲存後重新啟動服務。

步驟 2：連結 WhatsApp

在 Zeabur 控制台開啟指令進入容器終端
執行：openclaw channels login
會出現 QR Code - 使用您手機上的 WhatsApp 掃描
連結完成！現在您可以在 WhatsApp 中傳訊息給自己來與 OpenClaw 對話

LINE 機器人設定

建立 LINE Messaging API 頻道：

若尚未建立 LINE 官方帳號，請先建立一個
前往 LINE Developers Console
建立或選擇一個 Provider
建立新的 Messaging API 頻道，並連結您的 LINE 官方帳號
在 Messaging API 頁籤中，發行 Channel access token（長期有效）
在 Basic settings 頁籤中，複製 Channel secret

將憑證加入 Zeabur：

前往 Zeabur 控制台的服務環境變數頁籤
新增 LINE_CHANNEL_ACCESS_TOKEN 並填入您的 Channel access token
新增 LINE_CHANNEL_SECRET 並填入您的 Channel secret
重新啟動服務
重啟後，請前往 Settings → Config 啟用 LINE 外掛："plugins": { "entries": { "line": { "enabled": true } } }

設定 Webhook：

重啟後，您的 Webhook URL 為：https://<your-domain>/line/webhook
在 LINE Developers Console 中，前往頻道的 Messaging API 頁籤
將 Webhook URL 設為 https://<your-domain>/line/webhook
啟用 Use webhook
（建議）在 LINE 官方帳號管理後台關閉自動回應訊息和加入好友的歡迎訊息

配對您的 LINE 帳號：

在 LINE 上加機器人為好友並傳送任意訊息
機器人會回覆配對碼（例如 JN4MSY23）
使用以下任一方式核准配對：
- 網頁 Chat：在 OpenClaw 網頁介面的對話框輸入 openclaw pairing approve line <配對碼>
- 終端機：在 Zeabur 控制台開啟指令進入容器終端，執行 openclaw pairing approve line <配對碼>
看到 Approved line sender <user-id>. 表示配對成功
現在可以在 LINE 上與機器人對話了！

如需設定其他通訊平台（Discord、Slack 等），請參閱 Channels 文件。

AI 模型設定

確認模型是否正常運作：

本模板首次啟動時會將 zeabur-ai/glm-4.7-flash 寫入為預設模型：
- 有填 Zeabur AI Hub API Key → 開箱即用
- 沒有填 → 模型將無法回應；請加上 AI Hub 金鑰（建議）或切換模型並提供其他供應商的 API Key
開啟 Chat 頁面，發送一則測試訊息
如果收到回覆 → 模型正常運作
如果出現錯誤 → 確認 API 金鑰是否正確設定

切換本次對話的模型（透過聊天指令）：

/models - 查看可用模型
/model <model-id> - 僅在本次對話中切換模型（不影響其他對話）

修改所有新對話的預設模型（透過 Control UI Settings）：

前往 Settings → Agents → Default model
建議： 將低費用的模型設為預設（如 gemini-2.5-flash-lite、gpt-5-nano）。當模型無法使用時，可用 /new 開啟新對話，自動切回預設模型。

新增 AI 供應商（透過 Control UI Settings 或環境變數）：

新增其他 AI 供應商的 API 金鑰（如 Anthropic、OpenAI 等）
請見：https://docs.openclaw.ai/providers

修改 Zeabur AI Hub 模型（透過 Zeabur 控制台）：

前往設定 → 設定檔 → 編輯 /opt/openclaw/providers/zeabur-ai-hub.json5，然後重新啟動服務（變更會在啟動時同步）
舊版（沒有這些指令）：透過檔案頁籤或 Control UI Settings 編輯 /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 }

安全提示

Control UI 是用於設定、監控與聊天的管理工具 — 訊息平台（Telegram、WhatsApp、Discord 等）不需要 Control UI 也能獨立運作。如果你只使用不需要 inbound webhook 的平台（Telegram、WhatsApp、Discord、Signal、iMessage），可以在 Zeabur 控制台的網路頁籤移除網域綁定，避免將 Gateway 暴露在公網上。所有管理操作也可以在 Zeabur 的指令終端透過 CLI 完成（openclaw config set、openclaw models set 等）。若需在不綁定公網網域的情況下存取 Control UI，請參考 Tailscale 私有網路存取。也可以在變數頁籤將 OPENCLAW_GATEWAY_BIND 設為 loopback（設定後重新啟動服務），進一步限制 Gateway 只接受本地連線。

需要公網網域（inbound webhook）的平台：LINE、Slack、Google Chat。

資料持久化

所有資料儲存在 /home/node：

/home/node/.openclaw - 設定、會話、裝置和憑證
/home/node/.openclaw/workspace - 工作區和記憶檔案

備份與還原

💡 建議： 在完成初始設定或進行重大設定變更後，建議先建立備份。

備份：

方法一：Zeabur 備份服務（推薦） - 使用 Zeabur 內建的備份功能。請參閱 Zeabur 備份文件。
方法二：CLI 備份（v2026.3.8+） - 開啟指令 → 執行 openclaw backup create → 從檔案頁籤的 /home/node 下載
- 僅備份設定：openclaw backup create --only-config
- 排除工作區：openclaw backup create --no-include-workspace
- 驗證備份檔：openclaw backup verify <備份檔名>
- 範例：
```
$ openclaw backup create
Backup archive: /home/node/2026-03-09T15-08-31.114Z-openclaw-backup.tar.gz
Included 1 path:
- state: ~/.openclaw
Skipped 1 path:
- workspace: ~/.openclaw/workspace (covered by ~/.openclaw)
Created /home/node/2026-03-09T15-08-31.114Z-openclaw-backup.tar.gz
```
方法三：手動備份 - 開啟指令 → 執行 backup → 從檔案頁籤的 /home/node 下載（例如 backup-1430.tar.gz）
- 舊版（沒有這些指令）：cd /home/node && tar -czvf backup.tar.gz .openclaw

還原：

在檔案頁籤將備份檔上傳到 /home/node 資料夾
開啟指令執行：
- CLI 備份（v2026.3.8+）：restore <備份檔名>（自動偵測，例如 restore 2026-03-09T15-08-31.114Z-openclaw-backup.tar.gz）
- Zeabur 備份服務：restore <備份檔名>（自動偵測，例如 restore data-2026-02-27.zip）
- 手動備份的檔案：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 停止時，服務網址會顯示輔助頁面，包含錯誤資訊與修復步驟：

查看錯誤紀錄 — 輔助頁面會直接顯示最近的紀錄；完整紀錄請到 Zeabur Dashboard 的紀錄頁籤查看
修復設定檔 — 到 Zeabur Dashboard 的檔案頁籤，找到設定檔（/home/node/.openclaw/openclaw.json）並修正問題
在 Zeabur Dashboard 點擊重新啟動套用修正

舊版部署（無輔助頁面）

如果您的部署沒有輔助頁面，請依照以下步驟操作：

到 Zeabur Dashboard 的紀錄頁籤查看錯誤訊息
前往設定 → 指令，將啟動指令改為 sleep 3600，然後點擊重新啟動 — 這樣容器會持續運行，方便您編輯檔案
修復設定檔 — 到檔案頁籤，找到設定檔（/home/node/.openclaw/openclaw.json）並修正問題
將啟動指令改回 /opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh，然後點擊重新啟動

💡 如需啟用輔助頁面，請重新部署此模板。

更新 OpenClaw 版本

到 OpenClaw releases 查看最新版本
在 Zeabur Dashboard 前往設定 → 服務映像檔來源
映像檔：ghcr.io/openclaw/openclaw，標籤：從目前版本（例如 2026.2.26）改為新版本（例如 2026.3.7）
點擊重新啟動以套用更新

⚠️ 避免使用 latest 作為標籤 — 它會在每次重啟時拉取最新版本，可能引入破壞性變更或無法預期的錯誤。建議固定使用特定版本號以確保穩定性。

到紀錄頁籤確認 Gateway 正常啟動

💡 啟動腳本會在每次開機時自動遷移設定 — 若缺少新設定（如 trustedProxies、dangerouslyDisableDeviceAuth）會自動補上。既有設定不會被覆蓋。

"device identity required"

表示 Control UI 尚未通過 Gateway Token 驗證。修復方式：

開啟服務網址 — 登入頁面會自動出現。貼上 Gateway Token 並點擊 Connect。
Gateway Token 可在 Zeabur Dashboard 的使用說明頁籤或環境變數（OPENCLAW_GATEWAY_TOKEN）中找到。

Gateway Token 可在 Zeabur Dashboard 的說明頁籤或環境變數（OPENCLAW_GATEWAY_TOKEN）中找到。

"disconnected (1008): pairing required"

表示您的裝置（瀏覽器/應用程式）尚未與 Gateway 完成配對。配對方式：

開啟 Control UI 並完成 Gateway Token 認證（參見上方說明）
在 Zeabur 控制台開啟指令進入終端機，執行：
- openclaw devices list — 查看待配對的請求，找到 requestId
- openclaw devices approve <requestId> — 核准該裝置

"non-loopback Control UI requires gateway.controlUi.allowedOrigins"

升級映像檔至 2026.2.23 或更新版本後，若未更新設定檔會出現此錯誤。修復方式：編輯 /home/node/.openclaw/openclaw.json，在 gateway.controlUi 下加入 "dangerouslyAllowHostHeaderOriginFallback": true：

{
  "gateway": {
    "controlUi": {
      "dangerouslyAllowHostHeaderOriginFallback": true
    }
  }
}

然後重新啟動服務。從此模板新部署的服務已自動包含此設定。

Tailscale 私有網路存取（選用）

⚠️ 此功能僅適用於全新部署。舊版部署不包含 Tailscale 啟動腳本，請重新部署模板才能使用此功能。

除了使用公開網域，您也可以透過 Tailscale 讓 OpenClaw 僅在您的私有網路（tailnet）中存取，無需暴露到公網。

前置需求：

一個 Tailscale 帳號（免費方案即可）
在 Tailscale Admin Console 建立一組 Auth Key（建議勾選 Reusable + Ephemeral）

步驟 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：首次登入 Control UI 啟動完成後，在瀏覽器開啟（需在同一個 tailnet 的裝置上）：

https://<TS_HOSTNAME>.<您的tailnet>.ts.net

您的 tailnet DNS 名稱可在 Tailscale 管理控制台 → DNS 查詢，完整網址也可在 Zeabur 控制台的服務紀錄中確認。

使用以下任一方式登入：

在網址後加上 token：https://<TS_HOSTNAME>.<您的tailnet>.ts.net?token=<GATEWAY_TOKEN>
或在 Control UI 的 Overview 頁面輸入 Gateway Token

Gateway Token 可在 Zeabur 控制台的使用說明頁籤或環境變數中找到（OPENCLAW_GATEWAY_TOKEN）。

步驟 5：連接 OpenClaw app（選用，以 macOS 為例）

在 Mac 上安裝 OpenClaw for macOS 和 Tailscale
開啟 OpenClaw app → Settings → General → 選擇 Remote 模式
Transport 選擇 Direct (ws/wss)
Gateway URL 填入 wss://<TS_HOSTNAME>.<您的tailnet>.ts.net
裝置首次連線時需要配對核准 — 在 Control UI 的 Nodes 頁面點擊 approve

iOS 和 Android 的設定請參閱官方文件。

切換回公開網域模式： 將啟動指令改回 /opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh 並重新啟動即可。

Zeabur 專屬設定

此模板針對 Zeabur 雲端環境預先配置了以下設定：

gateway.trustedProxies：設為 ["10.0.0.0/8", "172.16.0.0/12"]，讓 Gateway 能正確辨識 Zeabur 反向代理後的用戶端 IP。未設定時，Control UI 可能會出現「device identity required」錯誤。
dangerouslyDisableDeviceAuth：停用 Control 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 及之後的映像檔版本需要）。
TZ（選填）：使用 IANA 時區字串設定容器時區（例如 Asia/Taipei、America/New_York、Europe/London）。透過 Zeabur 儀表板的環境變數頁籤新增。未設定時預設為 UTC。

文件

文件：https://docs.openclaw.ai
GitHub：https://github.com/openclaw/openclaw

更新日誌

2026/6/1

升級映像檔至 2026.5.28 — 修復 LINE 等需即時安裝的頻道外掛載入失敗問題（外掛 SDK 結構調整後，固定映像檔版本現已與自動安裝的頻道外掛版本相符）。同時新增 Claude Opus 4.8 支援、加密 PDF 解析、NVIDIA/MiniMax provider 更新，以及 100+ 安全性/頻道/agent 修復

2026/5/5

升級映像檔至 2026.5.20 — file-transfer plugin、Gateway 啟動效能優化、統一串流進度草稿、/steer 指令、Discord DM/狀態改善、WhatsApp Channel/Newsletter 支援、MS Teams 串流進度、Google Chat webhook 修復、LanceDB 記憶體修復、sandbox 分片，以及 100+ 頻道/plugin/provider 修復

2026/4/17

升級映像檔至 2026.4.15 — 預設 Anthropic 模型改為 Claude Opus 4.7、Gemini 文字轉語音支援、Control UI 新增 Model Auth 狀態卡片、LanceDB 雲端儲存支援、GitHub Copilot embedding provider、實驗性本地模型精簡預設，以及 50+ 安全/provider/頻道修復
新增 Zeabur AI Hub 模型支援：claude-opus-4-7、claude-sonnet-4-6、glm-5、gpt-5.4-pro
移除已下架模型：gemini-3-pro-preview、kimi-2.5

2026/4/6

升級映像檔至 2026.4.5 — 影片/音樂生成工具（video_generate、music_generate），支援 xAI/Runway/阿里 Wan/Google Lyria/MiniMax provider、ComfyUI workflow 插件、新增 Qwen/Fireworks AI/StepFun/Amazon Bedrock Mantle provider、Control UI 12 語言在地化、Memory Dreaming（實驗性背景記憶晉升）、prompt cache 穩定性改善、Claude CLI loopback MCP bridge、ACPX 內嵌 runtime、Control UI 內 ClawHub skill 安裝、結構化計畫進度事件、移除 legacy config alias（需執行 openclaw doctor --fix），以及 100+ 安全/頻道/provider 修復
⚠️ Breaking：已移除 legacy config alias（talk.voiceId、hooks.internal.handlers、channel allow 等）— 升級後請執行 openclaw doctor --fix

2026/4/1

升級映像檔至 2026.3.31 — 背景任務流程控制平面（SQLite 支援的任務帳本、openclaw flows CLI）、QQ Bot 內建頻道插件、Matrix 串流/代理/歷史/執行緒回覆、遠端 MCP HTTP/SSE 伺服器支援、LINE 外發媒體、Slack exec 審核路由、WhatsApp 表情符號回應、Pi/Codex 原生網頁搜尋、可設定的過載容錯切換，以及 60+ 修復涵蓋 Slack、Discord、Telegram、Docker、Control UI 及 plugin SDK

2026/3/27

升級映像檔至 2026.3.24 — Gateway OpenAI 相容 API 端點（/v1/models、/v1/embeddings）、Microsoft Teams SDK 遷移與串流回覆、影片生成基礎設施、gateway 頻道啟動隔離、Telegram 論壇主題與照片尺寸修復、Docker 全新安裝修復、sandbox 媒體分發安全強化，以及 60+ 修復涵蓋 WhatsApp、Discord、Slack、飛書及 plugin SDK

2026/3/23

升級映像檔至 2026.3.22 — gateway SIGTERM shutdown 強化、Telegram 回覆上下文與 topic 推播修復、memory 工具獨立註冊、provider runtime lazy boundary 修復、exec approvals / pairing / 網路探索安全強化

2026/3/15

升級映像檔至 2026.3.13-1 — 修復 plugin-sdk 記憶體暴增（解決 OOM 崩潰）、瀏覽器 session 強化、cron session 目標、50+ 修復涵蓋安全性、Telegram、Discord、Windows、macOS 及設定驗證
新增 ENABLE_CONTROL_UI 部署變數 — 控制 gateway 綁定模式（lan vs loopback）及 Control UI 存取；預設為 true
新增 NODE_OPTIONS=--max-old-space-size=2048 防止低記憶體伺服器 OOM
移除啟動腳本冗餘項目：HEARTBEAT.md 初始化、heartbeat 目標自動偵測、CLI wrapper、多餘的 export/權限設定、MEMORY.md 初始化（皆由 OpenClaw 原生處理）
Gateway 啟動指令從 node dist/index.js 改為內建的 openclaw 命令
改善部署變數說明，包含預設模型資訊及 6 種語言的本地化說明

2026/3/13

升級映像檔至 2026.3.12 — Control UI 儀表板 v2、GPT-5.4/Claude 快速模式、Ollama/vLLM/SGLang provider 外掛、K8s 部署文件、20+ 安全修復（WebSocket origin 驗證、exec approval 強化、plugin 自動載入鎖定）、cron delivery 收緊並需要 openclaw doctor --fix 遷移，共 60+ 新功能及 100+ 修復，涵蓋 4 個版本（2026.3.9–2026.3.12）
⚠️ 重大變更：cron delivery 已收緊 — 升級後請在指令中執行 openclaw doctor --fix 以遷移舊版 cron 儲存格式
新增 TZ 環境變數文件，用於容器時區設定
全部文件中「Web UI」正名為「Control UI」
移除啟動腳本中的頻道環境變數自動同步（頻道外掛改為透過 Settings 手動設定）
移除啟動腳本中的 gateway config 遷移（初始設定已包含所有必要欄位）
簡化登入流程：移除「Web UI (with token)」網址，改用 Control UI 登入頁面輸入 Gateway Token

2026/3/10

Add Homebrew pre-installation: touch /.dockerenv and Homebrew install script now run on every container startup, enabling brew package management inside the container
Add Go 1.22.3 pre-installation (persisted under /home/node/go)
Remove macOS software warning (Homebrew is now available)
Homebrew and Go are persisted on the mounted volume and skip re-installation on restart

2026/3/9

升級映像檔至 2026.3.8 — CLI 備份（openclaw backup create / openclaw backup verify）、Talk 模式靜音超時設定、Brave LLM-context 網頁搜尋、ACP 來源中繼資料、Telegram DM 去重、瀏覽器 CDP 修復、gateway 重啟/設定保護，共 30+ 新功能及 40+ 修復
備份文件新增 openclaw backup create 和 openclaw backup verify 說明（內建 CLI 備份，支援僅設定模式和備份檔驗證）

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"（既有部署啟動時自動遷移）
新增 Zeabur AI Hub 模型支援：gemini-3.1-pro-preview、gemini-3.1-flash-lite-preview、gemini-3.1-flash-image-preview、kimi-2.5
設定明確的 gateway.auth.mode: "token"（防禦未來 gateway 驗證變更）
移除 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

新增 Zeabur AI Hub 模型支援：claude-opus-4-6、minimax-m2.5、step-3.5-flash
替換模型：llama-3.3-70b → llama-3.1-8b、qwen-3-32 → qwen-3-235b
修復 API key 更換：變更 ZEABUR_AI_HUB_API_KEY 後重啟即可生效（移除 envsubst，改為 runtime 解析 ${VAR}）
Provider 設定檔每次啟動從 /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）
新增模型切換、備援及外部 provider 說明文件
清理環境變數（預設值移至啟動腳本）
自動遷移既有設定（trustedProxies、驗證設定）
升級映像檔至 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 過濾，及大量穩定性改善
Control UI 設定加入 dangerouslyAllowHostHeaderOriginFallback — 2026.2.23 起非 loopback 部署必須設定

2026/2/22

以自動重啟機制取代健康檢查：Gateway 崩潰時自動重啟，並顯示輔助頁面提供錯誤資訊與修復步驟，每 5 秒偵測服務是否恢復
移除救援模式（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

新增 Tailscale 私有網路存取：用戶可切換至 start_gateway_tailscale.sh，透過 tailnet 私有 HTTPS 存取，無需暴露到公網
映像檔升級至 2026.2.14

2026/2/10

修復生圖 skill：改用 /v1/chat/completions API，預設模型改為 gemini-2.5-flash-image
修復 gpt-oss-120b、llama-3.3-70b、qwen-3-32 HTTP 500：加入 supportsStore: false 相容性設定
修正 gpt-oss-120b reasoning 標記（設為 true）
還原腳本支援 .zip 格式（Zeabur 備份服務）

2026/2/7

修復 cron 排程無法主動送出通知：啟動時自動偵測已設定的頻道作為 heartbeat 投遞目標
新部署自動初始化 HEARTBEAT.md 含可執行內容（避免空檔導致 heartbeat 被跳過）

2026/2/4

使用 Zeabur configs 管理啟動腳本（更易維護）
新增 backup 和 restore 全域指令
新增自動重啟機制與 fallback 頁面，Gateway 崩潰時自動恢復
Zeabur AI Hub 新增 6 個模型：gpt-5.2, gpt-5.1, gpt-5-nano, glm-4.7, glm-4.7-flash, kimi-k2.5
Zeabur AI Hub 的 Claude 模型加入 store 相容性設定

2026/2/2

新增 AI 模型設定區塊（全域 vs 本次對話設定）
新增備份與還原區塊，支援 Zeabur 備份服務
新增初始設定完成後備份提醒
移除 Google Gemini CLI patch（上游已修復）
移除部署時的 ANTHROPIC_API_KEY 和 OPENAI_API_KEY 變數，避免 OpenClaw 偵測到空的 API Key 然後執行失敗（可之後透過 Control UI 或環境變數設定）

OpenClaw 🦞

模板內的服務

OpenClaw

OpenClaw 🦞

部署變數

建議資源配置

功能擴充

使用方式

模型切換與 Failover

新增外部模型供應商

Telegram 機器人設定

WhatsApp 設定

LINE 機器人設定

AI 模型設定

安全提示

資料持久化

備份與還原

疑難排解

全新部署（有輔助頁面）

舊版部署（無輔助頁面）

更新 OpenClaw 版本

"device identity required"

"disconnected (1008): pairing required"

"non-loopback Control UI requires gateway.controlUi.allowedOrigins"

Tailscale 私有網路存取（選用）

Zeabur 專屬設定

文件

更新日誌

模板內的服務

OpenClaw