第一步:先看有没有桌面安装包
OpenClaw GitHub 最新 Release 当前主要看到 macOS 安装包:
| 文件 | 适合谁 | 说明 |
|---|---|---|
| OpenClaw-2026.5.7.dmg | macOS 用户 | 推荐,双击安装。 |
| OpenClaw-2026.5.7.zip | macOS 备用 | 如果 dmg 不能用,再试 zip。 |
| dSYM.zip | 开发者 | 不要下载,这是调试文件。 |
不要点 Source code
Source code 是源码,不是给小白直接安装的软件。
打开 OpenClaw 最新下载页Source code 是源码,不是给小白直接安装的软件。
第二步:如果没有适合你的安装包,就用终端安装
OpenClaw 官方推荐方式是通过命令安装。
终端是什么?
终端就是电脑里的命令输入框。你不是在写代码,只是在复制一条安装命令,让电脑帮你下载和安装。
终端就是电脑里的命令输入框。你不是在写代码,只是在复制一条安装命令,让电脑帮你下载和安装。
macOS 怎么打开终端
按 Command + 空格,输入「终端」或 Terminal,回车打开。
Windows 怎么打开终端
普通方式:按 Windows 键,搜索「PowerShell」或「终端 / Windows Terminal」,回车打开。
OpenClaw 更推荐:README 建议 Windows 通过 WSL2 使用。装过 WSL2 的用户,打开「Ubuntu」应用再复制命令;没装过就先使用普通 PowerShell 方式,或者查看 WSL2 安装教程。
第三步:安装 Node.js
OpenClaw 需要 Node 24,或者 Node 22.16+。
Node.js 是什么?
它是运行 OpenClaw 需要的基础环境。可以理解成 OpenClaw 的“发动机”。
它是运行 OpenClaw 需要的基础环境。可以理解成 OpenClaw 的“发动机”。
会用命令的方式
如果你已经会 Homebrew / nvm,可以用自己熟悉的方式安装 Node 24。
第四步:安装 OpenClaw
复制下面命令到终端,按回车。
npm install -g openclaw@latest
看见代码不用慌:这不是让你写代码,只是复制安装命令。等待它跑完,如果没有红色报错,通常就是成功。
第五步:启动 OpenClaw 向导
安装完成后,继续复制这条命令:
openclaw onboard --install-daemon
Onboard 是什么?
就是新手配置向导。它会一步步带你设置 gateway、workspace、channels、skills。你按提示走即可。
就是新手配置向导。它会一步步带你设置 gateway、workspace、channels、skills。你按提示走即可。
如果它问模型或供应商,优先选择你通过 CC Switch 导入/激活的 fululai 配置。
第六步:检查是否安装成功
复制下面命令:
openclaw doctor
doctor 是什么?
它不是医生,是“检查工具”。会告诉你 OpenClaw 当前配置哪里正常、哪里有问题。
它不是医生,是“检查工具”。会告诉你 OpenClaw 当前配置哪里正常、哪里有问题。
第七步:复制第一个任务模板测试
配置成功后,先不要做复杂任务,复制这个测试:
请帮我检查当前项目的结构,并用小白能听懂的话告诉我每个文件夹是做什么的。
常见问题
| 问题 | 原因 | 解决 |
|---|---|---|
| npm 命令不存在 | Node.js 没装好 | 先安装 Node.js,再重新打开终端。 |
| openclaw 命令不存在 | 安装没成功,或终端没刷新 | 重新运行 npm install,或关闭终端重新打开。 |
| API 不生效 | CC Switch 没激活 fululai 或工具未重启 | 回 CC Switch 激活 fululai,然后重启 OpenClaw。 |
| 余额不足 / 401 | fululai Key 或余额问题 | 回 fululai 控制台检查 Key 和余额。 |