
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