虽然OpenClaw有官方操作文档，但是文档是针对有编程基础的人，对新手小白不太友好。
本文章针对小白讲解如何在macOS安装OpenClaw。
OpenClaw常见有三种安装方式，推荐使用npm 全局安装方式。具体原因看下面介绍。
- One-liner 安装：脚本一键安装。适合就想体验一下，不打算长久使用OpenClaw的人。
- npm 全局安装：手动安装。适合计算机水平不高，但是准备深度使用OpenClaw的人。
- 从源码安装：开发模式。适合计算机专业的，需要对OpenClaw修改开发的人。
- 本质：下载一个安装脚本，脚本内部帮你执行 npm 安装，自动检测环境
- 特点：对新手最友好、自动化程度高、黑盒程度也高
- 适合：第一次体验、不想了解底层机制
- 不适合：网络不稳定、需要精确控制版本、企业环境部署
- 本质：通过 Node.js 官方包管理器安装、安装到系统全局目录、生成 CLI 命令
- 特点：可控、日志清晰、版本可锁定、更新方便
- 适合：长期使用、生产环境、自动化部署、需要排错能力
- 本质：直接下载源码、手动编译、手动注册命令
- 特点：最大自由度、可修改源码、可调试内部逻辑、可参与开发
- 适合：二次开发、想改 OpenClaw 行为、深度调试、贡献代码
One-liner 安装 看似一键安装很简单。其实大部分人安装会出现报错。如果你想解决掉报错那就得一步一步解决报错安装，那和npm 安装没区别了。
我也侥幸的以为自己是欧皇于是测试一了一下One-liner 一键安装 ，多处报错。
本文章介绍npm 全局安装方式的实操教程
需要：Node.js 22 或更高
- 找到“终端”并打开
- 输入node –version 按回车。
- 正常小白的电脑是没有node的，所以出现的应该是： command not found: node
- 如果你的电脑直接返回了node的版本且高于Node.js 22那不需要安装node。如果返回的是command not found: node。按照下面的步骤安装node
- 点击官方下载地址：https://nodejs.org/en/download
- 如下图选择macOS 然后点击绿色下载按钮下载
下载后进行安装。
在终端中输入以下命令：
node -v npm -v如下图出node与npm版本号说明安装成功
npm 是什么？
npm 全称是： Node Package Manager （Node.js 包管理器）它的作用就是：
安装 Node.js 软件包（packages）
管理依赖（dependencies）
升级、卸载、发布 Node.js 工具和库
注意：确保安装时候开启科学上网，部分网站有限制，否则下载不成功。
用国内 npm 镜像，避免 npm install 因网络超时失败。终端输入：
npm config set registry https://registry.npmmirror.com确认是否设置成功：
npm config get registry输出：https://registry.npmmirror.com说明设置成功
②、清理 npm 缓存
避免之前下载失败残留的缓存文件影响安装。
npm cache clean --force③、全局安装 OpenClaw
npm install -g openclaw④、好吧又报错了：
- npm error code 128
- npm error An unknown git error occurred
- npm error command git –no-replace-objects ls-remote ssh://http://git@github.com/whiskeysockets/libsignal-node.git
- npm error : Permission denied (publickey).
- npm error fatal: Could not read from remote repository.
- npm error
- npm error Please make sure you have the correct access rights
- npm error and the repository exists.
- npm error A complete log of this run can be found in: /Users/max/.npm/_logs/2026-02-11T10_06
报错原因：有一个依赖使用了 SSH 方式访问 GitHub，我们没有配置 GitHub SSH key。
解决办法：强制 Git 把 SSH 请求改为 HTTPS。
SSH key是什么？
（SSH 密钥）是一种用于远程登录验证身份的加密钥匙，通常用于：
- 登录服务器（如 Linux 服务器）
- Git 操作（如 GitHub、GitLab）
- 云服务器（AWS、阿里云等）
- 内网免密码连接
它的作用是：替代密码登录，更安全、更方便。
⑤、强制把SSH 请求改为 HTTPS
终端执行以下命令
git config --global url."https://github.com/".insteadOf "ssh:///" git config --global url."https://github.com/".insteadOf ":"
⑥、把刚才设置的“SSH → HTTPS 改写规则”显示出来，确认 Git 真的会自动替换。
git config --global --get-regexp url
⑦、清理缓存（避免之前失败的残留）
npm cache clean --force
⑧、再次安装OpenClaw
终端输入以下命令，按回车后再输入开机密码
sudo npm install -g openclaw安装成功：
⑨、验证是否安装成功
发布者：全栈程序员-站长，转载请注明出处：https://javaforall.net/252455.html原文链接：https://javaforall.net
