跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI

Mac 系统 OpenClaw 本地 AI 执行引擎安装与配置指南

介绍在 macOS 系统(支持 Intel 及 Apple Silicon 芯片)上安装和配置开源本地 AI 执行引擎 OpenClaw 的完整流程。涵盖系统要求、依赖环境准备、两种安装方式(官方脚本一键安装与手动分步安装)、首次启动配置向导(包括模型选择与 API Key 设置)、服务启停命令以及常见问题解决方案。适用于希望部署本地自动化 AI 任务的开发者。

星云发布于 2026/3/29更新于 2026/5/2234 浏览
Mac 系统 OpenClaw 本地 AI 执行引擎安装与配置指南

OpenClaw 是一款开源本地 AI 执行引擎,可实现文件操作、终端命令执行、浏览器控制等自动化任务。以下是 Mac 安装与配置全流程,支持 Intel 及 M 系列芯片。

一、安装前准备

1. 系统与硬件要求
  • 系统:macOS 12.0+(Monterey 及以上),不支持 macOS 11 及以下
  • 芯片:Intel 全系列 / Apple Silicon(M1/M2/M3/M4 原生支持,性能更优)
  • 内存:最低 8GB,推荐 16GB+(运行本地模型更流畅)
  • 存储:至少 5GB 可用空间,推荐 20GB+ SSD
  • 必备工具:终端(Command + 空格搜索 Terminal)、稳定网络
2. 核心依赖
  • Node.js ≥ 22.0.0(官方脚本会自动检测并安装)
  • Homebrew(Mac 包管理器,一键脚本会自动处理)

二、方式一:官方一键安装

步骤 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 22(OpenClaw 必须)
brew install node@22

验证:

node -v # 需 ≥22.0.0
npm -v
步骤 3:全局安装 OpenClaw
npm install -g openclaw@latest
步骤 4:验证安装
openclaw --version

输出版本号即成功。

四、首次启动与配置向导

安装完成后,执行 openclaw 进入初始化配置,按以下步骤选择(新手推荐):

  1. Security warning → 选 Yes(个人使用默认安全)
  2. Onboarding mode → 选 QuickStart(最快配置)
  3. Gateway port → 默认 18789,直接回车
  4. Model/auth provider → 选 Volcano Engine(火山引擎,国内友好)
  5. How do you want to provide this API key? → 选 Paste API key now
  6. Enter Volcano Engine API key → 粘贴你的火山 Ark API Key
  7. Default model → 输入:ark/doubao-seed-2-0-pro-260215(豆包 Seed 2.0 专业版)
  8. Select channel → 选 Skip for now(后续可添加飞书/WhatsApp)
  9. Configure skills now? → 选 Yes,按需开启 apple-reminders、apple-notes、github 等技能
  10. Enable hooks? → 全选(boot-md、session-memory 等)
  11. 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
  • 重启终端
  • 手动添加 PATH:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
2. 权限错误
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 node@22
echo 'export PATH="/opt/homebrew/opt/node@22/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
4. 安装卡住/下载失败
  • 切换国内加速脚本: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

目录

  1. 一、安装前准备
  2. 1. 系统与硬件要求
  3. 2. 核心依赖
  4. 二、方式一:官方一键安装
  5. 步骤 1:打开终端
  6. 步骤 2:执行一键安装命令(二选一)
  7. 官方原版(推荐,海外/网络好时用)
  8. 国内加速版(网络慢/下载失败时用)
  9. 步骤 3:加载环境变量(必做,否则命令可能找不到)
  10. source ~/.bash_profile
  11. 步骤 4:验证安装成功
  12. 三、方式二:手动分步安装
  13. 步骤 1:安装 Homebrew(未装才做)
  14. 步骤 2:安装 Node.js 22(OpenClaw 必须)
  15. 步骤 3:全局安装 OpenClaw
  16. 步骤 4:验证安装
  17. 四、首次启动与配置向导
  18. 五、启动与停止 OpenClaw
  19. 前台启动(推荐,方便看日志)
  20. 后台启动(关闭终端不退出)
  21. 停止服务
  22. 查看状态
  23. 六、常见问题与解决
  24. 1. 命令找不到(command not found)
  25. 2. 权限错误
  26. 3. Node.js 版本过低
  27. 4. 安装卡住/下载失败
  28. 七、Web UI 访问(可视化操作)
  29. 八、卸载 OpenClaw(如需)
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • ChatGPT 到 AI 大模型私有化部署:企业技术选择分析
  • Java 并发编程:JUC 包中原子操作类的原理和用法
  • 从 AI 工具使用者到创作者:技术变现之路
  • Flutter 组件 tavily_dart 在鸿蒙系统下的适配与实战
  • Qwen3.5 开源发布:国产大模型性能与技术架构深度解读
  • Python 核心应用场景与开发环境配置指南
  • Clawdbot 整合 Qwen3-32B 本地部署与 18789 端口调试指南
  • 无需公网 IP 安全访问本地 AI 服务的方案
  • AI-Goofish-Monitor 闲鱼智能监控工具使用指南
  • Ubuntu 部署 OpenClaw 指南
  • 基于 Java 的同城家政智能派单系统构建
  • ClawdBot 效果展示:Whisper tiny 本地转写与 LibreTranslate 双引擎容灾
  • B 站网页版自动字幕脚本:快捷键控制与自动开启
  • Llama 3.1 本地部署指南:Ollama、OpenWeb UI 与 Spring AI
  • ClawdBot 效果展示:Whisper tiny 本地转写与 LibreTranslate 双引擎容灾
  • Clawdbot 基于 Tailscale 的内网穿透部署方案 (Linux)
  • 中国 AI 大模型产业发展现状、挑战与趋势
  • C++ 精学笔记:基础类型与语法实践
  • C 语言 Web 开发实战:CGI、FastCGI 与 Nginx 模块详解
  • 循环神经网络(RNN)与序列数据处理实战

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online