render.yaml Blueprint，将 OpenClaw 部署到 Render。它在一个文件中声明服务、磁盘和环境变量。
前提条件
部署
部署到 Render 这会根据render.yaml 创建 Render 服务、构建 Docker 镜像并进行部署。你的服务 URL 遵循 https://<service-name>.onrender.com 格式。
Blueprint
选择套餐
Blueprint 默认为
starter。若要使用免费套餐，请在你复刻仓库的 render.yaml 中更改 plan: free。请注意，由于没有持久化磁盘，每次部署时 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 部署，而非从自己的复刻仓库部署，则没有推送权限来触发重新部署。因此，请从 Dashboard 手动运行 Blueprint 同步进行更新，或将服务指向你自己的复刻仓库。
自定义域名
- Dashboard → your service → Settings → Custom Domains
- 添加你的域名
- 按照说明配置 DNS（将 CNAME 指向
*.onrender.com） - Render 会自动配置 TLS 证书
扩缩容
- 垂直扩缩容：更改套餐以获得更多 CPU/RAM。对于 OpenClaw 通常已足够。
- 水平扩缩容：增加实例数量（Standard 套餐及更高版本）。由于 OpenClaw 将运行时状态保存在本地磁盘上，因此需要粘性会话或外部状态管理。
备份和迁移
随时可以从 Render Dashboard 的 Shell 导出状态、配置、身份验证配置文件和工作区：故障排查
服务无法启动
检查 Render Dashboard 中的部署日志。常见问题：- 缺少
OPENCLAW_GATEWAY_TOKEN— 确认已在 Dashboard → Environment 中设置 - 端口不匹配 — 确保
OPENCLAW_GATEWAY_PORT=8080，使 Gateway 网关绑定到 Render 预期的端口
冷启动缓慢（免费套餐）
免费套餐的服务会在空闲 15 分钟后停机；停机后的第一个请求需要等待几秒钟以启动容器。升级到 Starter 即可保持服务始终在线。重新部署后数据丢失
这会发生在免费套餐中（没有持久化磁盘）。请升级到付费套餐，或定期在 Render Shell 中使用openclaw backup create 导出备份。
健康检查失败
如果构建成功但部署失败，可能是服务启动耗时过长，或者无法访问/health。请检查：
- 构建日志中是否有错误
- 容器能否在本地通过
docker build && docker run运行
后续步骤
- 设置消息渠道：渠道
- 配置 Gateway 网关：Gateway 配置
- 让 OpenClaw 保持最新：更新