2.3 macOS 系统安装教程

概述

一、macOS 安装优势

macOS 也是 Unix 系统，OpenClaw 可以原生运行，不需要虚拟机或 WSL，直接安装即可。

二、安装流程总览

Step 1: 安装 Homebrew（包管理器）
    ↓
Step 2: 安装 Node.js
    ↓
Step 3: 安装 OpenClaw
    ↓
Step 4: 启动 OpenClaw
    ↓
Step 5: 连接飞书渠道（可选）
    ↓
Step 6: 发送第一条消息

三、Step 1：安装 Homebrew（包管理器）

Homebrew 是 macOS 上最常用的包管理器，可以简化软件安装过程。

3.1 检查是否已安装

打开"终端"（Terminal）应用，输入：

brew --version

如果看到版本号（如 Homebrew 4.x.x），说明已安装，跳到 Step 2。

3.2 如果没安装，执行以下命令

在终端输入：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

根据提示输入你的 macOS 开机密码，等待安装完成。

3.3 验证 Homebrew 安装

brew --version

看到版本号说明安装成功。

四、Step 2：安装 Node.js

4.1 通过 Homebrew 安装

在终端输入：

brew install node@22

等待下载和安装完成（约 2-5 分钟）。

4.2 验证安装

node --version
npm --version

应该看到：

v22.x.x
10.x.x

4.3 设置 PATH（如果命令找不到）

如果输入 node --version 提示"command not found"，在终端输入：

echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

五、Step 3：安装 OpenClaw

5.1 全局安装

在终端输入：

sudo npm install -g openclaw@latest

输入你的 macOS 开机密码。

5.2 验证安装

openclaw --version

应该看到：

OpenClaw 2026.x.x

六、Step 4：启动 OpenClaw

6.1 创建工作目录

mkdir -p ~/openclaw-work
cd ~/openclaw-work

6.2 首次引导配置

openclaw onboard --install-daemon

按照提示完成配置：

• 选择语言
• 配置 AI 模型 API Key
• 配置渠道（飞书/钉钉等）

6.3 启动 Gateway

openclaw gateway start

6.4 验证服务状态

openclaw gateway status

应该看到：

Gateway is running on port 18789

七、Step 5：连接飞书渠道（可选）

如果需要飞书功能，在引导中选择飞书渠道配置，或运行：

openclaw configure

按提示输入飞书机器人的 App ID 和 App Secret。

详细步骤见 2.5 节。

八、Step 6：发送第一条消息

方式一：飞书（如果配置了渠道）

在飞书找到你的机器人，发送：

你好

方式二：网页控制台

打开浏览器访问：

http://127.0.0.1:18789/

点击 Chat 开始对话。

九、常见问题

git -C "$(brew --repo)" remote set-url origin https://mirrors.ustc.edu.cn/brew.git

sudo npm install -g openclaw@latest --registry=https://registry.npmmirror.com