render.yaml<\/code> 配置了运行 OpenClaw 所需的一切：<\/p>\n“`yaml theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
\nservices:
\n – type: web
\n name: openclaw
\n runtime: docker
\n plan: starter
\n healthCheckPath: \/health
\n envVars:
\n – key: PORT
\n value: “8080”
\n – key: SETUP_PASSWORD
\n sync: false # prompts during deploy
\n – key: OPENCLAW_STATE_DIR
\n value: \/data\/.openclaw
\n – key: OPENCLAW_WORKSPACE_DIR
\n value: \/data\/workspace
\n – key: OPENCLAW_GATEWAY_TOKEN
\n generateValue: true # auto-generates a secure token
\n disk:
\n name: openclaw-data
\n mountPath: \/data
\n sizeGB: 1<\/p>\n
\n使用的关键 Blueprint 功能：\n\n| 功能 | 用途 |\n| --------------------- | ----------------------------- |\n| `runtime: docker` | 从仓库的 Dockerfile 进行构建 |\n| `healthCheckPath` | Render 监控 `\/health` 并重启不健康的实例 |\n| `sync: false` | 在部署时提示输入值（用于密钥） |\n| `generateValue: true` | 自动生成加密安全的值 |\n| `disk` | 持久化存储，在重新部署后数据仍然保留 |\n\n## 选择套餐\n\n| 套餐 | 休眠机制 | 磁盘 | 适用场景 |\n| --------- | ----------- | ---- | -------- |\n| Free | 空闲 15 分钟后休眠 | 不可用 | 测试、演示 |\n| Starter | 永不休眠 | 1GB+ | 个人使用、小团队 |\n| Standard+ | 永不休眠 | 1GB+ | 生产环境、多渠道 |\n\nBlueprint 默认使用 `starter`。如需使用免费套餐，请在你 fork 的 `render.yaml` 中将 `plan: free`（但请注意：没有持久化磁盘意味着每次部署后配置都会重置）。\n\n## 部署完成后\n\n### 完成设置向导\n\n1. 访问 `https:\/\/<your-service>.onrender.com\/setup`\n2. 输入你的 `SETUP_PASSWORD`\n3. 选择模型提供商并粘贴你的 API 密钥\n4. 可选配置消息渠道（Telegram、Discord、Slack）\n5. 点击 **Run setup**\n\n### 访问控制面板\n\nWeb 管理面板位于 `https:\/\/<your-service>.onrender.com\/openclaw`。\n\n## Render 仪表盘功能\n\n### 日志\n\n在 **Dashboard → 你的服务 → Logs** 中查看实时日志。可按以下类型筛选：\n\n* 构建日志（Docker 镜像创建）\n* 部署日志（服务启动）\n* 运行时日志（应用输出）\n\n### Shell 访问\n\n如需调试，可通过 **Dashboard → 你的服务 → Shell** 打开 shell 会话。持久化磁盘挂载在 `\/data`。\n\n### 环境变量\n\n在 **Dashboard → 你的服务 → Environment** 中修改变量。更改会触发自动重新部署。\n\n### 自动部署\n\n如果你使用的是原始 OpenClaw 仓库，Render 不会自动部署你的 OpenClaw。要更新它，请在仪表盘中手动执行 Blueprint 同步。\n\n## 自定义域名\n\n1. 前往 **Dashboard → 你的服务 → Settings → Custom Domains**\n2. 添加你的域名\n3. 按照指引配置 DNS（CNAME 指向 `*.onrender.com`）\n4. Render 会自动配置 TLS 证书\n\n## 扩展\n\nRender 支持水平和垂直扩展：\n\n* **垂直扩展**：更改套餐以获取更多 CPU\/内存\n* **水平扩展**：增加实例数量（Standard 套餐及以上）\n\n对于 OpenClaw，垂直扩展通常就足够了。水平扩展需要粘性会话或外部状态管理。\n\n## 备份与迁移\n\n随时导出你的配置和工作区：\n\n<\/code><\/pre>\nhttps:\/\/.onrender.com\/setup\/export
\n“`<\/p>\n
这将下载一个可移植的备份文件，你可以在任何 OpenClaw 主机上恢复。<\/p>\n
故障排除<\/h2>\n服务无法启动<\/h3>\n
在 Render 仪表盘中检查部署日志。常见问题：<\/p>\n
\n- 缺少
SETUP_PASSWORD<\/code> — Blueprint 会提示输入此值，但请确认已设置<\/li>\n- 端口不匹配 — 请确保
PORT=8080<\/code> 与 Dockerfile 暴露的端口一致<\/li>\n<\/ul>\n冷启动缓慢（免费套餐）<\/h3>\n
免费套餐的服务在 15 分钟无活动后会休眠。休眠后的首次请求需要几秒钟等待容器启动。升级到 Starter 套餐可实现始终在线。<\/p>\n
重新部署后数据丢失<\/h3>\n
这发生在免费套餐上（无持久化磁盘）。升级到付费套餐，或通过 \/setup\/export<\/code> 定期导出你的配置。<\/p>\n健康检查失败<\/h3>\n
Render 期望在 30 秒内从 \/health<\/code> 获得 200 响应。如果构建成功但部署失败，可能是服务启动耗时过长。请检查：<\/p>\n\n- 构建日志中是否有错误<\/li>\n
- 容器是否能通过
docker build && docker run<\/code> 在本地正常运行<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"在 Render 上部署 使ஷ […]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-169","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/169","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/comments?post=169"}],"version-history":[{"count":2,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/169\/revisions"}],"predecessor-version":[{"id":804,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/169\/revisions\/804"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=169"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=169"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=169"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}