Install 导读

一键部署 OpenClaw 到 Render,免费方案也能跑

用 render.yaml 蓝本声明式定义整个堆栈,点一下链接就完成部署。最易错的是免费计划没有持久磁盘,OpenClaw 状态会在每次部署后重置,建议至少用 Starter 计划。

先讲这一页到底在解决什么

一键部署 OpenClaw 到 Render,免费方案也能跑

用 render.yaml 蓝本声明式定义整个堆栈,点一下链接就完成部署。最易错的是免费计划没有持久磁盘,OpenClaw 状态会在每次部署后重置,建议至少用 Starter 计划。

原文共 18 节,先看 Start Here 路径:/install/render 查看官方原文

第一站

📐 Blueprint 是什么?就是“把整套房子的施工图一次交上去”

这能让 Render 不用你手动点一大堆表单。

🧱

runtime: docker

像告诉 Render:“这房子按仓库里的 Docker 图纸来建。”

❤️

healthCheckPath

像让物业每天去敲一敲健康门,确认这台机器不是只是亮着灯。

🔐

generateValue: true

像让平台自动替你生成一把安全门票,不用你手敲弱密码。

💾

disk

像给 OpenClaw 一只不会跟着容器一起蒸发的储物柜。

第二站

🚀 Deploy to Render 按钮,翻成人话就是“把这张蓝图交给物业,照图施工”

你点按钮之后,平台会自己建服务、拉镜像、启动应用。

🏗️ Render 会做什么

根据仓库根目录的 render.yaml 建 web service、挂磁盘、设变量、开始部署。

🔗 部署后地址长什么样

通常会给你一个 https://<service-name>.onrender.com 这样的门牌。

OPENCLAW_GATEWAY_TOKEN

这把门票会被自动生成。别找半天说“我没写啊”,去环境变量页面看它。

🎈 一句话

Render 这条路的乐趣在于:部署步骤可以写进仓库,而不是留在脑子里。

第三站

💳 Plan 那一段,其实是在选“试住、常住、正式办公”

官方把差异说得很实在,重点在是否会睡着,以及有没有磁盘。

🆓 Free

像试住间。15 分钟没人理就会睡着,而且没有持久磁盘,适合演示,不适合长期记东西。

🏠 Starter

像普通常住房。不会自己打盹,还有最基础的储物柜。

🏢 Standard+

更像正式办公区。适合多通道、更多流量、更严肃的值班场景。

📌 官方默认为什么选 Starter

因为没有持久磁盘的 OpenClaw,很容易一重部署就像失忆。

第四站

🖥️ 控制台、日志、Shell,这三块分别像“前台门口、监控屏、维修通道”

部署完后最常看的就是这些地方。

https://<your-service>.onrender.com/

这是控制台门口。进去时要带上自动生成的 OPENCLAW_GATEWAY_TOKEN 门票。

🪵 Logs

像监控屏。你能分清是构建翻车、部署翻车,还是运行时自己在咳嗽。

🔧 Shell

像维修通道。你可以钻进去做调试、看文件、顺手做备份。

openclaw backup create

像在维修通道里顺手把家当打包,方便以后迁走。

第五站

🩺 后面那些问题排查,其实全在讲“为什么房子建好了,人却进不去,或者一醒来就忘事”

Render 常见坑很集中。

🚫 服务起不来

先看 deploy logs。常见原因是门票没设好,或者端口没对上 8080。

😴 冷启动慢

Free tier 会睡着,第一下敲门自然要等它起床。

🧠 重部署后失忆

通常不是程序坏了,而是你在用没有持久磁盘的免费房间。

🎈 收尾一句

Render 这条路的核心不是“云上跑起来”,而是“让部署蓝图可复用、可回放、可维护”。