OC
OpenClaw 中文解释版

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

简要总结

Gateway on macOS

这页说明书是教你在苹果电脑上安装和运行一个叫“Gateway”的小助手。它就像一个藏在电脑里的小管家,能让其他软件和OpenClaw这个工具好好说话。如果你在苹果电脑上使用OpenClaw软件,并且想让它和本地的工具一起工作,就需要看看这页啦!我们会告诉你,怎么先安装一个命令行工具,然后怎么让这个小管家自己乖乖地在后台运行。

五岁小孩版解释

以前,OpenClaw软件自己就带着运行Gateway小管家需要的所有东西。但现在不一样啦!现在的OpenClaw软件需要你另外安装一个叫openclaw的命令行工具,它自己不再直接启动Gateway。它会用一个叫launchd的苹果电脑系统工具(你可以把它想成电脑的“小闹钟”或“任务管理员”)来帮忙,确保Gateway小管家一直在后台工作。

第一步:安装命令行工具(这是必须的!) 为了让Gateway在本地模式工作,你的苹果电脑上需要先有Node.js(一个运行JavaScript程序的环境,版本要22或更高)。然后,你需要安装openclaw这个工具。

  1. 打开电脑上的“终端”程序(它像一个对电脑说话的小窗口)。
  2. 输入这个命令并按回车:npm install -g openclaw@<version>。这个命令的意思是“请用npm这个工具,给我安装一个叫openclaw的软件”。记得要把<version>换成你需要的版本号哦。 在OpenClaw软件里,点击“安装CLI”按钮,做的事情和上面这个命令是一样的。

第二步:认识launchd(Gateway的小闹钟) OpenClaw软件会用launchd这个系统工具来管理Gateway。这就像给Gateway设置了一个小闹钟,让电脑一开机或者需要的时候就能自动叫醒它。

  • 这个小任务的名字可能叫ai.openclaw.gateway
  • 它的配置文件放在这里:~/Library/LaunchAgents/ai.openclaw.gateway.plist(这是一个电脑里的文件地址)。
  • 怎么管理它呢?在OpenClaw软件里,打开“OpenClaw Active”开关,就等于告诉小闹钟“开始工作吧!”;关掉开关,就等于说“休息吧!”。要记住哦,就算你关掉了OpenClaw软件,Gateway小管家可能还在后台运行,因为小闹钟launchd会继续照顾它。
  • 如果Gateway已经在运行了,OpenClaw软件会直接去找它玩,而不会启动第二个。

第三步:检查版本(确保大家能一起玩) OpenClaw软件会检查它自己和Gateway小管家的版本是不是匹配。如果版本对不上,它们可能就玩不到一块儿去。这时候,你需要按照提示,更新那个全局安装的openclaw命令行工具,让它的版本和软件一样。

第四步:试试看它工作没(冒烟测试) 安装好后,我们可以做个简单检查,看看Gateway小管家能不能正常工作。

  1. 首先,打开“终端”,输入openclaw --version并按回车,看看安装的版本对不对。
  2. 然后,输入一段长一点的命令(就是原文里OPENCLAW_SKIP...开头的那两行),这行命令的意思是“请Gateway小管家在18999号端口上开始工作,但先别忙其他复杂的活儿”。
  3. 最后,再输入另一行命令(openclaw gateway call health...),这行命令的意思是“嘿,在18999端口工作的Gateway,你身体好吗?”,如果它回答“我很好”,就说明它成功启动啦!