跳转到主要内容
使用基础设施即代码在 Render 上部署 OpenClaw。随附的 render.yaml Blueprint 以声明式方式定义完整堆栈（服务、磁盘、环境变量），你可以一键部署，并将基础设施与代码一起版本化。

​
前置条件

​
使用 Render Blueprint 部署

Deploy to Render 点击该链接会：
  1. 使用本仓库根目录的 render.yaml Blueprint 创建一个新的 Render 服务。
  2. 提示你设置 SETUP_PASSWORD
  3. 构建 Docker 镜像并部署
部署完成后，服务 URL 形如 https://<service-name>.onrender.com。

​
理解 Blueprint

Render Blueprints 是定义基础设施的 YAML 文件。本仓库的 render.yaml 配置了运行 OpenClaw 所需的一切： 
services:
  - type: web
    name: openclaw
    runtime: docker
    plan: starter
    healthCheckPath: /health
    envVars:
      - key: PORT
        value: "8080"
      - key: SETUP_PASSWORD
        sync: false          # 部署时提示输入
      - key: OPENCLAW_STATE_DIR
        value: /data/.openclaw
      - key: OPENCLAW_WORKSPACE_DIR
        value: /data/workspace
      - key: OPENCLAW_GATEWAY_TOKEN
        generateValue: true  # 自动生成安全 token
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1
使用的 Blueprint 关键特性：
功能目的
runtime: docker从仓库的 Dockerfile 构建
healthCheckPathRender 监控 /health，不健康则重启
sync: false部署时提示输入（机密）
generateValue: true自动生成加密安全的值
disk持久化存储，部署后仍保留

​
选择套餐

套餐休眠磁盘适用
Free空闲 15 分钟后休眠不可用测试、演示
Starter永不休眠1GB+个人使用、小团队
Standard+永不休眠1GB+生产、多频道
Blueprint 默认 starter。若使用免费档，在你的 fork 的 render.yaml 中将 plan: starter 改为 plan: free（注意：无持久磁盘意味着每次部署都会重置配置）。

​
部署后

​
完成设置向导

  1. 访问 https://<your-service>.onrender.com/setup
  2. 输入 SETUP_PASSWORD
  3. 选择模型提供商并粘贴 API key
  4. （可选）配置聊天频道（Telegram、Discord、Slack）
  5. 点击 Run setup

​
访问 Control UI

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

​
Render 控制台功能

​
Logs

在 Dashboard → your service → Logs 查看实时日志。可按以下过滤：
  • Build logs（Docker 镜像构建）
  • Deploy logs（服务启动）
  • Runtime logs（应用输出）

​
Shell 访问

调试时在 Dashboard → your service → Shell 打开 shell 会话。持久化磁盘挂载在 /data。

​
环境变量

在 Dashboard → your service → Environment 修改变量。变更会触发自动 redeploy。

​
自动部署

如果你使用原始 OpenClaw 仓库，Render 不会自动部署你的 OpenClaw。要更新，请在 dashboard 执行一次手动 Blueprint sync。

​
自定义域名

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

​
扩展性

Render 支持横向与纵向扩展：
  • 纵向：更换套餐以获得更多 CPU/RAM
  • 横向：增加实例数（Standard 及以上）
对 OpenClaw 来说，通常纵向扩展即可。横向扩展需要 sticky session 或外部状态管理。

​
备份与迁移

随时导出配置与工作区： 
https://<your-service>.onrender.com/setup/export
这会下载一个可移植备份，可在任何 OpenClaw 主机上恢复。

​
故障排查

​
服务无法启动

查看 Render Dashboard 的部署日志。常见问题：
  • 缺少 SETUP_PASSWORD — Blueprint 会提示，但请确认已设置
  • 端口不匹配 — 确保 PORT=8080 与 Dockerfile 暴露端口一致

​
冷启动慢（免费档）

免费档服务会在 15 分钟空闲后休眠。休眠后首次请求需要几秒钟启动容器。升级到 Starter 以保持常驻。

​
重新部署后数据丢失

这发生在免费档（无持久磁盘）。升级到付费套餐，或定期通过 /setup/export 导出配置。

​
健康检查失败

Render 期望 /health 在 30 秒内返回 200。若构建成功但部署失败，可能是服务启动太慢。检查：
  • Build logs 是否有错误
  • 容器能否在本地运行 docker build && docker run