Mac 系统 OpenClaw 本地 AI 执行引擎安装与配置指南

OpenClaw 是一款开源本地 AI 执行引擎，可实现文件操作、终端命令执行、浏览器控制等自动化任务。以下是 Mac 安装与配置全流程，支持 Intel 及 M 系列芯片。

一、安装前准备

1. 系统与硬件要求

系统：macOS 12.0+（Monterey 及以上），不支持 macOS 11 及以下
芯片：Intel 全系列 / Apple Silicon（M1/M2/M3/M4 原生支持，性能更优）
内存：最低 8GB，推荐 16GB+（运行本地模型更流畅）
存储：至少 5GB 可用空间，推荐 20GB+ SSD
必备工具：终端（Command + 空格搜索 Terminal）、稳定网络

2. 核心依赖

Node.js ≥ 22.0.0（官方脚本会自动检测并安装）
Homebrew（Mac 包管理器，一键脚本会自动处理）

二、方式一：官方一键安装

步骤 1：打开终端

快捷键：Command + 空格 → 输入「终端」→ 回车打开

步骤 2：执行一键安装命令（二选一）

官方原版（推荐，海外/网络好时用）

curl -fsSL https://openclaw.ai/install.sh | bash

国内加速版（网络慢/下载失败时用）

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

提示：执行时需输入 Mac 开机密码（输入不显示字符，直接回车）

步骤 3：加载环境变量（必做，否则命令可能找不到）

Mac 默认是 Zsh，执行：

source ~/.zshrc

老系统用 Bash 的话，执行：

# source ~/.bash_profile

步骤 4：验证安装成功

openclaw --version

输出类似 OpenClaw 2026.3.2 (85377a2) 即安装成功。

三、方式二：手动分步安装

步骤 1：安装 Homebrew（未装才做）

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

按提示输入密码，等待完成。

步骤 2：安装 Node.js 22（OpenClaw 必须）

brew install node@22

验证：

node -v # 需 ≥22.0.0
npm -v

步骤 3：全局安装 OpenClaw

npm install -g openclaw@latest

步骤 4：验证安装

openclaw --version

输出版本号即成功。

四、首次启动与配置向导

安装完成后，执行 openclaw 进入初始化配置，按以下步骤选择（新手推荐）：

Security warning → 选 Yes（个人使用默认安全）
Onboarding mode → 选 QuickStart（最快配置）
Gateway port → 默认 18789，直接回车
Model/auth provider → 选 Volcano Engine（火山引擎，国内友好）
How do you want to provide this API key? → 选 Paste API key now
Enter Volcano Engine API key → 粘贴你的火山 Ark API Key
Default model → 输入：ark/doubao-seed-2-0-pro-260215（豆包 Seed 2.0 专业版）
Select channel → 选 Skip for now（后续可添加飞书/WhatsApp）
Configure skills now? → 选 Yes，按需开启 apple-reminders、apple-notes、github 等技能
Enable hooks? → 全选（boot-md、session-memory 等）
How do you want to hatch your bot? → 选 Hatch in TUI（终端交互，推荐）

配置完成后，即可在终端与 OpenClaw 交互。

五、启动与停止 OpenClaw

前台启动（推荐，方便看日志）

openclaw start

后台启动（关闭终端不退出）

openclaw start --detach

停止服务

openclaw stop

查看状态

openclaw status

六、常见问题与解决

1. 命令找不到（command not found）

重新加载环境变量：source ~/.zshrc
重启终端
手动添加 PATH：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

2. 权限错误

sudo npm install -g openclaw

或修复 npm 权限：

sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}

3. Node.js 版本过低

brew upgrade node # 或安装指定版本 brew install node@22
echo 'export PATH="/opt/homebrew/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

4. 安装卡住/下载失败

切换国内加速脚本：curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
检查网络，关闭代理后重试

七、Web UI 访问（可视化操作）

启动 OpenClaw 后，在浏览器访问：

http://localhost:18789

即可通过 Web 界面与 AI 交互、管理技能、查看日志。

八、卸载 OpenClaw（如需）

npm uninstall -g openclaw
rm -rf ~/.openclaw

Mac 系统 OpenClaw 本地 AI 执行引擎安装与配置指南

一、安装前准备

1. 系统与硬件要求

2. 核心依赖

二、方式一：官方一键安装

步骤 1：打开终端

步骤 2：执行一键安装命令（二选一）

官方原版（推荐，海外/网络好时用）

国内加速版（网络慢/下载失败时用）

步骤 3：加载环境变量（必做，否则命令可能找不到）

步骤 4：验证安装成功

三、方式二：手动分步安装

步骤 1：安装 Homebrew（未装才做）

步骤 2：安装 Node.js 22（OpenClaw 必须）

步骤 3：全局安装 OpenClaw

步骤 4：验证安装

四、首次启动与配置向导

五、启动与停止 OpenClaw

前台启动（推荐，方便看日志）

后台启动（关闭终端不退出）

停止服务

查看状态

六、常见问题与解决

1. 命令找不到（command not found）

2. 权限错误

3. Node.js 版本过低

4. 安装卡住/下载失败

七、Web UI 访问（可视化操作）

八、卸载 OpenClaw（如需）

更多推荐文章

相关免费在线工具

Mac 系统 OpenClaw 本地 AI 执行引擎安装与配置指南

一、安装前准备

1. 系统与硬件要求

2. 核心依赖

二、方式一：官方一键安装

步骤 1：打开终端

步骤 2：执行一键安装命令（二选一）

官方原版（推荐，海外/网络好时用）

国内加速版（网络慢/下载失败时用）

步骤 3：加载环境变量（必做，否则命令可能找不到）

步骤 4：验证安装成功

三、方式二：手动分步安装

步骤 1：安装 Homebrew（未装才做）

步骤 2：安装 Node.js 22（OpenClaw 必须）

步骤 3：全局安装 OpenClaw

步骤 4：验证安装

四、首次启动与配置向导

五、启动与停止 OpenClaw

前台启动（推荐，方便看日志）

后台启动（关闭终端不退出）

停止服务

查看状态

六、常见问题与解决

1. 命令找不到（command not found）

2. 权限错误

3. Node.js 版本过低

4. 安装卡住/下载失败

七、Web UI 访问（可视化操作）

八、卸载 OpenClaw（如需）

微信扫一扫，关注极客日志

更多推荐文章

相关免费在线工具