Mac 本地安装 OpenClaw 指南(零基础版)

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

1. 点击屏幕左上角苹果图标 → 「关于本机」
2. 看「芯片」那一栏，确认是 Apple 芯片（M1 / M2 / M3 / M4） 还是 Intel 处理器。

步骤一：打开终端

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. 

1. 选择要用的 AI 模型
2. 完成基本配置   

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

步骤五：验证安装成功

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

openclaw statusopenclaw 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 需要重启终端才能让新安装的命令生效。