Render

使用 Infrastructure as Code 在 Render 上部署 OpenClaw。项目内置的 render.yaml Blueprint 以声明式方式定义整个技术栈——服务、磁盘、环境变量——让你一键部署并将基础设施纳入版本管理。

前提条件

• 一个 Render 账号（有免费套餐）
• 你选择的 模型提供商 的 API Key

通过 Render Blueprint 部署

Deploy to Render

点击此链接将：

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

部署完成后，服务 URL 格式为 https://<service-name>.onrender.com。

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 # 自动生成安全令牌
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1

主要 Blueprint 特性说明：

特性	用途
runtime: docker	从仓库的 Dockerfile 构建
healthCheckPath	Render 监控 /health，自动重启不健康实例
generateValue: true	自动生成加密安全的值
disk	持久化存储，在重新部署后保留

套餐选择

套餐	休眠	磁盘	适用场景
Free	闲置 15 分钟后	不可用	测试、演示
Starter	不休眠	1GB+	个人使用、小团队
Standard+	不休眠	1GB+	生产环境、多渠道

Blueprint 默认使用 starter。使用免费套餐时，在你 fork 的仓库的 render.yaml 中改为 plan: free（注意：无持久磁盘意味着每次部署后配置会重置）。

部署后

访问 Control UI

Web 控制台地址：https://<your-service>.onrender.com/

使用部署时自动生成的 OPENCLAW_GATEWAY_TOKEN 连接（在 Dashboard → 你的服务 → Environment 中查看）。

Render Dashboard 功能

日志

在 Dashboard → 你的服务 → Logs 查看实时日志，可按以下类型筛选：

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

Shell 访问

调试时通过 Dashboard → 你的服务 → Shell 打开 Shell 会话。持久磁盘挂载于 /data。

环境变量

在 Dashboard → 你的服务 → Environment 修改变量，变更后自动触发重新部署。

自动部署

如果你使用原始的 OpenClaw 仓库，Render 不会自动部署更新。需要更新时，在 Dashboard 手动执行 Blueprint 同步。

自定义域名

1. 前往 Dashboard → 你的服务 → Settings → Custom Domains
2. 添加你的域名
3. 按指引配置 DNS（CNAME 指向 *.onrender.com）
4. Render 自动颁发 TLS 证书

扩容

Render 支持横向和纵向扩容：

• 纵向：升级套餐获得更多 CPU/内存
• 横向：增加实例数量（Standard 及以上套餐）

对于 OpenClaw，纵向扩容通常已足够。横向扩容需要粘性会话或外部状态管理。