macOS Sequoia 部署 OpenClaw 完整教程3种方案一键脚本/源码编译/Docker容器系统要求macOS 15 Sequoia内存≥8GB推荐16GB、磁盘空闲≥1GBNode≥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、gitbrewinstallnode24git# 全局安装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 Desktopmac应用商店可装# 拉取官方镜像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:3000openclaw status查看网关运行状态openclaw health健康自检openclaw restart重启服务改配置后必用openclaw update升级到最新版常见报错解决command not found: openclawsource~/.zshrc# 永久写入环境变量echoexport PATH$HOME/.openclaw/bin:$PATH~/.zshrcsource~/.zshrcNode版本过低脚本自动升级手动升级brew upgrade node24权限报错安装命令前加sudo或修改目录权限sudo chown -R $USER ~/.openclaw
AI Agent：macOS Sequoia 部署 OpenClaw 完整教程
macOS Sequoia 部署 OpenClaw 完整教程3种方案一键脚本/源码编译/Docker容器系统要求macOS 15 Sequoia内存≥8GB推荐16GB、磁盘空闲≥1GBNode≥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、gitbrewinstallnode24git# 全局安装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 Desktopmac应用商店可装# 拉取官方镜像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:3000openclaw status查看网关运行状态openclaw health健康自检openclaw restart重启服务改配置后必用openclaw update升级到最新版常见报错解决command not found: openclawsource~/.zshrc# 永久写入环境变量echoexport PATH$HOME/.openclaw/bin:$PATH~/.zshrcsource~/.zshrcNode版本过低脚本自动升级手动升级brew upgrade node24权限报错安装命令前加sudo或修改目录权限sudo chown -R $USER ~/.openclaw
