OpenClaw 是一款开源本地 AI 执行引擎可实现文件操作、终端命令执行、浏览器控制等自动化任务。以下是 2026 年最新、最省心的 Mac 安装与配置全流程Intel/M 系列芯片通用。一、安装前准备必看1. 系统与硬件要求系统macOS 12.0Monterey 及以上不支持 macOS 11 及以下芯片Intel 全系列 / Apple SiliconM1/M2/M3/M4 原生支持性能更优内存最低 8GB推荐 16GB运行本地模型更流畅存储至少 5GB 可用空间推荐 20GB SSD必备工具终端Command 空格搜索 Terminal、稳定网络2. 核心依赖脚本自动安装无需手动准备Node.js ≥ 22.0.0官方脚本会自动检测并安装HomebrewMac 包管理器一键脚本会自动处理二、方式一官方一键安装新手首选5 分钟搞定步骤 1打开终端快捷键Command 空格→ 输入「终端」→ 回车打开步骤 2执行一键安装命令二选一官方原版推荐海外/网络好时用curl -fsSL https://openclaw.ai/install.sh | bash国内加速版网络慢/下载失败时用curl -fsSL https://open-claw.org.cn/install-cn.sh | bash提示执行时需输入 Mac 开机密码输入不显示字符直接回车步骤 3加载环境变量必做否则命令可能找不到Mac 默认是 Zsh执行source ~/.zshrc老系统用 Bash 的话执行# source ~/.bash_profile步骤 4验证安装成功openclaw --version输出类似OpenClaw 2026.3.2 (85377a2)即安装成功。三、方式二手动分步安装适合自定义/开发者步骤 1安装 Homebrew未装才做/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)按提示输入密码等待完成。步骤 2安装 Node.js 22OpenClaw 必须brew install node22验证node -v # 需 ≥22.0.0 npm -v步骤 3全局安装 OpenClawnpm install -g openclawlatest步骤 4验证安装openclaw --version输出版本号即成功。四、首次启动与配置Onboarding 向导安装完成后执行openclaw进入初始化配置按以下步骤选择新手推荐Security warning→ 选Yes个人使用默认安全Onboarding mode→ 选QuickStart最快配置Gateway port→ 默认18789直接回车Model/auth provider→ 选Volcano Engine火山引擎国内友好How do you want to provide this API key?→ 选Paste API key nowEnter Volcano Engine API key→ 粘贴你的火山 Ark API Keyfb… 开头Default model→ 输入ark/doubao-seed-2-0-pro-260215豆包 Seed 2.0 专业版Select channel→ 选Skip for now后续可添加飞书/WhatsAppConfigure skills now?→ 选Yes按需开启apple-reminders、apple-notes、github等技能Enable hooks?→ 全选boot-md、session-memory等How do you want to hatch your bot?→ 选Hatch in TUI终端交互推荐配置完成后即可在终端与 OpenClaw 交互。五、启动与停止 OpenClaw前台启动推荐方便看日志openclaw start后台启动关闭终端不退出openclaw start --detach停止服务openclaw stop查看状态openclaw status六、常见问题与解决1. 命令找不到command not found重新加载环境变量source ~/.zshrc重启终端手动添加 PATHecho export PATH$HOME/.local/bin:$PATH ~/.zshrc source ~/.zshrc2. 权限错误sudo npm install -g openclaw或修复 npm 权限sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}3. Node.js 版本过低brew upgrade node # 或安装指定版本 brew install node22 echo export PATH/opt/homebrew/opt/node22/bin:$PATH ~/.zshrc source ~/.zshrc4. 安装卡住/下载失败切换国内加速脚本curl -fsSL https://open-claw.org.cn/install-cn.sh | bash检查网络关闭代理后重试七、Web UI 访问可视化操作启动 OpenClaw 后在浏览器访问http://localhost:18789即可通过 Web 界面与 AI 交互、管理技能、查看日志。八、卸载 OpenClaw如需npm uninstall -g openclaw # 删除配置文件可选 rm -rf ~/.openclaw
Mac 上 2026 版 OpenClaw 安装与配置全流程
发布时间：2026/5/21 9:31:47
OpenClaw 是一款开源本地 AI 执行引擎可实现文件操作、终端命令执行、浏览器控制等自动化任务。以下是 2026 年最新、最省心的 Mac 安装与配置全流程Intel/M 系列芯片通用。一、安装前准备必看1. 系统与硬件要求系统macOS 12.0Monterey 及以上不支持 macOS 11 及以下芯片Intel 全系列 / Apple SiliconM1/M2/M3/M4 原生支持性能更优内存最低 8GB推荐 16GB运行本地模型更流畅存储至少 5GB 可用空间推荐 20GB SSD必备工具终端Command 空格搜索 Terminal、稳定网络2. 核心依赖脚本自动安装无需手动准备Node.js ≥ 22.0.0官方脚本会自动检测并安装HomebrewMac 包管理器一键脚本会自动处理二、方式一官方一键安装新手首选5 分钟搞定步骤 1打开终端快捷键Command 空格→ 输入「终端」→ 回车打开步骤 2执行一键安装命令二选一官方原版推荐海外/网络好时用curl -fsSL https://openclaw.ai/install.sh | bash国内加速版网络慢/下载失败时用curl -fsSL https://open-claw.org.cn/install-cn.sh | bash提示执行时需输入 Mac 开机密码输入不显示字符直接回车步骤 3加载环境变量必做否则命令可能找不到Mac 默认是 Zsh执行source ~/.zshrc老系统用 Bash 的话执行# source ~/.bash_profile步骤 4验证安装成功openclaw --version输出类似OpenClaw 2026.3.2 (85377a2)即安装成功。三、方式二手动分步安装适合自定义/开发者步骤 1安装 Homebrew未装才做/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)按提示输入密码等待完成。步骤 2安装 Node.js 22OpenClaw 必须brew install node22验证node -v # 需 ≥22.0.0 npm -v步骤 3全局安装 OpenClawnpm install -g openclawlatest步骤 4验证安装openclaw --version输出版本号即成功。四、首次启动与配置Onboarding 向导安装完成后执行openclaw进入初始化配置按以下步骤选择新手推荐Security warning→ 选Yes个人使用默认安全Onboarding mode→ 选QuickStart最快配置Gateway port→ 默认18789直接回车Model/auth provider→ 选Volcano Engine火山引擎国内友好How do you want to provide this API key?→ 选Paste API key nowEnter Volcano Engine API key→ 粘贴你的火山 Ark API Keyfb… 开头Default model→ 输入ark/doubao-seed-2-0-pro-260215豆包 Seed 2.0 专业版Select channel→ 选Skip for now后续可添加飞书/WhatsAppConfigure skills now?→ 选Yes按需开启apple-reminders、apple-notes、github等技能Enable hooks?→ 全选boot-md、session-memory等How do you want to hatch your bot?→ 选Hatch in TUI终端交互推荐配置完成后即可在终端与 OpenClaw 交互。五、启动与停止 OpenClaw前台启动推荐方便看日志openclaw start后台启动关闭终端不退出openclaw start --detach停止服务openclaw stop查看状态openclaw status六、常见问题与解决1. 命令找不到command not found重新加载环境变量source ~/.zshrc重启终端手动添加 PATHecho export PATH$HOME/.local/bin:$PATH ~/.zshrc source ~/.zshrc2. 权限错误sudo npm install -g openclaw或修复 npm 权限sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}3. Node.js 版本过低brew upgrade node # 或安装指定版本 brew install node22 echo export PATH/opt/homebrew/opt/node22/bin:$PATH ~/.zshrc source ~/.zshrc4. 安装卡住/下载失败切换国内加速脚本curl -fsSL https://open-claw.org.cn/install-cn.sh | bash检查网络关闭代理后重试七、Web UI 访问可视化操作启动 OpenClaw 后在浏览器访问http://localhost:18789即可通过 Web 界面与 AI 交互、管理技能、查看日志。八、卸载 OpenClaw如需npm uninstall -g openclaw # 删除配置文件可选 rm -rf ~/.openclaw
