本教程基于Zeabur官方最新OpenClaw模板（版本2026.3.13-1）编写，全程零复杂配置，一键部署，搭配专属优惠码可享10%折扣，同时提供稳定专属的域名方案，开箱即用。

一、前置准备与平台导航

1. 注册登录：打开Zeabur官网 https://zeabur.com ，使用GitHub账号或邮箱完成注册登录，全程无需科学上网。
2. 专属折扣优惠：在平台购买专用服务器、充值AI Hub额度时，结账页面输入推荐码 maoyiren，即可直接享受10%专属折扣，原价2美元/月的服务器折后仅需1.6美元/月。
3. 平台核心导航入口（快速定位对应功能）：

• 快捷操作栏（quickActions）：控制台、设置、账单、退出
• 核心功能栏：专用服务器、AI Hub、模板
• 资源板块：文档、博客、更新日志、价格
• 社区板块：Forum、Discord、X、Threads
  4. 域名使用重要提示：平台自带的免费  *.zeabur.app  二级域名存在明确的安全与稳定性风险，不推荐长期正式使用。如需稳定、专属、低风险的访问地址，可直接租用 6tot.com 二级域名（示例： openclaw.6tot.com ），无需自行注册顶级域名、无需繁琐备案流程，即开即用，完美适配Zeabur部署的各类服务。

⚠️ 重要提醒：OpenClaw官方模板必须在Zeabur专用服务器上运行，不支持共享集群部署，请务必先完成服务器选购。

1. 登录Zeabur控制台后，点击左侧核心功能栏的「专用服务器」，进入服务器选购页面。
2. 配置选择：

• 厂商与节点：推荐选择「腾讯云」新加坡节点，网络稳定延迟低
• 配置规格：最低配置 2 vCPU + 4 GB RAM，建议配置 4 vCPU + 8 GB RAM，可满足多模型、多频道同时运行的需求
• 对应特惠配置：2 vCPU + 4 GB RAM 配置原价仅2美元/月，折后1.6美元/月
  3. 点击「立即购买」，进入订单结账页面，在优惠码输入框填写 maoyiren，点击应用，即可看到价格自动折扣为1.6美元/月。
  4. 完成支付后，等待1-3分钟，服务器将自动完成初始化并绑定到你的Zeabur账号，无需手动配置服务器环境。

三、一键部署OpenClaw官方最新模板

OpenClaw 项目介绍

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

部署前重要注意事项

⚠️ 本模板使用  ghcr.io/openclaw/openclaw:2026.3.13-1 。OpenClaw 🦞 正在快速开发中，可能存在尚未发现的 bug。更改版本后也无法确保稳定性。
⚠️ 如果遇到任何问题，欢迎到 GitHub issues 寻找解决方案或回报新问题。Zeabur 平台相关问题请联系 Zeabur 支持。
⚠️ 此模板需要在 Zeabur 上使用专用服务器，无法在共享集群上运行。
⚠️ 本模板已预先配置好可直接使用，不需要运行  openclaw onboard 。如果运行了，需要自行修改对应的设置。请参考官方文档。

部署步骤

1. 回到Zeabur控制台首页，点击「新建项目」，创建一个专属项目（名称可自定义，如openclaw-ai）。
2. 进入项目后，点击「添加服务」，选择「模板市场」，在搜索框中输入「OpenClaw」，即可找到Zeabur官方提供的OpenClaw部署模板。
3. 点击模板进入部署页面，部署目标选择刚才购买的专用服务器，点击「下一步」。
4. 填写部署变量（核心配置，必填项不可空缺）：
变量名 必填 详细说明
域名 是 用来访问 OpenClaw 的子域名前缀（例如填写  my-openclaw ，最终访问地址为  my-openclaw.zeabur.app ；若使用自定义6tot.com域名，填写完整域名如  openclaw.6tot.com ）。切换为 loopback 模式后可移除。
启用 Control UI 是 默认填写  true  — 通过公开域名启用 Control UI 网页控制台；若填写  false  — 仅绑定本地回环，无公开网页访问（更安全，配合 Tailscale 或 Telegram 等支持的通讯频道使用）
Zeabur AI Hub API 密钥 否 可留空跳过。若跳过，默认模型为  anthropic/claude-opus-4-6 （需自行设置 API Key）。填入后可直接使用 Gemini、GPT、Claude、DeepSeek 等主流模型。之后可在服务的「变量」页签新增或修改。
5. 确认配置无误后，点击「部署」，等待2-5分钟，平台将自动完成镜像拉取、环境配置、服务启动，无需任何手动操作。

