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

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

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

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

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

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

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

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

source~/.zshrc

4. 验证安装

openclaw--version

出现版本号即安装成功。

初始化配置（onboard向导）

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

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

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

# 国际原版安装curl-fsSLhttps://openclaw.ai/install.sh|bashsource~/.zshrc openclaw--version

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

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

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

1. 前置依赖安装

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

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

gitclone https://gitee.com/OpenClaw-CN/openclaw-cn.gitcdopenclaw-cn# 安装依赖+编译前端面板pnpminstallpnpmui:build# 全局链接openclaw命令pnpmlink--global

3. 初始化

openclaw onboard --install-daemon

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

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

# 拉取官方镜像dockerpull openclaw/openclaw:latest# 后台启动，挂载配置目录+映射3000端口面板dockerrun-d--nameopenclaw\-p3000:3000\-v~/.openclaw:/root/.openclaw\openclaw/openclaw:latest# 进入容器初始化dockerexec-itopenclaw openclaw onboard

OpenClaw日常运维常用命令

常见报错解决

1. command not found: openclaw

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

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