简要总结
macOS Dev Setup
这页说明书是教你怎么在苹果电脑上，自己动手做一个叫 OpenClaw 的软件。就像搭积木一样，你需要先准备好几块“积木”（Xcode 和 Node.js），然后跟着步骤一步步来。如果你想让软件在你的电脑上跑起来，就看看这页吧！
五岁小孩版解释
好啦，我们现在要开始动手做啦！不过在开始之前，我们得先准备好两样重要的东西，就像画画前要准备好纸和笔一样。
第一步：准备好“纸和笔”
- 安装 Xcode：这是一个苹果公司做的“工具箱”，里面有很多做软件需要的工具。你的版本号需要是 26.2 或者更新的。
- 安装 Node.js 和 pnpm：你可以把 Node.js 想成是软件的“发动机”，pnpm 是帮忙整理“零件”的小助手。你的 Node.js 版本号需要是 22 或者更新的。
东西都准备好啦？那我们开始吧！
第二步：安装所有的小零件
我们要用一个命令，把做这个软件需要的所有小零件都准备好。你只需要在电脑的“终端”里输入下面这行字，然后按回车键就行啦。
pnpm install
第三步：把软件搭起来并打包
现在，我们要用一个“魔法脚本”把软件搭好，并把它变成一个你可以打开的“盒子”。在“终端”里输入下面这行字，然后按回车键。
./scripts/package-mac-app.sh
搭好之后，软件会放在一个叫 dist/OpenClaw.app 的“盒子”里。
- 重要提醒：如果你的电脑没有苹果的“开发者签名”，这个“魔法脚本”会自动用一种叫 ad-hoc signing 的方式帮你签名（你可以把它想成是贴一个“自己人”的标签）。但贴了这种标签的软件，打开时电脑可能会问“你确定要打开吗？”，这是正常的。如果软件一打开就自己关掉了，你可以看后面的“遇到问题怎么办”部分。
第四步：安装一个“遥控器”（CLI）
为了让软件能在后台好好工作，我们需要给它装一个“遥控器”，名字叫 openclaw。有两个方法可以装：
- 推荐的方法：先打开我们刚刚做好的 OpenClaw 软件，在里面找到 General（通用）设置页面，然后点击 “Install CLI” 这个按钮。
- 手动安装：如果你喜欢自己动手，可以在“终端”里输入下面这行字（记得把
<version>换成正确的版本号哦）。npm install -g openclaw@<version>
遇到问题怎么办？ 别着急，我们来看看可能会遇到哪些小麻烦。
问题一：搭积木失败了，工具不匹配 这可能是因为你的“工具箱”（Xcode）或者电脑系统（macOS）版本太旧了。你需要：
- 把电脑系统更新到最新。
- 把 Xcode 也更新到 26.2 或更新版本。
你可以用
xcodebuild -version和xcrun swift --version这两个命令看看版本对不对。
问题二：软件一申请权限就自己关掉了 比如你允许它用“麦克风”时它却关掉了。这可能是因为电脑“记住”了之前乱糟糟的设置。
- 我们可以试试“忘记”这些设置。在“终端”里输入：
tccutil reset All ai.openclaw.mac.debug - 如果还不行，我们可能需要改一下软件“盒子”的名字（就是改
scripts/package-mac-app.sh文件里的BUNDLE_ID），让电脑觉得这是一个全新的软件。
- 我们可以试试“忘记”这些设置。在“终端”里输入：
问题三：软件里的“网关”一直显示“正在启动...” “网关”就像一扇门，可能被一个“看不见的小人”堵住了。
- 先用“遥控器”看看状态：
openclaw gateway status - 试着关掉它：
openclaw gateway stop - 如果还不行，就找找是谁堵住了门：
lsof -nP -iTCP:18789 -sTCP:LISTEN。找到那个“小人”（PID 号码）后，请它离开（用kill命令）。
- 先用“遥控器”看看状态：