四、域名配置

重要提醒：免费 *.zeabur.app 域名的核心风险

平台免费提供的  *.zeabur.app  二级域名，仅适合临时测试使用，长期使用存在以下不可忽视的问题：

1. 安全与风控风险：该根域名下有海量未知用户部署的服务，极易出现个别违规服务导致整个根域名被墙、被浏览器标记为不安全站点、被各大平台风控拦截，你的服务会被连带影响，出现无法访问、打不开的情况。

方案1：推荐 6tot.com 专属二级域名租用（长期稳定首选）

无需你自行注册、续费顶级域名，无需繁琐的备案流程，低门槛即可拥有专属的二级域名，完美适配OpenClaw等AI服务，是长期使用的最优选择。

1. 核心优势

• 专属独立二级域名，不和海量未知服务共用根域名，彻底规避连带风控、域名被墙的风险，访问稳定不中断。
• 无需自行注册顶级域名，省去每年的域名续费成本，无需处理备案相关的繁琐流程，即开即用。
• 全量支持HTTPS自动签发、CNAME一键绑定，完美兼容Zeabur的部署配置，和顶级域名使用体验完全一致。
• 可自定义专属前缀，比如  openclaw.6tot.com 、 ai-agent.6tot.com  等，打造专属的服务访问地址，便于记忆与推广。
  2. 绑定部署步骤
