跳转到内容
OpenClaw Docs

Render

Render

Section titled “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 Blueprints 是定义基础设施的 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（但请注意：没有持久磁盘意味着 OpenClaw 状态 在每次部署时都会重置）。

部署后

Section titled “部署后”

访问控制 UI

Section titled “访问控制 UI”

Web 仪表板位于 https://<your-service>.onrender.com/。

使用配置的共享密钥进行连接。此部署模板会自动生成 OPENCLAW_GATEWAY_TOKEN（在 Dashboard → your service → Environment 中查找）；如果您将其替换为密码认证，请改为使用该密码。

Render 仪表板功能

Section titled “Render 仪表板功能”

日志

Section titled “日志”

在 Dashboard → your service → Logs 中查看实时日志。按以下方式筛选：

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

Shell 访问

Section titled “Shell 访问”

为了进行调试，请通过 Dashboard → your service → Shell 打开一个 shell 会话。持久化磁盘挂载在 /data。

环境变量

Section titled “环境变量”

在 Dashboard → your service → 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 状态以及任何已配置工作区的可移植备份存档。有关详细信息，请参阅 备份。

故障排除

Section titled “故障排除”

服务无法启动

Section titled “服务无法启动”

检查 Render 控制台中的部署日志。常见问题：

  • 缺少 OPENCLAW_GATEWAY_TOKEN — 请验证它是否已在 控制台 → 环境 中设置
  • 端口不匹配 — 确保 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 “后续步骤”