目录
-
一、OpenClaw核心简介
-
二、Mac部署前置准备（系统+工具检查）
-
三、两种部署方案（新手一键版/开发者手动版）
-
四、Mac专属权限配置（必做环节）
-
五、启动验证+基础功能测试
-
六、进阶优化与扩展配置
-
七、常见报错一站式排错
-
八、总结与资源参考
一、OpenClaw核心简介
OpenClaw（社区昵称"龙虾助手"）是跨平台开源AI自动化框架，主打本地离线+云端联动模式，无需依赖复杂云服务，Mac端部署后可实现：
-
系统级控制：模拟鼠标点击、键盘输入、窗口切换，适配所有Mac桌面软件
-
视觉理解：屏幕内容抓取、UI元素定位，无API软件也能自动化操作
-
多端远程：Telegram/微信远程控制电脑，随时随地执行任务
-
本地脚本：支持Shell/Python/JS脚本调用，批量处理文件、数据整理
项目完全开源，无付费门槛，Mac端部署后占用资源低，M系列芯片运行流畅度远超Intel机型。
二、Mac部署前置准备（系统+工具检查）
2.1 系统兼容性要求
| 配置项 | 最低要求 | 推荐配置 |
|---|---|---|
| macOS版本 | macOS 12.0+（Monterey） | macOS 14.0+（Sonoma/Ventura） |
| 芯片架构 | Intel/M1/M2/M3/M4 | Apple Silicon全系列 |
| 运行内存 | 8GB | 16GB及以上 |
| 存储空间 | 5GB可用空间 | 10GB及以上 |
2.2 前置工具检查与安装
Mac部署OpenClaw依赖Homebrew （包管理器）、Xcode Command Line Tools （命令行工具）、Git/Node.js，一键复制以下命令完成前置部署：
① 安装Xcode命令行工具（必装）
bash
xcode-select --install执行后弹出安装弹窗，点击「安装」即可，无需安装完整Xcode；安装完成后验证：
bash
xcode-select -p输出/Library/Developer/CommandLineTools即为安装成功。
② 安装Homebrew（Mac必备包管理器）
bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"安装完成后验证：
bash
brew --version③ 安装Git+Node.js（运行依赖）
bash
brew install git node@22软链接Node.js到全局：
bash
brew link node@22 --force验证版本（Node需≥22.0.0）：
bash
node -v && npm -v && git --version三、两种部署方案（按需选择）
方案一：新手一键部署（推荐，5分钟搞定）
适合零基础用户，官方脚本自动配置环境、下载依赖、安装程序，全程无需手动干预：
bash
curl -fsSL https://openclaw.ai/install.sh | bash执行后输入Mac管理员密码（输入时不显示字符，正常现象），等待脚本执行完毕；安装完成后验证版本：
bash
openclaw --version若提示command not found，执行以下命令配置环境变量：
bash
# zsh终端（Mac默认） echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc source ~/.zshrc
# bash终端（旧版Mac） echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc source ~/.bashrc方案二：开发者手动部署（自定义配置）
适合需要修改源码、自定义编译的用户，步骤如下：
① 克隆开源仓库
bash
git clone https://github.com/openclaw-community/openclaw.git cd openclaw② 安装项目依赖
bash
npm install③ 全局软链接（可直接调用命令）
bash
npm link④ 验证安装
bash
openclaw --version四、Mac专属权限配置（必做！否则功能失效）
Mac系统出于安全限制，OpenClaw需手动授权辅助功能、屏幕录制、文件访问权限，步骤如下：
-
打开Mac系统设置 → 进入隐私与安全性
-
找到辅助功能：开启OpenClaw的权限开关（用于鼠标键盘模拟）
-
找到屏幕录制：开启OpenClaw的权限开关（用于视觉识别）
-
找到文件与文件夹：开启完全磁盘访问权限（用于文件读写）
-
重启终端/OpenClaw服务，权限生效
若权限列表中无OpenClaw，点击「+」手动添加，路径为/usr/local/bin/openclaw或~/.local/bin/openclaw。
五、启动验证+基础功能测试
5.1 启动OpenClaw服务
bash
# 启动服务 openclaw start
# 查看运行状态 openclaw status
# 停止服务 openclaw stop
# 重启服务 openclaw restart5.2 初始化配置向导
首次运行需执行初始化，按终端提示操作即可：
bash
# 基础初始化
openclaw onboard
# 开机自启配置（推荐）
openclaw onboard --install-daemon5.3 基础功能测试
测试文件自动化功能，验证部署有效性：
bash
# 运行官方demo
openclaw run demo
# 进入交互式聊天模式
openclaw chat在交互模式输入指令：创建test文件夹，新建hello.txt并写入Hello OpenClaw，若自动执行成功则部署完成。
5.4 Web面板访问
服务启动后，浏览器访问地址即可进入可视化面板：
bash
http://localhost:3000六、进阶优化与扩展配置
6.1 配置AI大模型（提升智能度）
编辑OpenClaw配置文件，接入OpenAI/Anthropic等模型：
bash
# 打开配置文件
open ~/.openclaw/config.yaml添加以下配置（替换为自己的API Key）：
bash
models: - name: gpt-4o provider: openai api_key: "你的OpenAI API Key" - name: claude-3-opus provider: anthropic api_key: "你的Anthropic API Key"保存后重启服务生效：openclaw restart
6.2 远程控制配置（Telegram为例）
-
Telegram搜索@BotFather，发送/newbot创建机器人，获取Token
-
执行命令绑定机器人：
bash
openclaw channel add telegram --token "你的机器人Token"- 向机器人发送/start，即可远程控制Mac
6.3 菜单栏快捷工具（Mac专属）
bash
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，输入管理员密码 |
日志排查（高级）
bash
# 查看实时日志
openclaw logs --tail 100
# 日志文件路径
~/.openclaw/logs/openclaw.log资源参考
-
OpenClaw官方文档：https://docs.openclaw.ai
-
Mac权限官方指南：https://support.apple.com/zh-cn/guide/mac-help/mh32356/mac
原创不易，转载请注明出处。