Install 导读

把 OpenClaw 网关部署到 Fly.io,附避坑指南

跟着步骤走:建应用、挂持久卷、设密钥、部署。最易错的是绑定地址——默认绑 127.0.0.1 会导致健康检查失败,记得加 `--bind lan`。端口也要和 `internal_port` 一致。

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

把 OpenClaw 网关部署到 Fly.io,附避坑指南

跟着步骤走:建应用、挂持久卷、设密钥、部署。最易错的是绑定地址——默认绑 127.0.0.1 会导致健康检查失败,记得加 `--bind lan`。端口也要和 `internal_port` 一致。

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

第一站

✈️ Beginner quick path 其实就是四步飞行计划

先建 app,再建 volume,再放 secrets,最后 deploy。

📦

fly apps create

像先给你的飞行器起名字。

💾

fly volumes create

像挂一个行李箱,不然容器换一架飞机就容易失忆。

🔐

fly secrets set

像把门票、API key、通道钥匙塞进密封信封里。

🚀

fly deploy

真正把这架机器推上天。

第二站

🧾 fly.toml 那大段配置,翻成人话就是“告诉飞机怎么飞、往哪开门、家当放哪”

看起来很长,其实每项都很具体。

--bind lan

像告诉 Gateway:“你要对飞机里的外部代理开门,别只对自己房间说话。”

internal_port = 3000

像告诉 Fly 物业:“这台机器的接待窗口在 3000。”

OPENCLAW_STATE_DIR=/data

像把 OpenClaw 的家直接放到挂载的行李箱上。

memory = \"2048mb\"

像给飞机配够燃料。512MB 太瘦,2GB 才比较稳。

第三站

🔑 Secrets 和 config file,是“两层不同的钥匙管理法”

官方更推荐把真正敏感的钥匙放 secrets,不要乱塞进配置文件。

fly secrets set OPENCLAW_GATEWAY_TOKEN=$(openssl rand -hex 32)

像先给总控室造一张随机管理员门票。

🔐 Provider key 放 env

像把最敏感的钥匙塞进保险柜,而不是钉在墙上。

fly ssh console

像你登上飞机内部维修通道,去补 /data/openclaw.json 这份正式配置。

🎈 一句话

secrets 管钥匙,配置文件管房间布局,别把两者搅在一起。

第四站

🩺 排错那几段,基本都在围着“地址、端口、内存、锁文件”四件事转

Fly 常见坑很集中。

📍 地址不对

如果没绑到 0.0.0.0,Fly 代理就像敲到一扇根本没开口的门。

🚪 端口不对

internal_port 和 Gateway 实际端口不一致,健康检查就会一直扑空。

🧠 OOM

内存太少时,这架飞机会像飞到半空突然断气。

rm -f /data/gateway.*.lock

像清掉上一次异常重启后遗留在门口的“我还在值班”纸条。