简要总结
Gateway on macOS
这页说明书是教你在苹果电脑上安装和运行一个叫“Gateway”的小助手。它就像一个藏在电脑里的小管家,能让其他软件和OpenClaw这个工具好好说话。如果你在苹果电脑上使用OpenClaw软件,并且想让它和本地的工具一起工作,就需要看看这页啦!我们会告诉你,怎么先安装一个命令行工具,然后怎么让这个小管家自己乖乖地在后台运行。
五岁小孩版解释
以前,OpenClaw软件自己就带着运行Gateway小管家需要的所有东西。但现在不一样啦!现在的OpenClaw软件需要你另外安装一个叫openclaw的命令行工具,它自己不再直接启动Gateway。它会用一个叫launchd的苹果电脑系统工具(你可以把它想成电脑的“小闹钟”或“任务管理员”)来帮忙,确保Gateway小管家一直在后台工作。
第一步:安装命令行工具(这是必须的!)
为了让Gateway在本地模式工作,你的苹果电脑上需要先有Node.js(一个运行JavaScript程序的环境,版本要22或更高)。然后,你需要安装openclaw这个工具。
- 打开电脑上的“终端”程序(它像一个对电脑说话的小窗口)。
- 输入这个命令并按回车:
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小管家能不能正常工作。
- 首先,打开“终端”,输入
openclaw --version并按回车,看看安装的版本对不对。 - 然后,输入一段长一点的命令(就是原文里
OPENCLAW_SKIP...开头的那两行),这行命令的意思是“请Gateway小管家在18999号端口上开始工作,但先别忙其他复杂的活儿”。 - 最后,再输入另一行命令(
openclaw gateway call health...),这行命令的意思是“嘿,在18999端口工作的Gateway,你身体好吗?”,如果它回答“我很好”,就说明它成功启动啦!