Mac 上 2026 版 OpenClaw 安装与配置全流程
OpenClaw 是一款开源本地 AI 执行引擎，可实现文件操作、终端命令执行、浏览器控制等自动化任务。以下是 2026 年最新、最省心的 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 包管理器，一键脚本会自动处理）
二、方式一：官方一键安装（新手首选，5 分钟搞定）
步骤 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
输出版本号即成功。
四、首次启动与配置（Onboarding 向导）
安装完成后，执行 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（fb… 开头）
- 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
