Mac 系统部署 OpenClaw 本地 AI 自动化框架指南
OpenClaw 是一款跨平台开源 AI 自动化框架,支持本地离线与云端联动。本文介绍在 macOS 系统上的完整部署流程,涵盖环境准备(Homebrew、Xcode Tools)、两种安装方案(一键脚本或手动源码)、Mac 专属权限配置(辅助功能、屏幕录制)以及启动验证与进阶优化。通过终端命令即可完成安装,支持 Shell/Python/JS 脚本调用及 Telegram/微信远程控制,适合开发者与自动化爱好者使用。

OpenClaw 是一款跨平台开源 AI 自动化框架,支持本地离线与云端联动。本文介绍在 macOS 系统上的完整部署流程,涵盖环境准备(Homebrew、Xcode Tools)、两种安装方案(一键脚本或手动源码)、Mac 专属权限配置(辅助功能、屏幕录制)以及启动验证与进阶优化。通过终端命令即可完成安装,支持 Shell/Python/JS 脚本调用及 Telegram/微信远程控制,适合开发者与自动化爱好者使用。

OpenClaw(社区昵称'龙虾助手')是跨平台开源 AI 自动化框架,主打本地离线 + 云端联动模式,无需依赖复杂云服务。Mac 端部署后可实现:
项目完全开源,无付费门槛,Mac 端部署后占用资源低,M 系列芯片运行流畅度远超 Intel 机型。
| 配置项 | 最低要求 | 推荐配置 |
|---|---|---|
| macOS 版本 | macOS 12.0+(Monterey) | macOS 14.0+(Sonoma/Ventura) |
| 芯片架构 | Intel/M1/M2/M3/M4 | Apple Silicon 全系列 |
| 运行内存 | 8GB | 16GB 及以上 |
| 存储空间 | 5GB 可用空间 | 10GB 及以上 |
Mac 部署 OpenClaw 依赖Homebrew(包管理器)、Xcode Command Line Tools(命令行工具)、Git/Node.js,一键复制以下命令完成前置部署:
xcode-select --install
执行后弹出安装弹窗,点击「安装」即可,无需安装完整 Xcode;安装完成后验证:
xcode-select -p
输出/Library/Developer/CommandLineTools即为安装成功。
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
安装完成后验证:
brew --version
brew install git node@22
软链接 Node.js 到全局:
brew link node@22 --force
验证版本(Node 需≥22.0.0):
node -v && npm -v && git --version
适合零基础用户,官方脚本自动配置环境、下载依赖、安装程序,全程无需手动干预:
curl -fsSL https://openclaw.ai/install.sh | bash
执行后输入 Mac 管理员密码(输入时不显示字符,正常现象),等待脚本执行完毕;安装完成后验证版本:
openclaw --version
若提示 command not found,执行以下命令配置环境变量:
# zsh 终端(Mac 默认)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# bash 终端(旧版 Mac)
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
适合需要修改源码、自定义编译的用户,步骤如下:
git clone https://github.com/openclaw-community/openclaw.git
cd openclaw
npm install
npm link
openclaw --version
Mac 系统出于安全限制,OpenClaw 需手动授权辅助功能、屏幕录制、文件访问权限,步骤如下:
若权限列表中无 OpenClaw,点击「+」手动添加,路径为/usr/local/bin/openclaw或~/.local/bin/openclaw。
# 启动服务
openclaw start
# 查看运行状态
openclaw status
# 停止服务
openclaw stop
# 重启服务
openclaw restart
首次运行需执行初始化,按终端提示操作即可:
# 基础初始化
openclaw onboard
# 开机自启配置(推荐)
openclaw onboard --install-daemon
测试文件自动化功能,验证部署有效性:
# 运行官方 demo
openclaw run demo
# 进入交互式聊天模式
openclaw chat
在交互模式输入指令:创建 test 文件夹,新建 hello.txt 并写入 Hello OpenClaw,若自动执行成功则部署完成。
服务启动后,浏览器访问地址即可进入可视化面板:
http://localhost:3000
编辑 OpenClaw 配置文件,接入 OpenAI/Anthropic 等模型:
# 打开配置文件
open ~/.openclaw/config.yaml
添加以下配置(替换为自己的 API Key):
models:
- name: gpt-4o
provider: openai
api_key: "你的 OpenAI API Key"
- name: claude-3-opus
provider: anthropic
api_key: "你的 Anthropic API Key"
保存后重启服务生效:openclaw restart
openclaw channel add telegram --token "你的机器人 Token"
openclaw install menubar
安装后顶部菜单栏出现 OpenClaw 图标,一键启停、查看状态。
| 报错/问题 | 原因 | 解决方案 |
|---|---|---|
| command not found: openclaw | 环境变量未配置 | 执行方案一的环境变量命令 |
| 无法模拟鼠标/键盘 | 辅助功能权限未开 | 重新授权隐私权限,重启服务 |
| 端口 3000 占用 | 其他程序占用端口 | 执行 lsof -i :3000,kill -9 进程 PID |
| Node 版本不兼容 | Node 版本<22.0.0 | brew upgrade node@22 重新安装 |
| 安装权限不足 | 非管理员账户 | 命令前加 sudo,输入管理员密码 |
# 查看实时日志
openclaw logs --tail 100
# 日志文件路径
~/.openclaw/logs/openclaw.log

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online