本教程基于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部署的各类服务。
二、选购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二级域名的租用(联系mail@6tot.com).获取你专属的域名(如 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回复,说明模型配置正常,即可开始使用。
七、可选功能配置
- 通讯平台对接(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扫描生成的二维码,连接完成即可使用。
- 功能扩充
- 浏览器功能:如需网页浏览、截图等能力,请在同一个项目中部署「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