macOS
macOS 是 OpenClaw 的 Tier 1（一级支持）平台，提供最完整的功能体验。本文介绍在 macOS 上的安装、配置和特有功能。
系统要求
| 项目 | 要求 |
|---|---|
| macOS 版本 | 13 (Ventura) 及以上 |
| 芯片 | Apple Silicon (M1/M2/M3/M4) 或 Intel |
| 内存 | 4 GB+（推荐 8 GB+） |
| 磁盘 | 10 GB 可用空间 |
Apple Silicon 优化
OpenClaw 在 Apple Silicon 上原生运行，性能优于 Intel 机型。本地模型推理可利用 Neural Engine 加速。
安装方式
Homebrew（推荐）
bash
brew install openclawpkg 安装包
从 GitHub Releases 下载 .pkg 安装包，双击安装。
手动安装
bash
# 克隆仓库
git clone https://github.com/OpenClaw/OpenClaw.git
cd OpenClaw
# 安装依赖
npm install
# 启动
npm startDocker
bash
docker run -d \
--name openclaw \
-p 7681:7681 \
-v openclaw-data:/app/data \
openclaw/openclaw:latestTCC 权限配置
macOS 的 TCC（Transparency, Consent, and Control，透明度、同意与控制）系统要求应用明确获得权限。OpenClaw 需要以下权限：
Full Disk Access（完全磁盘访问）
Agent 操作文件时需要此权限：
- 打开「系统设置 → 隐私与安全性 → 完全磁盘访问权限」
- 点击
+，添加你的终端应用（Terminal / iTerm2 / Warp） - 重启终端
Automation（自动化权限）
Agent 控制其他应用（如 Finder、Safari）时需要：
- 首次触发时系统会自动弹窗询问
- 也可以在「系统设置 → 隐私与安全性 → 自动化」中手动开启
麦克风和摄像头
使用音频或摄像头节点时需要：
- 打开「系统设置 → 隐私与安全性 → 麦克风」
- 允许终端应用访问
- 摄像头权限同理
权限重置
如果权限设置后仍然无法访问，尝试重置 TCC 数据库：
bash
tccutil reset All com.apple.Terminal然后重启终端，系统会重新询问权限。
macOS 特有功能
iMessage 集成
在 macOS 上，OpenClaw 可以直接读取和发送 iMessage：
yaml
channels:
imessage:
enabled: true
read_receipts: true仅限 macOS
iMessage 集成依赖 macOS 原生框架，仅在 macOS 上可用。需要 Full Disk Access 权限访问 Messages 数据库。
Shortcuts（快捷指令）集成
OpenClaw 可以触发 macOS 快捷指令：
yaml
tools:
shortcuts:
enabled: true
allowed:
- "开启勿扰模式"
- "播放音乐"
- "发送邮件"系统音频捕获
macOS 支持捕获系统音频输出（需要安装虚拟音频驱动）：
bash
# 安装 BlackHole 虚拟音频驱动
brew install blackhole-2ch
# 使用系统音频作为输入
openclaw node --type audio --device "BlackHole 2ch"launchd 服务配置
使用 launchd 将 OpenClaw 网关设置为系统服务，开机自动启动：
bash
# 安装服务
openclaw daemon install
# 启动服务
openclaw daemon start
# 查看状态
openclaw daemon status
# 停止服务
openclaw daemon stop
# 卸载服务
openclaw daemon uninstall手动创建 plist 文件：
xml
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
"http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key>
<string>com.openclaw.gateway</string>
<key>ProgramArguments</key>
<array>
<string>/opt/homebrew/bin/openclaw</string>
<string>gateway</string>
<string>start</string>
</array>
<key>RunAtLoad</key>
<true/>
<key>KeepAlive</key>
<true/>
<key>StandardOutPath</key>
<string>/tmp/openclaw.log</string>
<key>StandardErrorPath</key>
<string>/tmp/openclaw-error.log</string>
</dict>
</plist>bash
# 加载服务
launchctl load ~/Library/LaunchAgents/com.openclaw.gateway.plist
# 卸载服务
launchctl unload ~/Library/LaunchAgents/com.openclaw.gateway.plist故障排查
Homebrew 安装失败
bash
# 更新 Homebrew
brew update
# 清理缓存重试
brew cleanup
brew install openclaw权限相关问题
bash
# 检查当前权限状态
openclaw doctor --check permissions
# 列出需要的权限
openclaw doctor --list-permissionsApple Silicon 兼容性
如果遇到 Bad CPU type in executable 错误：
bash
# 确认是否在 Rosetta 下运行
arch
# 如果输出 i386，重新安装 ARM 原生版本
arch -arm64 brew reinstall openclaw端口冲突
bash
# 检查端口占用
lsof -i :7681
# 使用其他端口
openclaw gateway start --port 7682🇨🇳 中国用户须知
macOS 在中国完全可用，无特殊限制。以下是一些优化建议：
- Homebrew 加速：使用清华/中科大镜像加速 Homebrew：
bash
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"- npm 镜像：安装时使用淘宝 npm 镜像
- iMessage：在中国 iMessage 正常可用，适合与 iPhone 用户交互