环境准备
先确认本机的 npm 和 Node.js 版本。
npm -v
node -v
Node.js 版本需要大于等于 22.00，不满足的话，后面的安装过程大概率会卡住，或者装完也跑不起来。
安装 OpenClaw
如果系统里已经装过旧版本，可以先卸掉：
npm uninstall -g openclaw
正式安装时用全局安装命令：
sudo npm i -g openclaw
执行后系统会要求输入密码，macOS 终端里默认不会显示字符，这很正常。
安装完成后，终端里通常会看到类似下面的提示：
npm warn deprecated npmlog@6.0.2: This package is no longer supported.
npm warn deprecated inflight@1.0.6: This module is not supported, and leaks memory...
npm warn deprecated tar@6.2.1: Old versions of tar are not supported...
added 711 packages in 4m
130 packages are looking for funding
run `npm fund` for details
实际装的时候，我更在意的是两类常见报错：一个是 Git 拉取失败，另一个是权限不够。
注意事项：可能出现的两种错误
Git 连接错误
执行
npm uninstall -g openclaw时，可能会看到fatal: unable to access 'https://github.com/whiskeysockets/libsignal-node.git/'。解决方案：把 Git 下载协议改成 HTTPS。
权限错误
执行
npm install -g openclaw-cn@latest时，可能会遇到Error: EACCES: permission denied。解决方案：在 npm 命令前加
sudo。
确认是否装好，直接看版本号：
openclaw --version
能正常输出版本号，基本就说明安装没问题了。
初始化向导
openclaw onboard
这里会先提醒你，OpenClaw 这类工具会访问本地文件和终端环境，继续之前最好知道自己在授权什么。按左方向键 ← 选 Yes，再回车。
快速开始
接下来选 QuickStart，直接进入快速配置。
配置模型
这一步是填 AI 模型的 API Key。OpenClaw 本身不提供模型能力，得连到外部大语言模型才能工作。它对 token 的消耗不算省，真要长期用，国内模型通常更实在一点，通义千问这类就比较合适。
选择默认模型
选择聊天工具
这一步我建议先跳过，选 Skip for Now 就行。先把 OpenClaw 在终端里跑起来，确认它能正常连模型、读文件、写文件，后面再回头接聊天工具，省得一次性配太多，出问题不好定位。
选择技能
这里可以先选 Yes，也可以先不配，后面再从 UI 里补。
进入技能列表后，用空格勾选需要的项，再回车确认。支持多选，不想现在配也可以先跳过。
注意事项：如果提示
Please select at least one option，说明你没选任何技能。解决方案：按空格选中一个或多个技能，再回车。
备用 API 和 Hooks
备用 API 可以先都选 No，不影响主流程。Hooks 也一样，不是第一次装就必须配上的东西，先把主链路跑通更重要。
启动服务
最后会进入启动配置，等它跑完，大概需要 30 秒左右。
安装完成后的访问方式
如果页面没有自动打开，可以手动访问：
http://127.0.0.1:18789/chat?session=main
如果访问 http://127.0.0.1:18789 时出现 unauthorized: gateway token mismatch (open the dashboard URL and paste the token in Control UI settings)，一般是网关令牌没对上。
处理顺序比较简单：先找到 openclaw.json，再定位到 gateway > auth > token，把 token 复制出来，填到概览里的'网关令牌'里，重启网关。之后用带参数的地址访问：
http://127.0.0.1:18789/?token=这是令牌值
比如 token 是 abc123，那就访问：
http://127.0.0.1:18789/?token=abc123
这套流程不算复杂，真正容易卡住的还是前面两个点：Node.js 版本和 npm 全局安装权限。先把这两个处理好，后面的配置基本就是按向导点完。
