logo

quickActions

icon

OpenClaw 🦞 with view bot

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

template cover
部署次數10 次
發布者hadtinfo
建立於2026-03-26
模板內的服務
service icon
最低配置2 Cores4 GB
推薦配置4 Cores8 GB
標籤
AIAssistantChatbotWhatsAppTelegramSlackDiscord

OpenClaw 🦞

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

⚠️ 本模板使用 ghcr.io/openclaw/openclaw:2026.3.24。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 金鑰否可留空跳過。若跳過，預設模型為 anthropic/claude-opus-4-6（需自行設定 API Key）。填入後可使用 Gemini、GPT、Claude、DeepSeek。之後可在服務的「環境變數」分頁新增。

建議資源配置

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

功能擴充

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

使用方式

  1. 部署完成後，從網路頁籤開啟服務網址。在登入頁面貼上 Gateway Token（可在使用說明頁籤或環境變數 → OPENCLAW_GATEWAY_TOKEN 中找到），點擊 Connect
  2. 設定 AI 模型（二擇一）：
    • Zeabur AI Hub（預設模型：glm-4.7-flash）：若部署時已輸入 API Key，直接前往步驟 3。也可之後在 Zeabur 控制台的變數頁籤新增 ZEABUR_AI_HUB_API_KEY（新增後記得重新啟動服務）。
    • 其他供應商（Anthropic、OpenAI 等）：若未輸入 Zeabur AI Hub API Key，預設模型為 anthropic/claude-opus-4-6。前往 Control UI Settings 或環境變數新增 API 金鑰。詳情請見：https://docs.openclaw.ai/providers/anthropic
  3. 前往 Chat 頁面測試 AI 模型是否正常運作
  4. （選擇性）設定 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-6
  • 指令：openclaw 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-..." }
  }
}

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

Telegram 機器人設定

從 BotFather 取得 Token：

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

將 Token 加入 Zeabur：

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

配對您的 Telegram 帳號：

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

WhatsApp 設定

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

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

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

步驟 2：連結 WhatsApp

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

LINE 機器人設定

建立 LINE Messaging API 頻道：

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

將憑證加入 Zeabur：

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

設定 Webhook：

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

配對您的 LINE 帳號：

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

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

AI 模型設定

確認模型是否正常運作：

  1. 預設模型取決於部署方式：
    • 有填 Zeabur AI Hub API Key → 預設模型：zeabur-ai/glm-4.7-flash
    • 沒有填 → 預設模型：anthropic/claude-opus-4-6（需要 API 金鑰）
  2. 開啟 Chat 頁面，發送一則測試訊息
  3. 如果收到回覆 → 模型正常運作
  4. 如果出現錯誤 → 確認 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 或環境變數）：

修改 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

還原：

  1. 在檔案頁籤將備份檔上傳到 /home/node 資料夾
  2. 開啟指令執行：
    • 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 <備份檔名>
  3. 在檔案頁籤刪除 /home/node 中已上傳的備份檔，釋放磁碟空間
  4. 重新啟動服務

⚠️ 還原會覆蓋新服務上現有的設定和資料。記得也要將相關的環境變數（如 TELEGRAM_BOT_TOKEN）設定回去。Channel 的備份還原目前只測試過 Telegram 和 WhatsApp 可以成功還原。

疑難排解

預設啟動指令：/opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh

全新部署（有輔助頁面）

當 Gateway 停止時，服務網址會顯示輔助頁面，包含錯誤資訊與修復步驟：

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

舊版部署（無輔助頁面）

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

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

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

更新 OpenClaw 版本

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

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

  1. 到紀錄頁籤確認 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 完成配對。配對方式：

  1. 開啟 Control UI 並完成 Gateway Token 認證（參見上方說明）
  2. 在 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 為例）

  1. 在 Mac 上安裝 OpenClaw for macOS 和 Tailscale
  2. 開啟 OpenClaw app → Settings → General → 選擇 Remote 模式
  3. Transport 選擇 Direct (ws/wss)
  4. Gateway URL 填入 wss://<TS_HOSTNAME>.<您的tailnet>.ts.net
  5. 裝置首次連線時需要配對核准 — 在 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。

文件

更新日誌

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 或環境變數設定）