macOS Sequoia 部署 OpenClaw 完整教程（3种方案：一键脚本/源码编译/Docker容器）
系统要求：macOS 15 Sequoia，内存≥8GB（推荐16GB）、磁盘空闲≥1GB；Node≥22.16，官方脚本自动补齐依赖
方案一：国内一键脚本（新手首选，5分钟装好，推荐）
国内镜像加速，自动装Homebrew、Node24、Git、OpenClaw全环境
- 打开终端（Command+空格→输入Terminal）
# 国内社区一键安装脚本curl-fsSLhttps://open-claw.org.cn/install-cn.sh|bash- 脚本自动执行：
- 缺Homebrew自动安装、缺Node24自动brew安装、缺Git自动补全
- 国内pnpm镜像加速下载依赖，避免外网超时
- 刷新环境变量（zsh终端必执行）
source~/.zshrc- 验证安装
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--global3. 初始化
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 onboardOpenClaw日常运维常用命令
| 命令 | 功能 |
|---|---|
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
source~/.zshrc# 永久写入环境变量echo'export PATH="$HOME/.openclaw/bin:$PATH"'>>~/.zshrcsource~/.zshrc- Node版本过低：脚本自动升级，手动升级
brew upgrade node@24 - 权限报错：安装命令前加
sudo，或修改目录权限sudo chown -R $USER ~/.openclaw
