2026年Mac 上 2026 版 OpenClaw 安装与配置全流程

大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。

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 包管理器，一键脚本会自动处理）

步骤 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（fb… 开头）
Default model → 输入：ark/doubao-seed-2-0-pro-（豆包 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 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
检查网络，关闭代理后重试

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

http://localhost:18789

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

npm uninstall -g openclaw # 删除配置文件（可选） rm -rf ~/.openclaw