Skip to main content
使用基础设施即代码（Infrastructure as Code）在 Render 上部署 OpenClaw。包含的 render.yaml Blueprint 以声明式方式定义了您的整个堆栈：服务、磁盘、环境变量，因此您可以单击一次即可部署，并且可以将基础设施与代码一起版本控制。

​
前提条件

​
使用 Render Blueprint 部署

部署到 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 # 自动生成安全令牌
    disk:
      name: openclaw-data
      mountPath: /data
      sizeGB: 1
重点 Blueprint 功能说明：
功能作用
runtime: docker从仓库的 Dockerfile 构建
healthCheckPathRender 监控 /health 路径，重启不健康的实例
sync: false部署时提示输入该值（用于密钥等）
generateValue: true自动生成密码学安全的值
disk持久化存储，重部署时数据不丢失

​
选择计划

计划自动关闭磁盘适用场景
免费空闲 15 分钟后自动关闭无测试、演示
Starter永不关闭1GB 以上个人使用，小团队
Standard+永不关闭1GB 以上生产环境，多渠道使用
Blueprint 默认使用 starter 计划。如需使用免费套餐，请在您 Fork 后的 render.yaml 中修改 plan: free（注意：无持久化磁盘，配置每次部署都会重置）。

​
部署后

​
完成设置向导

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

​
访问控制界面

Web 控制面板地址为 https://<your-service>.onrender.com/openclaw。

​
Render 控制面板功能

​
日志

在 Dashboard → 您的服务 → Logs 查看实时日志。可按以下类型过滤：
  • 构建日志（Docker 镜像创建）
  • 部署日志（服务启动）
  • 运行时日志（应用输出）

​
Shell 访问

用于调试，可通过 Dashboard → 您的服务 → Shell 打开 shell 会话。持久盘挂载于 /data。

​
环境变量

在 Dashboard → 您的服务 → Environment 修改环境变量。修改后会自动触发重部署。

​
自动部署

使用原版 OpenClaw 仓库时，Render 不会自动部署您的 OpenClaw。如需更新，请在控制面板手动同步 Blueprint。

​
自定义域名

  1. 进入 Dashboard → 您的服务 → Settings → Custom Domains
  2. 添加您的域名
  3. 按照指示配置 DNS（CNAME 指向 *.onrender.com）
  4. Render 会自动配置 TLS 证书

​
伸缩

Render 支持横向和纵向伸缩：
  • 纵向伸缩：更改计划，获取更多 CPU / 内存
  • 横向伸缩：增加实例数量（仅限 Standard 计划及以上）
对 OpenClaw 通常纵向伸缩已足够。横向伸缩需要支持会话保持或外部状态管理。

​
备份和迁移

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

​
故障排除

​
服务无法启动

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

​
冷启动缓慢（免费套餐）

免费套餐服务在空闲 15 分钟后自动关闭。首次请求时容器启动需几秒钟。升级到 Starter 计划可实现始终在线。

​
重部署后数据丢失

免费套餐无持久化磁盘，故会出现此问题。建议升级付费计划，或定期通过 /setup/export 导出配置。

​
健康检查失败

Render 期望 /health 路径返回 200 状态，且 30 秒内响应。如果构建成功但部署失败，可能是服务启动过慢。请检查：
  • 构建日志是否有错误
  • 在本地用 docker build && docker run 容器是否正常运行