Skip to main content

Documentation Index

Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Render

使用基础设施即代码在 Render 上部署 OpenClaw。随附的 render.yaml Blueprint 以声明式方式定义了你的整个栈，包括服务、磁盘、环境变量，因此你可以一键部署，并将基础设施与你的代码一起进行版本管理。

​
前提条件

​
使用 Render Blueprint 部署

部署到 Render 点击此链接将会：
  1. 根据此仓库根目录下的 render.yaml Blueprint 创建一个新的 Render 服务。
  2. 构建 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: 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 构建
healthCheckPathRender 监控 /health 并重启不健康的实例
generateValue: true自动生成一个加密安全的值
disk可在重新部署后仍然保留的持久化存储

​
选择套餐

套餐休眠磁盘最适合
Free空闲 15 分钟后不可用测试、演示
Starter永不休眠1GB+个人使用、小团队
Standard+永不休眠1GB+生产环境、多渠道
Blueprint 默认使用 starter。要使用免费套餐，请在你 fork 的 render.yaml 中将 plan: free（但请注意：没有持久化磁盘意味着 OpenClaw 状态会在每次部署时重置）。

​
部署之后

​
访问控制界面

Web 仪表板可在 https://<your-service>.onrender.com/ 访问。 使用已配置的共享密钥连接。此部署模板会自动生成 OPENCLAW_GATEWAY_TOKEN（可在 Dashboard → your service → Environment 中找到）；如果你将其替换为密码认证，请改用该密码。

​
Render 仪表板功能

​
日志

在 Dashboard → your service → Logs 中查看实时日志。可按以下内容筛选：
  • 构建日志（Docker 镜像创建）
  • 部署日志（服务启动）
  • 运行时日志（应用输出）

​
Shell 访问

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

​
环境变量

在 Dashboard → your service → Environment 中修改变量。更改会触发自动重新部署。

​
自动部署

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

​
自定义域名

  1. 前往 Dashboard → your service → Settings → Custom Domains
  2. 添加你的域名
  3. 按照提示配置 DNS（CNAME 指向 *.onrender.com）
  4. Render 会自动提供 TLS 证书

​
扩展

Render 支持水平和垂直扩展：
  • 垂直：更改套餐以获得更多 CPU/RAM
  • 水平：增加实例数量（Standard 套餐及以上）
对于 OpenClaw 来说，垂直扩展通常就足够了。水平扩展需要粘性会话或外部状态管理。

​
备份和迁移

你可以随时使用 Render 仪表板中的 shell 访问导出你的状态、配置、认证配置文件和工作区： 
openclaw backup create
这会创建一个可移植的备份归档，其中包含 OpenClaw 状态以及任何已配置的工作区。详情请参阅 Backup。

​
故障排查

​
服务无法启动

检查 Render 仪表板中的部署日志。常见问题包括：
  • 缺少 OPENCLAW_GATEWAY_TOKEN —— 确认它已在 Dashboard → Environment 中设置
  • 端口不匹配 —— 确保已设置 OPENCLAW_GATEWAY_PORT=8080，以便网关绑定到 Render 期望的端口

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

免费套餐服务会在 15 分钟无活动后休眠。休眠后第一次请求在容器启动期间会花费几秒钟。升级到 Starter 套餐即可始终在线。

​
重新部署后数据丢失

这发生在免费套餐上（没有持久化磁盘）。请升级到付费套餐，或定期在 Render shell 中通过 openclaw backup create 导出完整备份。

​
健康检查失败

Render 期望在 30 秒内从 /health 获得 200 响应。如果构建成功但部署失败，服务可能启动耗时过长。检查：
  • 构建日志中是否有错误
  • 容器是否可在本地使用 docker build && docker run 正常运行

​
下一步