简要总结
GCP
这页说明书是教你如何在谷歌云(GCP)上,像搭一个不会消失的积木房子一样,搭建一个一直运行的 OpenClaw 小助手。你需要先创建一个云上的小电脑(叫虚拟机),然后在里面安装一个叫 Docker 的“魔法盒子”,最后把 OpenClaw 放进去。这样,你的小助手就能 24 小时工作啦,而且每个月可能只需要花很少的零花钱。如果你想让小助手一直在线,就可以看这一页。
五岁小孩版解释
我们要在谷歌云上,给 OpenClaw 小助手安一个永远的家。就像给小鱼建一个水族箱,我们需要先准备鱼缸(云项目),放好水和设备(虚拟机),然后才能把小鱼(OpenClaw)放进去。
你需要准备的东西:
- 一个谷歌云账号(新用户可以免费试用)。
- 一台你自己的电脑,用来指挥云上的小电脑。
- 大约 20 到 30 分钟的时间。
- 一些“钥匙”,比如你想让小助手连接 WhatsApp 或 Gmail 时需要的密码。
第一步:准备好你的工具箱
你可以用两种方式指挥谷歌云。一种是安装一个叫 gcloud 的命令行工具(像对电脑说话),另一种是直接打开谷歌云的网站页面操作。这里我们主要讲用命令行工具的方法。
第二步:创建一个“云项目” “云项目”就像你在云上的一块专属空地。你需要给它起个名字,比如“我的小助手之家”。然后,你要为这块地开通“付费”功能(虽然可能不花钱,但需要绑定一下)。最后,告诉谷歌云,你要在这块地上使用“虚拟机”这项服务。
第三步:创建你的小电脑(虚拟机) 现在,我们要在空地上放一台小电脑。你需要选一个型号:
e2-micro:最小的,免费,但可能力气不够,容易累趴下。e2-small:推荐的最小型号,力气够用,每个月大约 12 美元。e2-medium:力气更大,更可靠,大约 25 美元。
我们选 e2-small,用 Debian 12 这个系统,硬盘选 20GB。创建好之后,记得它住在哪个“区域”(比如 us-central1-a)。
第四步:连接到你的小电脑
小电脑启动后,你需要从自己的电脑“钻一条隧道”进去控制它。这个隧道叫 SSH。用命令 gcloud compute ssh 加上小电脑的名字和区域就能连上。刚创建好时可能需要等一两分钟才能连上哦。
第五步:在小电脑里安装 Docker Docker 就像一个“魔法盒子”,能把 OpenClaw 和它需要的所有东西打包在一起,与电脑的其他部分隔开,这样就不会弄乱了。我们通过几条命令来安装它。安装好后,需要退出 SSH 再重新登录一次,让设置生效。
第六步:拿到 OpenClaw 的“图纸”
我们需要把搭建 OpenClaw 的“图纸”(也就是代码)下载到小电脑里。用 git clone 这个命令就能从网上拉下来。
第七步:准备两个“记忆盒子”
Docker 魔法盒子关掉后,里面的东西可能会消失。所以我们要在小电脑本身上创建两个文件夹,当作“记忆盒子”,用来永久保存 OpenClaw 的设置和你工作的文件。命令是 mkdir -p ~/.openclaw 和 mkdir -p ~/.openclaw/workspace。
第八步:写一张“设置清单”
我们需要告诉 OpenClaw 一些重要信息,比如开门密码(OPENCLAW_GATEWAY_TOKEN)、从哪个门进去(OPENCLAW_GATEWAY_PORT,默认是 18789)、“记忆盒子”放在哪。这些信息写在一个叫 .env 的文件里。特别注意:里面的密码一定要改成你自己独有的、复杂的密码,不能用“change-me-now”。这个文件很重要,不能分享给别人。
第九步:写一张“启动说明书”
接下来,我们要写一个叫 docker-compose.yml 的文件。它就像一份“启动说明书”,告诉 Docker 魔法盒子:用哪张“设计图”(Dockerfile)来造盒子,把“记忆盒子”挂载到哪,开门密码是什么,以及盒子关掉后要自动重启。
第十步:提前把“工具”放进盒子里(非常关键!)
OpenClaw 小助手工作可能需要一些额外的小工具,比如连接 Gmail 的 gog、连接 WhatsApp 的 wacli。这些小工具必须在制造 Docker 盒子的时候就放进去。如果等盒子运行起来再放,盒子一重启,工具就没了。所以,我们要修改“设计图”(Dockerfile),在里面用 RUN 命令提前把这些工具下载并安装好。以后如果需要新工具,也必须修改设计图,重新造一个盒子。
第十一步:造盒子并启动
现在,一切准备就绪!我们用 docker compose build 命令,按照设计图造出 Docker 盒子。然后用 docker compose up -d 命令启动它。小心:如果造盒子的过程中电脑显示“Killed”并退出,说明小电脑(虚拟机)力气不够(内存不足),你需要换成 e2-medium 这种力气更大的型号。
启动后,我们还要告诉小助手,允许从我们电脑的隧道过来的连接。用一条 docker compose run 命令来设置。
第十二步:检查小助手是否在说“你好”
用 docker compose logs 命令看看盒子的运行记录。如果看到 [gateway] listening on ws://0.0.0.0:18789 这样的字,就说明小助手已经启动,在门口等着啦!
第十三步:从你自己的电脑访问
小助手在云上小电脑里,我们怎么和它玩呢?我们需要再“钻一条隧道”,把云上小电脑的 18789 号门,连到我们自己电脑的 18789 号门。命令是 gcloud compute ssh ... -- -L 18789:127.0.0.1:18789。然后,在你自己电脑的浏览器里打开 http://127.0.0.1:18789/ 就能看到控制界面了!
第一次打开时,可能需要输入一个密码(token)。你可以用 docker compose run --rm openclaw-cli dashboard --no-open 命令得到一个带密码的链接,把密码复制过去就行。如果还不行,可能需要在小电脑里“批准”你的浏览器设备。
重要提醒:
- 东西存在哪:所有重要的设置、密码、工作文件,都存在我们第七步创建的“记忆盒子”(主机文件夹)里。Docker 盒子本身可以随时重启或重建,不会丢东西。
- 更新小助手:想升级小助手时,进入
openclaw文件夹,用git pull拉取新图纸,然后重新docker compose build和docker compose up -d就行了。 - 安全建议:如果是你自己玩,用你的账号就行。如果是给公司或团队用,最好创建一个专门的“服务账号”,只给它最小的、必要的权限,这样更安全。