> ## 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.yaml` Blueprint 在 [Render](https://render.com) 上部署 OpenClaw。它会在一个文件中声明服务、磁盘和环境变量。

## 前提条件

* 一个 [Render 账户](https://render.com)（提供免费套餐）
* 来自你首选 [模型提供商](/providers) 的 API 密钥

## 部署

[部署到 Render](https://render.com/deploy?repo=https://github.com/openclaw/openclaw)

这会根据 `render.yaml` 创建一个 Render 服务，构建 Docker 镜像并进行部署。你的服务 URL 形式如下：`https://<service-name>.onrender.com`。

## 蓝图

```yaml theme={"theme":{"light":"min-light","dark":"min-dark"}}
services:
  - type: web
    name: openclaw
    runtime: docker
    plan: starter
    healthCheckPath: /startupz
    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
```

| 功能                    | 用途                                |
| --------------------- | --------------------------------- |
| `runtime: docker`     | 从仓库的 Dockerfile 构建                |
| `healthCheckPath`     | `/startupz` 报告启动完成后，Render 才会接收流量 |
| `generateValue: true` | 自动生成一个经过加密安全处理的值                  |
| `disk`                | 在重新部署后仍然保留的持久化存储                  |

## 选择套餐

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

Blueprint 默认为 `starter`。要使用免费套餐，请在你 fork 的 `render.yaml` 中将 `plan: free` 更改为 `plan: free` —— 请注意，由于没有持久磁盘，OpenClaw 状态会在每次部署时重置。

## 部署之后

### 访问控制界面

Web 仪表板可通过 `https://<your-service>.onrender.com/` 访问。使用共享密钥连接：自动生成的 `OPENCLAW_GATEWAY_TOKEN`（在 **Dashboard → your service → Environment** 中查找），或者如果你切换到了密码认证，则使用你的密码。

### 日志

**Dashboard → your service → Logs** 显示构建日志（Docker 镜像创建）、部署日志（服务启动）以及运行时日志（应用输出）。

### Shell 访问

**Dashboard → your service → Shell** 会打开一个 shell 会话。持久化磁盘挂载在 `/data`。

### 环境变量

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

### 自动部署

当已连接仓库的分支有新提交时，Render 会自动重新部署。如果你是直接从 `openclaw/openclaw` 部署，而不是从你自己的 fork 部署，那么你没有推送权限来触发这一过程，因此请通过 Dashboard 手动同步 Blueprint，或者将服务指向你自己的 fork。

## 自定义域名

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

## 扩展

* **垂直扩展**：为方案增加更多 CPU/RAM。通常对 OpenClaw 来说已经足够。
* **水平扩展**：增加实例数量（标准方案及以上）。由于 OpenClaw 会将运行时状态保存在本地磁盘上，因此需要粘性会话或外部状态管理。

## 备份和迁移

从 Render Dashboard shell 中，您可以随时导出状态、配置、身份验证配置文件和工作区：

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw backup create
```

这会创建一个可移植的备份归档。参见 [备份](/cli/backup)。

## 故障排查

### 服务无法启动

检查 Render 仪表板中的部署日志。常见问题包括：

* 缺少 `OPENCLAW_GATEWAY_TOKEN` — 请确认它已在 **Dashboard → Environment** 中设置
* 端口不匹配 — 确保 `OPENCLAW_GATEWAY_PORT=8080`，以便网关绑定到 Render 期望的端口

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

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

### 重新部署后数据丢失

这会发生在免费套餐上（没有持久化磁盘）。请升级到付费方案，或者定期从 Render shell 使用 `openclaw backup create` 导出备份。

### 健康检查失败

如果构建成功但部署失败，则服务可能需要较长时间才能启动，或者可能无法访问 `/startupz`。请检查：

* 构建日志中是否有错误
* 容器是否可在本地使用 `docker build && docker run` 正常运行

## 下一步

* 设置消息渠道：[Channels](/channels)
* 配置 Gateway：[网关配置](/gateway/configuration)
* 保持 OpenClaw 为最新版本：[更新](/install/updating)