Mac上运行OpenClaw需满足macOS 12+、安装Homebrew、Node.js 22.x LTS，并通过一键脚本或npm全局安装，最后执行openclaw setup完成初始化配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您希望在Mac系统上成功运行OpenClaw，但尚未完成安装配置，则可能是由于依赖缺失、Node.js版本不匹配或网络源访问受限所致。以下是解决此问题的步骤：
一、验证系统与环境准备
OpenClaw要求macOS 12（Monterey）及以上版本，兼容Intel与Apple Silicon芯片。安装前需确认系统版本、磁盘空间及网络连通性。磁盘建议预留5GB以上，全程需联网以下载依赖和模型。
1、打开「终端」：按Command + 空格，输入Terminal并回车。
2、执行命令查看系统版本：sw_vers。
3、检查是否已安装Homebrew：brew --version；若报错，则需进入下一步安装。
二、安装Homebrew（包管理器）
Homebrew是Mac下统一管理开发工具的核心组件，可自动处理Xcode命令行工具、Git等前置依赖。国内用户推荐使用阿里云或清华镜像源加速安装。
1、先确保Xcode命令行工具已就绪：xcode-select --install，按提示完成安装。
2、执行国内镜像安装脚本（推荐）：/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"。
3、安装完成后，将Homebrew路径写入shell配置：echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile && source ~/.zprofile（M系列芯片路径为/opt/homebrew/bin，Intel为/usr/local/bin）。
4、验证：brew --version输出版本号即成功。
三、安装Node.js 22.x LTS
OpenClaw强制要求Node.js ≥ v22.0.0，低版本将导致启动失败或编译错误。必须使用LTS稳定版，并确保npm同步可用。
1、通过Homebrew安装：brew install node@22。
2、将node@22的bin目录加入PATH：echo 'export PATH="/usr/local/opt/node@22/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc（Intel）或echo 'export PATH="/opt/homebrew/opt/node@22/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc（Apple Silicon）。
3、验证版本：node -v应显示v22.x.x，npm -v应≥9.0.0。
4、配置npm国内镜像（避免超时）：npm config set registry https://registry.npmmirror.com。
四、安装OpenClaw（两种可靠方式）
官方提供一键脚本与手动安装双路径，适用于不同网络与权限场景。任选其一即可完成核心安装。
1、方式一：官方一键安装（推荐新手）
在终端执行：curl -fsSL https://openclaw.ai/install.sh | bash。
脚本将自动检测并安装Node.js（未装时）、下载OpenClaw、配置环境变量，耗时约2–5分钟。
2、方式二：手动全局安装（适合已有Node环境）
执行：npm install -g openclaw@latest --registry=https://registry.npmmirror.com。
安装后验证：openclaw --version，输出如2026.3.2即成功。
五、初始化配置向导
首次运行OpenClaw必须执行交互式配置，完成安全确认、基础服务设置与模型接入准备。该步骤不可跳过，否则Web UI无法启动。
1、启动向导：openclaw setup（或首次运行openclaw时自动触发）。
2、当出现ASCII艺术与安全提示时，使用键盘左右键选择Yes确认风险知悉。
3、引导模式选择：QuickStart（推荐新手），使用默认配置快速启用服务。
4、模型来源选择：若需自定义大模型，此处可配置API Key；若仅本地体验，可暂选默认选项继续。
