-
加载中…
-
macOS Installation Guide
OpenClaw on macOS
Universal Binary，Apple Silicon 与 Intel 双架构原生支持，菜单栏 Companion App 一键接管权限与 Gateway。
01 — System Requirements
macOS 版本
macOS 14 Sonoma+
最低 Sonoma · 推荐 Sequoia 15+
芯片架构
Apple Silicon / Intel
Universal Binary · M1 及以上性能最佳
Node.js
Node 24 （推荐）
最低 Node 22.19+ · 安装脚本自动处理
内存
4 GB 最低
日常建议 8 GB · 本地模型需 16–32 GB
存储空间
10 GB
OpenClaw + Node + 依赖 + 工作区
LLM API Key
至少一个
Anthropic / OpenAI / Google 等
02 — 路径 A · Companion App 安装
推荐 菜单栏 Companion App（🦞 龙虾图标）是 macOS 首选方式。它统一管理 TCC 权限申请、Gateway 生命周期、语音唤醒、屏幕录制、iMessage 集成等所有 macOS 专属能力，无需手动配置 LaunchAgent。
下载并安装 Companion App
从 GitHub Releases 下载最新的 .dmg 文件，双击挂载后将 OpenClaw.app 拖入 Applications 文件夹。
# 最新稳定版文件名格式
OpenClaw-2026.5.27.dmg
# 下载地址
https://github.com/openclaw/openclaw/releases
首次打开若弹出"无法验证开发者"提示：前往 系统设置 → 隐私与安全性 → 点击"仍要打开"。或在终端执行 xattr -cr /Applications/OpenClaw.app。
安装 CLI（App 内一键完成）
打开 OpenClaw.app，进入 General 设置标签页，点击 Install CLI 按钮。App 自动通过 npm / pnpm 安装全局 openclaw 命令。也可手动执行：
# npm（推荐）
npm install -g openclaw@latest
# 或 pnpm
pnpm add -g openclaw@latest && pnpm approve-builds -g
完成 onboarding 配置向导
CLI 安装完成后在终端运行向导。依次选择 LLM 提供商 → 填写 API Key → 是否安装 LaunchAgent 守护进程（推荐 Yes）。
openclaw onboard --install-daemon
完成后 Gateway 通过 LaunchAgent（ai.openclaw.gateway）在后台自动启动，监听端口 18789。
授予 macOS 系统权限
App 首次运行时会逐项申请以下权限，按提示点击"允许"即可。全部权限由 Companion App 统一管理，无需手动进入系统设置逐项配置。
通知Notifications
辅助功能Accessibility
屏幕录制Screen Recording
麦克风Microphone
语音识别Speech Recognition
自动化AppleScript / Automation
（可选）设置全局快捷键与开机启动
菜单栏 App 默认快捷键 ⌘⇧Space 呼出悬浮面板。添加到登录项可确保开机自动运行。
# 添加到登录项（macOS 14+）
# 系统设置 → 通用 → 登录项 → 点击 + → 选择 OpenClaw.app
# 或通过 CLI 管理 LaunchAgent
openclaw gateway install # 注册
openclaw gateway status # 查看状态
openclaw gateway restart # 重启
03 — 路径 B · 纯 CLI 安装
无需 App 适合不想安装 GUI App、仅需 CLI + Gateway 的场景（服务器、CI、脚本调用）。语音唤醒、屏幕录制、iMessage 等 macOS 专属功能在此路径下不可用。
一键安装脚本
在终端中运行以下命令。脚本自动检测系统，按需通过 Homebrew 安装 Node.js，然后安装 OpenClaw CLI 并启动 onboarding。
curl -fsSL https://openclaw.ai/install.sh | bash
完成 onboarding 并安装 LaunchAgent
安装脚本结束后会自动进入向导，也可手动触发。--install-daemon 会将 Gateway 注册为 per-user LaunchAgent，登录后自动启动。
openclaw onboard --install-daemon
管理 LaunchAgent
常用 Gateway 管理命令，适合排查启动问题或手动控制服务。
# 手动重启 LaunchAgent
launchctl kickstart -k gui/$UID/ai.openclaw.gateway
# 停止服务
launchctl bootout gui/$UID/ai.openclaw.gateway
# 查看 Gateway 实时日志
openclaw gateway logs --follow
04 — macOS 专属功能
菜单栏 App
常驻 🦞 龙虾图标
⌘⇧Space 呼出悬浮面板，随时发起对话
语音唤醒
Voice Wake 免手动触发
说出唤醒词即可开始语音对话，延迟低于 Siri
iMessage 集成
原生收发 iMessage
仅限 Mac + Apple Silicon，需辅助功能权限
屏幕 / 摄像头
screen.snapshot / camera.snap
Agent 可读取屏幕内容并拍照辅助决策
Canvas
可视化输出面板
Agent 渲染图表、Markdown、网页预览
Deep Link
openclaw:// URL scheme
从 Shortcuts / 脚本直接触发 Agent 任务
05 — 验证安装
openclaw --version
确认 CLI 已正确安装
openclaw doctor
检测配置问题并给出修复建议
openclaw gateway status
确认 Gateway 守护进程正在运行
所有检查通过后，在浏览器打开 http://localhost:18789 即可进入 OpenClaw Web 控制台。菜单栏图标变为实心表示 Gateway 已连接。
