跳转到内容
OpenClaw Docs

Render

使用基础架构即代码在 Render 上部署 OpenClaw。包含的 render.yaml Blueprint 以声明方式定义了您的整个堆栈、服务、磁盘、环境变量，因此您只需单击一下即可部署，并将您的基础架构与代码一起进行版本控制。

先决条件

Section titled “先决条件”

使用 Render Blueprint 部署

Section titled “使用 Render Blueprint 部署”

部署到 Render

点击此链接将：

  1. 根据此仓库根目录的 render.yaml Blueprint 创建一个新的 Render 服务。
  2. 构建 Docker 镜像并部署

部署后，您的服务 URL 遵循 https://<service-name>.onrender.com 模式。

了解 Blueprint

Section titled “了解 Blueprint”

Render Blueprint 是定义您的基础架构的 YAML 文件。此仓库中的 render.yaml 配置了运行 OpenClaw 所需的一切：

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 # auto-generates a secure token
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1

使用的主要 Blueprint 功能：

功能用途
runtime: docker从仓库的 Dockerfile 构建
healthCheckPathRender 监控 /health 并重启不正常的实例
generateValue: true自动生成加密的安全值
disk在重新部署后仍然存在的持久存储

选择计划

Section titled “选择计划”
计划休眠磁盘最适合
免费空闲 15 分钟后不可用测试、演示
入门版从不1GB+个人使用、小型团队
标准版及以上从不1GB+生产环境、多个频道

Blueprint 默认为 starter。要使用免费层级，请在您 fork 仓库的 render.yaml 中更改 plan: free（但请注意：没有持久磁盘意味着每次部署时配置都会重置）。

部署后

Section titled “部署后”

访问控制 UI

Section titled “访问控制 UI”

Web 控制面板可在 https://<your-service>.onrender.com/ 访问。

使用部署期间自动生成的 OPENCLAW_GATEWAY_TOKEN 值进行连接（在 Dashboard → 您的服务 → Environment 中找到它）。

Render 控制面板功能

Section titled “Render 控制面板功能”

日志

Section titled “日志”

在 Dashboard → 您的服务 → Logs 中查看实时日志。按以下条件筛选：

  • 构建日志（Docker 镜像创建）
  • 部署日志（服务启动）
  • 运行时日志（应用程序输出）

Shell 访问

Section titled “Shell 访问”

要进行调试，请通过 Dashboard → 您的服务 → Shell 打开 shell 会话。持久磁盘挂载在 /data。

环境变量

Section titled “环境变量”

在 Dashboard → 您的服务 → Environment 中修改变量。更改会触发自动重新部署。

自动部署

Section titled “自动部署”

如果您使用原始的 OpenClaw 仓库，Render 将不会自动部署您的 OpenClaw。要更新它，请从仪表板运行手动 Blueprint 同步。

自定义域名

Section titled “自定义域名”
  1. 转到 Dashboard → your service → Settings → Custom Domains
  2. 添加您的域名
  3. 按照说明配置 DNS（CNAME 到 *.onrender.com）
  4. Render 会自动配置 TLS 证书

扩缩容

Section titled “扩缩容”

Render 支持水平和垂直扩缩容：

  • 垂直：更改计划以获取更多 CPU/RAM
  • 水平：增加实例数量（Standard 计划及以上）

对于 OpenClaw，通常垂直扩缩容就足够了。水平扩缩容需要粘性会话或外部状态管理。

备份和迁移

Section titled “备份和迁移”

您可以随时使用 Render 仪表板中的 Shell 访问权限导出配置和工作区：

Terminal window
openclaw backup create

这将创建一个可移植的备份归档文件，您可以在任何 OpenClaw 主机上还原。有关详细信息，请参阅 Backup。

故障排除

Section titled “故障排除”

服务无法启动

Section titled “服务无法启动”

检查 Render 仪表板中的部署日志。常见问题：

  • 缺少 OPENCLAW_GATEWAY_TOKEN — 验证是否已在 Dashboard → Environment 中设置
  • 端口不匹配 — 确保设置了 OPENCLAW_GATEWAY_PORT=8080，以便网关绑定到 Render 期望的端口

冷启动缓慢（免费层级）

Section titled “冷启动缓慢（免费层级）”

免费层级的服务在闲置 15 分钟后会休眠。休眠后的第一个请求在容器启动时需要几秒钟时间。升级到 Starter 计划可实现始终在线。

重新部署后数据丢失

Section titled “重新部署后数据丢失”

这种情况发生在免费层级上（无持久磁盘）。升级到付费计划，或者 通过 Render shell 中的 openclaw backup create 定期导出您的配置。

健康检查失败

Section titled “健康检查失败”

Render 期望在 30 秒内从 /health 收到 200 响应。如果构建成功但部署失败，则服务启动时间可能过长。请检查：

  • 构建日志中的错误
  • 容器是否可以使用 docker build && docker run 在本地运行

后续步骤

Section titled “后续步骤”