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