OpenClaw 🦞

OpenClaw 🦞（原 Clawdbot、Moltbot）是一个个人 AI 助手，可在本地运行并通过 WebSocket Gateway 架构连接多个消息平台。

⚠️ 本模板使用 ghcr.io/openclaw/openclaw:2026.9.7。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 等支持的通讯频道使用）
LLM API 密钥	否	您的 OpenAI 兼容供应商 API 密钥（OpenAI、Anthropic 兼容网关、OpenRouter 等）。若连同下方两个字段一起填入，模板会配置一个 `custom` 供应商，并将您的模型设为主模型。留空则可稍后通过 Control UI 或 `openclaw` CLI 选择模型／供应商。
LLM Base URL	否	OpenAI 兼容端点，例如 `https://api.openai.com/v1`。
LLM 模型	否	要使用的主要模型 id，例如 `gpt-4o-mini`。

建议资源配置

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

功能扩充

浏览器：如需浏览器功能（网页浏览、截图等），请部署 Browser 模板
Devbox：如需多语言程序执行（Python、Go、Rust、C/C++），请将 Devbox 模板部署到同一个项目

使用方式

部署完成后，从网络页签打开服务网址。在登录页面粘贴 Gateway Token（可在使用说明页签或环境变量 → OPENCLAW_GATEWAY_TOKEN 中找到），点击 Connect。首次连接时每个浏览器会显示 “Approve this browser”，并附上类似 openclaw devices approve <requestId> 的一次性指令。请打开 Zeabur 仪表板的 Command，执行画面上那条指令 —— 该页面随后会自动连上。此为每个浏览器一次性的步骤。
设置 AI 模型（二选一）：
- 部署时设置：若已填入 LLM_API_KEY、LLM_BASE_URL 与 LLM_MODEL，模板会配置一个 custom OpenAI 兼容供应商，并将您的模型设为主模型 — 直接前往步骤 3。
- 稍后设置：若留空，服务仍会正常部署。之后通过 Control UI Settings 或 openclaw CLI 添加供应商与模型，再在聊天中用 /model <id> 切换模型。详情请见：https://docs.openclaw.ai/providers
前往 Chat 页面测试 AI 模型是否正常运作
（可选）设置 Telegram、WhatsApp 等通讯平台

AI 模型设置请参阅官方文档。

模型切换与 Failover

OpenClaw 支持一个主模型加上可选的 failover 模型，当主模型不可用时会自动切换。部署时填入 LLM 变量，主模型会设为 custom/<你的模型>；之后可随时添加供应商与备援模型。

可通过 Control UI Chat 或 Zeabur 控制台的命令管理模型。

通过 Control UI Chat — 在对话框直接输入 slash command：

/model custom/<你的模型> — 切换主模型
/model — 查看当前模型
/models — 列出模型供应商
/models <provider> — 列出指定供应商的模型（例如 /models custom）

通过命令（Zeabur 控制台）— 在终端执行相同命令：

openclaw models set custom/<你的模型>
openclaw models status
openclaw models list --all
openclaw models fallbacks list
openclaw models fallbacks add <provider>/<model>
openclaw models fallbacks remove <provider>/<model>
openclaw models fallbacks clear

或直接编辑配置文件（~/.openclaw/config.json5）：

"agents": {
  "defaults": {
    "model": {
      "primary": "custom/<你的模型>",
      "fallbacks": ["anthropic/claude-sonnet-4-6", "openai/gpt-4o-mini"]
    }
  }
}

编辑配置文件后需重新启动服务。

添加外部模型供应商

您可以添加任何 OpenAI 兼容或原生支持的供应商，例如 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 模型设置

确认模型是否正常运作：

首次启动时，若你已填入 LLM_API_KEY／LLM_BASE_URL／LLM_MODEL，本模板会将 custom/<你的模型> 写入为默认模型：
- 有填 LLM 变量 → 开箱即用
- 没有填 → 尚未配置任何模型；请通过 Control UI 或 openclaw CLI 添加供应商与模型
打开 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

添加或编辑自定义供应商的模型（通过配置文件）：

通过文件页签或 Control UI Settings 编辑 /home/node/.openclaw/openclaw.json，然后重新启动服务。在 models.providers.custom.models 数组中加入更多项：

{ "id": "gpt-4o", "name": "gpt-4o", "input": ["text", "image"], "contextWindow": 128000, "maxTokens": 8192 },
{ "id": "gpt-4o-mini", "name": "gpt-4o-mini", "input": ["text", "image"], "contextWindow": 128000, "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）会自动补上。既有设置不会被覆盖。

"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 (自镜像 2026.9.7 起已退役)：此标志过去用于停用 Control UI 设备配对，现已失效并会被 openclaw doctor --fix 移除。改为每个浏览器需一次性设备配对 —— 详见使用方式步骤 1,用 openclaw devices approve 批准该浏览器。
/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/9/30

⚠️ 升级镜像至 2026.9.7 — 升级前请先备份。跨多个版本升级会在首次启动时迁移磁盘数据库；2026.9.7 会在迁移前自动备份所有 state/agent 数据库并可于 rollback 还原,但仍请自行备份 —— 日后若要降级仍需要升级前的备份。
⚠️ 破坏性变更（Control UI）：dangerouslyDisableDeviceAuth 已退役且失效。首次打开 Control UI 的浏览器现在会显示 “Approve this browser” 并需要一次性批准 —— 在 Command 终端执行画面上显示的 openclaw devices approve <requestId>,该页面随后会自动连上。
上游新增旗舰模型：Anthropic Fable 5.1、OpenAI GPT-6 Astra、完整 GPT-5.6 系列。另新增自动更新开关（OPENCLAW_NO_AUTO_UPDATE=1）、移除 checkpoint restore，并包含自 2026.5.28 以来 100+ 项频道/provider/安全性修复。

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