OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书

简要总结

Hetzner

这页说明书是教你怎么在一个叫Hetzner的“云上小电脑”(VPS)里,安装和运行一个叫OpenClaw的智能小助手。就像给你的玩具机器人找一个永远不关机的家一样!它会一步一步告诉你,怎么租这个小电脑、怎么安装必要的软件、怎么让OpenClaw在里面安家并一直记住事情。如果你想拥有一个24小时都在线的智能助手,花很少的钱就能做到,就看这一页。

五岁小孩版解释

我们要做的事情,就像给一个聪明的机器人朋友租一个永远亮着灯的小房间(VPS),然后把它放进去,这样它就能一直为我们工作啦。房间在Hetzner公司那里,我们用Docker(你可以把它想成一个神奇的、隔离的玩具箱)来装机器人,并且把机器人重要的记忆(比如设置、学到的技能)都放在房间的保险柜里,这样就算玩具箱重启了,记忆也不会丢。

你需要准备的东西有:

  • 一个Hetzner的VPS(小电脑),并且你知道怎么用root身份进去。
  • 能从你自己的电脑用SSH(一个远程连接工具)连到那个小电脑。
  • 会简单的复制粘贴命令。
  • 大约20分钟时间。
  • 一些密码,比如机器人的启动密码,或者你想让它连接Gmail、WhatsApp时需要的密码。

现在,我们一步一步来:

  1. 租下小房间(VPS) 这一步是去Hetzner那里,租一台运行Ubuntu或Debian系统的小电脑。租好后,用你自己的电脑,打开一个叫“终端”的窗口,输入 ssh root@你的小电脑IP地址 这个命令,就能进去啦。记住,这个小电脑是我们放重要东西的地方,不要随便扔掉哦。

  2. 安装神奇的玩具箱(Docker) 现在我们在小电脑里面,安装Docker这个“玩具箱”。你只需要复制粘贴下面这几行命令,就像念咒语一样:

    apt-get update
    apt-get install -y git curl ca-certificates
    curl -fsSL https://get.docker.com | sh
    

    装好后,可以输入 docker --versiondocker compose version 看看是不是安装成功了。

  3. 拿到机器人的图纸(克隆代码库) 我们要把OpenClaw机器人的建造图纸下载到小电脑里。输入:

    git clone https://github.com/openclaw/openclaw.git
    cd openclaw
    

    这样我们就进到图纸所在的文件夹了。

  4. 准备好保险柜(创建持久化目录) 因为玩具箱(Docker)重启后里面东西会清空,所以我们要在小电脑里(也就是“主机”上)提前准备好保险柜,用来存放机器人重要的记忆。输入:

    mkdir -p /root/.openclaw/workspace
    chown -R 1000:1000 /root/.openclaw
    

    第二行命令是把保险柜的钥匙交给机器人(用户ID 1000),这样它才能打开。

  5. 设置机器人的秘密口令(配置环境变量) 机器人启动需要一些秘密口令,比如开门密码。我们在图纸文件夹里创建一个叫.env的文件,把下面的内容放进去,但一定要把change-me-now都换成你自己想的、又长又乱的密码(可以用 openssl rand -hex 32 命令来生成一个):

    OPENCLAW_IMAGE=openclaw:latest
    OPENCLAW_GATEWAY_TOKEN=change-me-now
    OPENCLAW_GATEWAY_BIND=lan
    OPENCLAW_GATEWAY_PORT=18789
    OPENCLAW_CONFIG_DIR=/root/.openclaw
    OPENCLAW_WORKSPACE_DIR=/root/.openclaw/workspace
    GOG_KEYRING_PASSWORD=change-me-now
    XDG_CONFIG_HOME=/home/node/.openclaw
    

    千万注意: 这个.env文件里有密码,不要把它传到网上或者分享给别人。

  6. 写一个启动说明书(Docker Compose配置) 我们需要告诉玩具箱怎么启动机器人。创建或修改一个叫docker-compose.yml的文件,把一大段配置放进去(具体内容看原文)。这里面告诉玩具箱:用哪个机器人镜像、重启规则、把刚才的保险柜挂载进去、在哪个端口(18789)等待命令等等。这里要小心: 默认配置只让小电脑自己访问这个端口,更安全。如果你想从外面直接访问,需要修改并设置好防火墙。

  7. 给机器人装上必备工具(构建镜像) 这是非常关键的一步!机器人需要一些外部工具(比如叫gog, goplaces, wacli的小工具)才能完成某些工作(比如读邮件、查地点、发WhatsApp)。这些工具必须在“制造机器人”(构建Docker镜像)的时候就装好,如果等机器人启动后再装,工具下次重启就会消失! 你需要修改一个叫Dockerfile的文件,在里面用RUN命令(就像在说“现在请安装…”)把这些工具下载并安装好。原文里给了三个例子,你以后如果需要其他工具,也要用同样的方式加进去。记住: 以后如果增加了需要新工具的技能,你必须更新Dockerfile,重新构建镜像,再重启机器人。

  8. 制造并启动机器人(构建与启动) 工具都准备好后,我们就可以开始制造并启动机器人啦!输入:

    docker compose build
    docker compose up -d openclaw-gateway
    

    启动后,可以检查一下工具是不是都装好了:

    docker compose exec openclaw-gateway which gog
    

    如果显示/usr/local/bin/gog这样的路径,就说明成功啦!

  9. 检查机器人是否在工作(验证) 输入 docker compose logs -f openclaw-gateway 看看机器人的启动日志,如果看到 [gateway] listening on ws://0.0.0.0:18789 就说明它在乖乖听命令了。 怎么从你自己的电脑访问它呢?我们需要搭一条“秘密通道”(SSH隧道)。在你自己的电脑上打开终端,输入:

    ssh -N -L 18789:127.0.0.1:18789 root@你的小电脑IP
    

    这条命令会让通道保持打开。然后,在你自己的电脑浏览器里打开 http://127.0.0.1:18789/,粘贴你之前在.env文件里设置的OPENCLAW_GATEWAY_TOKEN密码,就能看到OpenClaw的控制界面啦!

重要提醒:

  • 安全规则: 这个小电脑最好只给OpenClaw用,不要在里面登录你个人的账号(比如苹果、谷歌、浏览器)。如果团队里大家互相信任,可以共享;如果不完全信任,最好分开。
  • 东西存在哪: 机器人的配置、记忆、工作成果都存在小电脑的/root/.openclaw/和它的子文件夹里,所以很安全。而它的身体(运行环境)和工具(外部二进制文件)是放在Docker镜像里的。
  • 给高级玩家的方法: 如果你喜欢用代码自动管理一切,原文最后提到了可以用Terraform(一种“基础设施即代码”工具)来自动完成租小电脑、安装、设置安全规则等所有步骤,这样更规范也更方便恢复。