OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

托管与部署

Render

使用仓库的 render.yaml Blueprint，将 OpenClaw 部署到 Render。它在一个文件中声明服务、磁盘和环境变量。

前提条件

部署

部署到 Render

这会根据 render.yaml 创建 Render 服务、构建 Docker 镜像并进行部署。你的服务 URL 遵循 https://<service-name>.onrender.com 格式。

Blueprint

yaml
services:  - type: web    name: openclaw    runtime: docker    plan: starter    healthCheckPath: /health    envVars:      - key: OPENCLAW_GATEWAY_PORT        value: "8080"      - key: OPENCLAW_STATE_DIR        value: /data/.openclaw      - key: OPENCLAW_WORKSPACE_DIR        value: /data/workspace      - key: OPENCLAW_GATEWAY_TOKEN        generateValue: true # 自动生成安全令牌    disk:      name: openclaw-data      mountPath: /data      sizeGB: 1
功能 用途
runtime: docker 使用仓库的 Dockerfile 构建
healthCheckPath Render 监控 /health 并重启运行状况异常的实例
generateValue: true 自动生成加密安全的值
disk 重新部署后仍然保留的持久化存储

选择套餐

套餐 停机 磁盘 最适合
Free 空闲 15 分钟后 不提供 测试、演示
Starter 从不 1GB+ 个人使用、小型团队
Standard+ 从不 1GB+ 生产环境、多个渠道

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 同步进行更新，或将服务指向你自己的复刻仓库。

自定义域名

  1. Dashboard → your service → Settings → Custom Domains
  2. 添加你的域名
  3. 按照说明配置 DNS（将 CNAME 指向 *.onrender.com）
  4. Render 会自动配置 TLS 证书

扩缩容

  • 垂直扩缩容：更改套餐以获得更多 CPU/RAM。对于 OpenClaw 通常已足够。
  • 水平扩缩容：增加实例数量（Standard 套餐及更高版本）。由于 OpenClaw 将运行时状态保存在本地磁盘上，因此需要粘性会话或外部状态管理。

备份和迁移

随时可以从 Render Dashboard 的 Shell 导出状态、配置、身份验证配置文件和工作区：

bash
openclaw backup create

这会创建可移植的备份归档。请参阅备份。

故障排查

服务无法启动

检查 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 运行

后续步骤

Was this useful?
On this page

On this page