本页内容
本页内容
托管
Render
使用仓库中的 render.yaml Blueprint 在 Render 上部署 OpenClaw。它会在一个文件中声明服务、磁盘和环境变量。
先决条件
部署
这会根据 render.yaml 创建一个 Render 服务,构建 Docker 镜像并进行部署。你的服务 URL 形式如下:https://<service-name>.onrender.com。
蓝图
| 功能 | 用途 |
|---|---|
runtime: docker |
从仓库的 Dockerfile 构建 |
healthCheckPath |
/startupz 报告启动完成后,Render 才会接收流量 |
generateValue: true |
自动生成一个经过加密安全处理的值 |
disk |
在重新部署后仍然保留的持久化存储 |
选择套餐
| 计划 | 休眠 | 磁盘 | 最适合 |
|---|---|---|---|
| 自由的 | 空闲 15 分钟后 | 不可用 | 测试、演示 |
| 起动机 | 永不休眠 | 1GB+ | 个人使用、小团队 |
| 标准+ | 永不休眠 | 1GB+ | 生产环境、多渠道 |
蓝图默认为 starter。要使用免费套餐,请更改 plan: free 并删除分叉 render.yaml 中的 disk: 块; Render 拒绝将永久性磁盘附加到空闲实例的蓝图。如果没有该磁盘,OpenClaw 状态会在每次部署时重置。
部署之后
访问Control UI
Web 仪表板可通过 https://<your-service>.onrender.com/ 访问。使用共享密钥连接:自动生成的 OPENCLAW_GATEWAY_TOKEN(在 Dashboard → your service → Environment 中查找),或者如果你切换到了密码认证,则使用你的密码。
日志
Dashboard → your service → Logs 显示构建日志(Docker 镜像创建)、部署日志(服务启动)以及运行时日志(应用输出)。
Shell 访问
Dashboard → your service → Shell 会打开一个 shell 会话。持久化磁盘挂载在 /data。
环境变量
在 Dashboard → your service → Environment 中编辑变量。更改会触发自动重新部署。
自动部署
当已连接仓库的分支有新提交时,Render 会自动重新部署。如果你是直接从 openclaw/openclaw 部署,而不是从你自己的 fork 部署,那么你没有推送权限来触发这一过程,因此请通过 Dashboard 手动同步 Blueprint,或者将服务指向你自己的 fork。
自定义域名
- 仪表板→您的服务→设置→自定义域
- 添加你的域名
- 按照说明配置 DNS(CNAME 指向
*.onrender.com) - Render 会自动签发 TLS 证书
扩展
- Vertical:更改更多的计划 CPU/RAM. 通常足够用于 OpenClaw。
- 水平扩展:增加实例数量(标准方案及以上)。由于 OpenClaw 会将运行时状态保存在本地磁盘上,因此需要粘性会话或外部状态管理。
备份和迁移
从 Render Dashboard shell 中,您可以随时导出状态、配置、身份验证配置文件和工作区:
恢复验证并提取到新的暂存目录中;激活是一个单独的离线步骤。有关回滚警告和激活顺序,请参阅 恢复完整存档 。
故障排查
服务无法启动
检查 Render 仪表板中的部署日志。常见问题包括:
- 缺少
OPENCLAW_GATEWAY_TOKEN— 请确认它已在 Dashboard → Environment 中设置 - Port 不匹配 — 设置
OPENCLAW_GATEWAY_PORT=8080,以便网关绑定到 Render 期望的端口
冷启动缓慢(免费套餐)
免费套餐服务在 15 分钟无活动后会进入休眠;休眠后第一次请求在容器启动期间会延迟几秒。升级到 Starter 可实现始终在线。
重新部署后数据丢失
这会发生在免费套餐上(没有持久化磁盘)。请升级到付费方案,或者定期从 Render shell 使用 openclaw backup create 导出备份。
健康检查失败
如果构建成功但部署失败,则服务可能需要较长时间才能启动,或者可能无法访问 /startupz。请检查:
- 构建日志中是否有错误
- 容器是否使用相同的镜像和命令在本地运行 Render 使用
从存储库签出本地复制 Render 容器:
令牌是必需的,而不是可选的:在容器中,网关选择自动绑定模式,并且它拒绝绑定没有共享密钥的非环回地址。 --allow-unconfigured 放弃了配置先决条件,而不是那个守卫。 Render 提供蓝图 generateValue: true 中的值;一次性的在当地就可以了。
此处保留 OPENCLAW_STATE_DIR 和 OPENCLAW_WORKSPACE_DIR 未设置。 Render 将它们设置为其已安装磁盘上的路径,但映像仅准备其自己的 node- 拥有的目录并以该用户身份运行,因此当网关创建其锁定目录时,将它们指向未安装的 /data 会失败。状态落在图像的默认值下,并与容器一起丢弃,这就是您想要进行健康检查复制的内容。
有关完整的本地容器工作流程,请参阅 Docker。