AI Agent：macOS Sequoia 部署 OpenClaw 完整教程

macOS Sequoia 部署 OpenClaw 完整教程（3种方案：一键脚本/源码编译/Docker容器）

系统要求：macOS 15 Sequoia，内存≥8GB（推荐16GB）、磁盘空闲≥1GB；Node≥22.16，官方脚本自动补齐依赖

方案一：国内一键脚本（新手首选，5分钟装好，推荐）

国内镜像加速，自动装Homebrew、Node24、Git、OpenClaw全环境

打开终端（Command+空格→输入Terminal）

bash 复制代码

# 国内社区一键安装脚本
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash

脚本自动执行：
- 缺Homebrew自动安装、缺Node24自动brew安装、缺Git自动补全
- 国内pnpm镜像加速下载依赖，避免外网超时
刷新环境变量（zsh终端必执行）

bash 复制代码

source ~/.zshrc

验证安装

bash 复制代码

openclaw --version

出现版本号即安装成功。

初始化配置（onboard向导）

bash 复制代码

# 快速初始化配置向导
openclaw onboard --flow quickstart

步骤：选择大模型（DeepSeek/通义千问/OpenAI）→粘贴模型API Key→选择消息通道（TG/本地Web面板）→完成配置
配置文件路径：~/.openclaw/openclaw.json（所有配置保存在用户目录）

方案二：官方原版一键脚本（境外网络环境）

bash 复制代码

# 国际原版安装
curl -fsSL https://openclaw.ai/install.sh | bash
source ~/.zshrc
openclaw --version

国内网络容易下载超时，优先选方案一。

方案三：源码编译部署（自定义二次开发）

适合修改源码、定制Agent功能，需要手动前置依赖

1. 前置依赖安装

bash 复制代码

# 安装命令行工具（首次安装弹出弹窗确认）
xcode-select --install
# 安装Homebrew（已装跳过）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装Node24、git
brew install node@24 git
# 全局安装pnpm+国内镜像
npm install -g pnpm
pnpm config set registry https://registry.npmmirror.com/

2. 拉取源码（国内Gitee镜像）

bash 复制代码

git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
cd openclaw-cn
# 安装依赖+编译前端面板
pnpm install
pnpm ui:build
# 全局链接openclaw命令
pnpm link --global

3. 初始化

bash 复制代码

openclaw onboard --install-daemon

方案四：Docker容器部署（隔离环境、服务器推荐）

需提前装好Docker Desktop（mac应用商店可装）

bash 复制代码

# 拉取官方镜像
docker pull openclaw/openclaw:latest
# 后台启动，挂载配置目录+映射3000端口面板
docker run -d --name openclaw \
-p 3000:3000 \
-v ~/.openclaw:/root/.openclaw \
openclaw/openclaw:latest
# 进入容器初始化
docker exec -it openclaw openclaw onboard

OpenClaw日常运维常用命令

命令	功能
`openclaw start`	前台启动网关服务
`openclaw start --detach`	后台常驻运行
`openclaw dashboard`	打开本地Web管理面板（默认http://127.0.0.1:3000）
`openclaw status`	查看网关运行状态
`openclaw health`	健康自检
`openclaw restart`	重启服务（改配置后必用）
`openclaw update`	升级到最新版

常见报错解决

command not found: openclaw

bash 复制代码

source ~/.zshrc
# 永久写入环境变量
echo 'export PATH="$HOME/.openclaw/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Node版本过低 ：脚本自动升级，手动升级brew upgrade node@24
权限报错 ：安装命令前加sudo，或修改目录权限sudo chown -R $USER ~/.openclaw