render.yaml Blueprint 在 Render 上部署 OpenClaw。它会在一个文件中声明服务、磁盘和环境变量。
前提条件
部署
部署到 Render 这会根据render.yaml 创建一个 Render 服务，构建 Docker 镜像并进行部署。你的服务 URL 形式如下：https://<service-name>.onrender.com。
蓝图
选择套餐
Blueprint 默认为
starter。要使用免费套餐，请在你 fork 的 render.yaml 中将 plan: free 更改为 plan: free —— 请注意，由于没有持久磁盘，OpenClaw 状态会在每次部署时重置。
部署之后
访问控制界面
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。
自定义域名
- Dashboard → your service → Settings → Custom Domains
- 添加你的域名
- 按照说明配置 DNS（CNAME 指向
*.onrender.com） - Render 会自动签发 TLS 证书
扩展
- 垂直扩展：为方案增加更多 CPU/RAM。通常对 OpenClaw 来说已经足够。
- 水平扩展：增加实例数量（标准方案及以上）。由于 OpenClaw 会将运行时状态保存在本地磁盘上，因此需要粘性会话或外部状态管理。
备份和迁移
从 Render Dashboard shell 中，您可以随时导出状态、配置、身份验证配置文件和工作区：故障排查
服务无法启动
检查 Render 仪表板中的部署日志。常见问题包括：- 缺少
OPENCLAW_GATEWAY_TOKEN— 请确认它已在 Dashboard → Environment 中设置 - 端口不匹配 — 确保
OPENCLAW_GATEWAY_PORT=8080，以便网关绑定到 Render 期望的端口
冷启动缓慢（免费套餐）
免费套餐服务在 15 分钟无活动后会进入休眠；休眠后第一次请求在容器启动期间会延迟几秒。升级到 Starter 可实现始终在线。重新部署后数据丢失
这会发生在免费套餐上（没有持久化磁盘）。请升级到付费方案，或者定期从 Render shell 使用openclaw backup create 导出备份。
健康检查失败
如果构建成功但部署失败，则服务可能需要较长时间才能启动，或者可能无法访问/startupz。请检查：
- 构建日志中是否有错误
- 容器是否可在本地使用
docker build && docker run正常运行