• 先完成6tot.com二级域名的租用(联系[email protected]）.获取你专属的域名（如  openclaw.6tot.com ）。
• 部署时在「域名」变量处直接填写完整的专属二级域名（如  openclaw.6tot.com ）。
• 部署完成后，进入Zeabur控制台的OpenClaw服务页面，切换到「网络」页签，页面会自动生成对应的CNAME解析记录值
• 联系添加对应的记录值
• 解析生效后，Zeabur会自动为域名签发免费SSL证书，全程无需手动操作，即可通过你的专属域名安全访问OpenClaw服务。

方案2：免费 *.zeabur.app 二级域名（仅临时测试使用）

仅适合临时测试体验，不推荐长期正式使用，配置步骤如下：

1. 部署时在「域名」变量处填写你想要的域名前缀（如  test-openclaw ），平台会自动生成对应的  test-openclaw.zeabur.app  免费域名。
2. 部署完成后，平台会自动完成SSL证书配置与解析，即可临时访问使用。

五、AI模型配置（Zeabur AI Hub + 外部供应商全支持）

部署完成后，可通过以下两种方式配置AI模型，满足不同使用需求。

方案1：Zeabur AI Hub（开箱即用，推荐首选）

Zeabur AI Hub 集成了主流大模型，无需单独注册各大平台账号，充值即可使用，搭配专属优惠码可享10%折扣。

1. 充值与API Key获取：

• 点击Zeabur核心功能栏的「AI Hub」，进入额度充值页面，选择你需要的充值档位，结账时输入推荐码 maoyiren 享受10%折扣。
• 充值完成后，在AI Hub页面创建一个API Key，复制生成的密钥。
  2. 配置到OpenClaw：
• 进入Zeabur控制台的OpenClaw服务页面，切换到「变量」页签，添加环境变量  ZEABUR_AI_HUB_API_KEY ，值填写刚才复制的API Key。
• 点击保存，服务会自动重启加载配置，默认模型自动设置为  zeabur-ai/glm-4.7-flash 。
  3. 模型切换与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快速切换：在对话框直接输入斜杠命令
•  /model zeabur-ai/glm-4.7-flash  — 切换当前对话主模型
•  /model  — 查看当前使用的模型
•  /models  — 列出所有可用的模型供应商
•  /models zeabur-ai  — 列出Zeabur AI Hub下的所有可用模型
• 通过Zeabur终端命令管理：在控制台打开服务终端，执行对应命令
  bash

五、基础配置

设置主模型

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  文件，添加以下配置，编辑完成后重启服务生效
  json

{
“agents”: {
“defaults”: {
“model”: {
“primary”: “zeabur-ai/glm-4.7-flash”,
“fallbacks”: [“zeabur-ai/grok-4-fast-non-reasoning”, “zeabur-ai/minimax-m2.5”]
}
}
}
}
 

方案2：添加外部模型供应商（Anthropic/OpenAI/Google等）

除了Zeabur AI Hub，你还可以添加各大主流AI供应商的模型，以下以Anthropic（Claude）为例，其他供应商配置逻辑一致。

官方配置说明：https://docs.openclaw.ai/providers/anthropic

Option A：Anthropic API Key（标准API访问，按用量计费，推荐）

适合有Anthropic API账号的用户，支持Prompt缓存功能，可大幅降低高频使用成本。

1. 前往Anthropic Console创建你的API Key。
2. 配置方法（三选一）：

• 方法1：环境变量配置（最简单）
  进入Zeabur控制台的OpenClaw服务「变量」页签，添加环境变量  ANTHROPIC_API_KEY ，值填写你的Anthropic API Key，添加后重启服务生效。
• 方法2：交互式命令配置
  在Zeabur控制台打开服务终端，执行以下命令，按照提示粘贴API Key完成配置：
  bash

交互式配置

openclaw onboard

选择：Anthropic API key

非交互式一键配置

openclaw onboard –anthropic-api-key “你的API Key”
 

• 方法3：配置文件配置
  编辑  ~/.openclaw/config.json5  文件，添加以下配置，保存后重启服务生效：
  json

{
“env”: { “ANTHROPIC_API_KEY”: “sk-ant-…” },
“agents”: {
“defaults”: {
“model”: { “primary”: “anthropic/claude-opus-4-6” }
}
}
}
 
3. Prompt缓存功能配置（Anthropic API专属）
OpenClaw原生支持Anthropic的Prompt缓存功能，可大幅降低长上下文、重复提示词的使用成本，默认开启5分钟短缓存。

• 缓存配置参数：
  参数值 缓存时长 说明
   none  无缓存 关闭Prompt缓存
   short  5分钟 API Key认证默认配置
   long  1小时 延长缓存（需开启beta标识）
• 配置示例：
  json

{
“agents”: {
“defaults”: {
“models”: {
“anthropic/claude-opus-4-6”: {
“params”: { “cacheRetention”: “long” }
}
}
}
}
}
 

Option B：Claude setup-token（使用Claude订阅额度）

适合已有Claude官方订阅的用户，可直接使用订阅内的额度，无需单独充值API。

1. setup-token获取：通过Claude Code CLI生成，执行命令  claude setup-token  即可获取。
2. 配置方法：

• 交互式配置：在Zeabur控制台打开服务终端，执行以下命令，按照提示粘贴setup-token完成配置：
  bash

openclaw models auth setup-token –provider anthropic

若在其他设备生成token，使用此命令粘贴

openclaw models auth paste-token –provider anthropic
 

• 配置文件示例：
  json

{
“agents”: {
“defaults”: {
“model”: { “primary”: “anthropic/claude-opus-4-6” }
}
}
}
 
3. 常见问题：若出现“OAuth token refresh failed”报错，重新生成setup-token并再次执行配置命令即可。

其他供应商配置

• OpenAI：添加环境变量  OPENAI_API_KEY  即可使用GPT系列模型
• Google Gemini：添加环境变量  GOOGLE_API_KEY  即可使用Gemini系列模型
• 所有支持的供应商请参阅OpenClaw官方文档：https://docs.openclaw.ai/providers

六、访问与初始化登录

1. 部署完成后，进入Zeabur控制台的OpenClaw服务「网络」页签，点击你的服务网址，打开OpenClaw登录页面。
2. 获取Gateway Token：进入服务的「使用说明」页签，或在「变量」页签找到  OPENCLAW_GATEWAY_TOKEN  变量，复制对应的Token值。
3. 在登录页面粘贴Gateway Token，点击「Connect」，即可进入OpenClaw Control UI控制台。
4. 前往「Chat」页面，发送一条测试消息，若收到AI回复，说明模型配置正常，即可开始使用。

七、可选功能配置

1. 通讯平台对接（Telegram/WhatsApp/Discord等）

OpenClaw支持对接多个主流消息平台，实现随时随地通过聊天软件使用AI助手，以下为常用平台配置方法。

Telegram 机器人配置

1. 获取Bot Token：打开Telegram，搜索 @BotFather，发送  /newbot  按照提示创建机器人，获取BotFather生成的Token。
2. 配置到OpenClaw：进入Zeabur控制台的OpenClaw服务「变量」页签，添加环境变量  TELEGRAM_BOT_TOKEN ，值填写你的机器人Token，添加后重启服务。
3. 配对账号：在Telegram向你的机器人发送  /start ，机器人会回复配对码；在OpenClaw网页Chat对话框输入  openclaw pairing approve telegram <配对码> ，提示配对成功即可开始使用。

WhatsApp 配置

1. 配置频道规则：在OpenClaw Control UI的「Settings → Config」中添加以下配置，将电话号码替换为你的WhatsApp号码（含国码），保存后重启服务：
json

{
“channels”: {
“whatsapp”: {
“selfChatMode”: true,
“dmPolicy”: “allowlist”,
“allowFrom”: [“+15551234567”]
}
}
}
 
2. 登录连接：在Zeabur控制台打开服务终端，执行  openclaw channels login ，使用手机WhatsApp扫描生成的二维码，连接完成即可使用。

2. 功能扩充

• 浏览器功能：如需网页浏览、截图等能力，请在同一个项目中部署「Browser」模板，部署完成后OpenClaw会自动识别并启用相关能力。
• 多语言代码执行：如需支持Python、Go、Rust、C/C++等多语言程序执行，请在同一个项目中部署「Devbox」模板，即可实现代码运行能力。

八、数据备份与还原

💡 建议：在完成初始设置或进行重大配置变更后，建议先创建备份，避免数据丢失。
OpenClaw所有数据均存储在  /home/node  目录下，包括配置、会话、凭证、工作区文件等。

备份方法

1. 方法一：Zeabur备份服务（推荐）：使用Zeabur内置的备份功能，一键完成全量备份，详情可参阅Zeabur官方备份文档。
2. 方法二：手动备份：在Zeabur控制台打开服务终端，执行  backup  命令，系统会自动生成备份文件；进入「文件」页签，在  /home/node  目录下下载生成的  backup-xxx.tar.gz  备份文件即可。

还原方法

1. 在「文件」页签将备份文件上传到  /home/node  文件夹。
2. 打开服务终端，执行对应还原命令：

• Zeabur备份服务生成的文件： restore <备份文件名> –strip 2 
• 手动备份生成的文件： restore <备份文件名> 
  3. 还原完成后，重新启动服务即可恢复所有配置与数据。

九、疑难排解

1. 配置文件改坏导致服务无法启动？使用救援模式：

• 前往服务「设置 → 启动命令」，修改为  /opt/openclaw/rescue.sh 
• 前往「设置 → 健康检查」，关闭健康检查（救援模式不会响应健康检查）
• 重新启动服务，容器会正常运行但不启动OpenClaw，此时可进入文件浏览器修复配置文件，或执行  openclaw doctor –fix  自动修复错误配置
• 修复完成后，将启动命令改回  /opt/openclaw/startup.sh && /opt/openclaw/start_gateway.sh ，重新开启健康检查并重启服务即可
  2. 健康检查报错  Startup probe failed: dial tcp … connect: connection refused ？
• 服务启动需要一定时间，尤其是首次部署，先等待3-5分钟
• 若错误持续，确认服务器配置是否满足最低要求（2 vCPU / 4 GB RAM），建议升级配置
• 暂时关闭健康检查，避免服务进入重启循环，查看服务日志找出具体错误原因
  3. 模型报错401、token无效？
• 确认API Key/setup-token是否正确，是否有对应模型的访问权限
• Claude订阅的setup-token可能过期，重新生成token并再次配置即可
• 执行  openclaw models status  查看认证状态，确认配置是否生效

官方参考文档

• Zeabur OpenClaw模板官方教程：https://zeabur.com/zh-CN/templates/VTZ4FX
• OpenClaw官方文档：https://docs.openclaw.ai
• OpenClaw GitHub仓库：https://github.com/openclaw/openclaw