Mac 安装 OpenClaw 教程：零基础上手，附常见报错解决方案

安装前先确认：你用的是哪款 Mac？

1. 点击屏幕左上角苹果图标 → 「关于本机」

2. 看「芯片」那一栏，确认是 Apple 芯片（M1 / M2 / M3 / M4） 还是 Intel 处理器。

系统版本小于 10.15 的时候，无法稳定运行 Node.js 18 的版本，无法安装 OpenClaw，需要先升级 – M 系列芯片可以直接装 Node.js 22 以上的版本

步骤一：打开终端

1. 按键盘上的 Command + 空格（ spotlight 搜索）

2. 输入「终端」或「Terminal」

3. 回车，打开一个黑色窗口

成功标志： 看到类似 用户名@电脑名 ~ % 这样的提示符

步骤二：检查 Node.js 版本

在终端里粘贴以下命令，回车：

node -v

如果显示 v22 或更高版本

（例如 v22.10.0、v23.5.0）→ 直接跳到步骤三。

如果显示更低的版本号，或者显示「command not found」

→ 需要先装 Node.js，继续往下看。

装 Node.js（国内用户推荐换镜像）

先安装Homebrew 在终端输入：

/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

等进程结束后，验证是否安装完成，在终端输入

brew --version

开始安装 node.js，在终端输入

brew install node

安装完成后，验证是否安装完成，在终端输入

node -v

npm -v

出现版本号（数字）表示安装成功！

步骤三：一键安装 OpenClaw

确认 Node.js 版本够新之后，复制粘贴这条命令，回车：

curl -fsSL https://clawd.org.cn/install.sh | bash

安装运行需要一段时间，请耐心等待。

步骤四：运行初始化向导

一般来说，安装完它会自动进入向导。如果你没有进入的话，再运行这一行；如果你进入的话，就不用管了。

进入向导，在终端里运行：

openclaw onboard

这会启动一个交互式向导，帮你：

1. 选择要用的 AI 模型

2. 完成基本配置

跟着屏幕提示走就行，全部选默认项也可以。然后一路回车下去就完成了！

步骤五：验证安装成功

运行这两条命令，都应该看到状态输出而不是报错：

openclaw status
openclaw health

成功标志： 看到类似「OpenClaw is running」的信息，无红色报错。

步骤六：启动 OpenClaw

openclaw gateway start

看到类似「Gateway started」或「Server running」的提示后，打开浏览器访问：

http://localhost:18789

如果命令里显示了不同的端口，以实际显示的为准。

步骤七：和 OpenClaw 聊天

在终端输入

openclaw tui

就可以和🦞聊上天了

常见问题与应对

报错：「command not found: openclaw」

原因： 安装脚本没有成功把 openclaw 加入 PATH

解决： 重启终端（关掉再打开），再试 openclaw status

报错：「sharp 构建失败」或「Optional dependency sharp missing」

原因： 图形处理依赖没装好（通常和网络有关）

解决： 运行以下命令后重试：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

完成后提示「找不到命令」但重开终端好了

这是正常的。macOS 需要重启终端才能让新安装的命令生效。