在 macOS 上安装并配置 OpenClaw

权限错误

执行 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 全局安装权限。先把这两个处理好，后面的配置基本就是按向导点完。