什么是 OpenClaw？
OpenClaw 是一个开源的、本地优先的个人 AI 助手平台，由 GitHub 上的 openclaw 组织维护，采用 MIT 开源协议发布。它可以让用户在自有设备上运行一个 AI 网关（Gateway），通过这个网关连接各大语言模型（如 OpenAI、Anthropic、Google 等），同时接入微信、Telegram、WhatsApp、Discord、Slack 等超过 20 个即时通讯平台，实现随时随地与 AI 助手对话。
与市面上绝大多数 AI 服务不同，OpenClaw 的设计理念是 用户自主掌控（Self-Hosted）：所有会话数据、配置文件和模型 API 密钥都存储在你自己的设备上，不经过第三方中转。网关本身仅作为一个控制平面（Control Plane），负责路由消息、管理会话和执行工具调用。截至目前，该项目在 GitHub 上已获得超过 37 万 Star，是目前最热门的个人 AI 助手项目之一。
对于 Mac 用户来说，OpenClaw 是一个绝佳的选择——它不仅支持 macOS 原生运行，还提供了专门的 macOS 菜单栏应用（Companion App），支持 Voice Wake（语音唤醒）和 Talk Mode（对话模式），可以充分发挥 MacBook 的硬件优势。下面我们将从零开始，详细介绍在苹果 Mac 电脑上完整部署 OpenClaw 的每一步操作。
系统要求与准备工作
硬件要求
OpenClaw 是一个基于 Node.js 的 TypeScript 项目，对 Mac 的硬件要求并不高。官方建议的最低配置如下：
- CPU：Intel Core i5 或 Apple Silicon（M1/M2/M3/M4 全系列支持）
- 内存：8 GB 以上（推荐 16 GB，pnpm install 编译阶段需要一定内存）
- 磁盘：10 GB 以上可用空间（用于存储日志、会话数据和插件）
- macOS 版本：macOS Ventura 13+ 或更新的版本
- 网络：稳定的互联网连接（需访问 npm registry 和模型 API）
Apple Silicon 兼容性
OpenClaw 完美支持 Apple Silicon（M 系列芯片）。在 M1/M2/M3/M4 Mac 上，Node.js 24 已经原生支持 ARM64 架构，运行效率更高、发热更少。如果你使用的是搭载 M 系列芯片的 MacBook，建议通过 Rosetta 2 兼容模式安装或直接使用 ARM64 原生版本的 Node.js。
软件环境准备
在 Mac 上部署 OpenClaw 需要以下软件环境：
- Node.js：Node 24 推荐（最低支持 Node 22.19+）
- Homebrew：（推荐）macOS 上的包管理器，用于安装 Node.js 和其他依赖
- npm / pnpm / bun：任意一种 Node 包管理器
- Git：如需从源码构建（Mac 自带或通过 Xcode Command Line Tools 安装）
- Xcode Command Line Tools：编译某些原生模块时需要
在 Mac 上安装 Node.js
如果你还没有安装 Node.js，推荐使用 Homebrew 安装：
# 安装 Homebrew（如果尚未安装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安装 Node.js 24
brew install node@24
# 将 node 加入 PATH
echo 'export PATH="/usr/local/opt/node@24/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
# 验证安装
node --version
npm --version
如果你更倾向于使用官方安装包，也可以从 nodejs.org 下载 macOS 版本的 pkg 安装包，双击运行即可完成安装。对于 Apple Silicon Mac，请选择 macOS ARM64 版本的安装包，以获得最佳性能。
在 Mac 上安装 OpenClaw（四种方式）
OpenClaw 提供了多种安装方式，下面分别介绍在 macOS 上最实用的四种。
方式一：一键安装脚本（推荐，最简单）
官方推荐的一键安装脚本能够自动检测 macOS 版本、通过 Homebrew 安装或升级 Node.js、安装 OpenClaw 并启动入门向导。这是 Mac 用户最快的方式：
curl -fsSL https://openclaw.ai/install.sh | bash
安装脚本在 macOS 上会自动执行以下步骤：检测系统架构 → 通过 Homebrew 安装/升级 Node.js → 全局安装 openclaw 包 → 运行 openclaw onboard 向导 → 安装 LaunchAgent 守护进程。整个过程大约需要 3-5 分钟，取决于网络速度。
如果你只想安装而不想立即运行向导，可以加上 –no-onboard 参数：
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
方式二：npm 全局安装（适合已管理 Node 的用户）
对于已经自行管理 Node.js 环境的 Mac 用户，可以直接使用 npm 全局安装：
npm install -g openclaw@latest
安装完成后，检查 CLI 是否可用：
openclaw --version
如果提示命令未找到，需要将 npm 全局 bin 目录添加到 PATH。macOS 上默认的 npm 全局路径为 /usr/local/lib/node_modules，将以下行写入 ~/.zshrc：
export PATH="$(npm prefix -g)/bin:$PATH"
方式三：pnpm 安装（适合偏好 pnpm 的开发者）
对于偏好 pnpm 包管理器的 Mac 用户，可以使用以下命令：
pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon
注意：pnpm 需要显式批准包含构建脚本的包，因此安装后必须运行 pnpm approve-builds -g。在 macOS 上如果遇到权限问题，可以尝试使用 sudo 或配置正确的 npm 权限。
方式四：从源码构建（适合开发者）
对于希望参与开发或自定义修改的贡献者，可以从 GitHub 检出源码并自行构建：
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
构建完成后同样可以运行 openclaw onboard 进行初始化配置。在 Mac 上构建前需要确保已安装 Xcode Command Line Tools（xcode-select –install），因为某些原生依赖需要编译。
初始化配置（Onboarding 向导）
安装完成后，运行内置的入门向导进行配置：
openclaw onboard --install-daemon
这个交互式向导在 macOS 上会带你完成以下配置：
- 选择模型提供商：OpenAI、Anthropic、Google Gemini、Groq 等主流提供商均可选择
- 配置 API 密钥：输入你选择的模型提供商的 API Key
- 设置 Gateway 端口：默认为 18789，可根据需要修改
- 配置默认渠道：可以选择初期是否启用 Telegram、iMessage、Discord 等渠道
- 安装 LaunchAgent：macOS 下会自动注册 LaunchAgent 守护进程，确保 Gateway 在系统重启后自动启动
–install-daemon 参数在 macOS 上会注册一个 LaunchAgent（~/Library/LaunchAgents/ai.openclaw.gateway.plist），这样 Gateway 就会以守护进程模式运行。与 Linux 的 systemd 不同，macOS 的 LaunchAgent 在用户登录时自动启动，退出登录时停止——非常适合个人 MacBook 的使用场景。
验证 Gateway 运行状态
配置完成后，通过以下命令验证 Gateway 是否正常运行：
openclaw gateway status
如果一切正常，在 macOS 上应该看到类似下面的输出：
- Gateway 正在监听端口 18789（HTTP）
- LaunchAgent 服务状态为 running
- 已连接到默认模型提供商
- 工作空间（Workspace）已就绪
你也可以运行诊断命令进行更全面的检查：
openclaw doctor
该命令会检查 Node 版本、配置文件完整性、API 密钥有效性、网络连接、LaunchAgent 服务状态等多项内容，是排查问题的首选工具。
启动控制面板
OpenClaw 提供了 Web 控制面板（Control UI），可以通过 Safari 或 Chrome 浏览器直接与 AI 助手对话和管理配置：
openclaw dashboard
该命令会在默认浏览器中打开 http://localhost:18789。控制面板支持：
- 直接与 AI 助手对话
- 查看和切换会话历史
- 管理已连接的渠道
- 配置模型参数和工具权限
此外，OpenClaw 还提供了 macOS 菜单栏应用（Companion App），可以从菜单栏快速访问 AI 助手，支持快捷键呼出，体验更加原生。
macOS 特殊功能：语音唤醒与对话
OpenClaw 在 macOS 上提供了两个独特的功能，充分发挥 Mac 的硬件优势：
Voice Wake（语音唤醒）
在 macOS 上，OpenClaw 支持自定义唤醒词，在 MacBook 休眠或锁屏状态下也可以唤醒 AI 助手。这对于需要在做其他事情时快速召唤 AI 的场景非常实用——比如你正在写代码、做设计或者阅读文档时，直接说出唤醒词即可启动对话。
Talk Mode（对话模式）
Talk Mode 让 OpenClaw 可以实现实时的语音对话体验。你可以像和真人交谈一样与 AI 助手对话，OpenClaw 会通过文字转语音（TTS）功能朗读回复。在 macOS 上，TTS 默认使用系统自带的语音引擎，也可以配置为 ElevenLabs 等第三方服务以获得更自然的语音效果。
Live Canvas（实时画布）
对于 Mac 用户，OpenClaw 提供了一个名为 Live Canvas 的实时画布功能。AI 助手可以在画布上动态渲染内容，包括代码预览、数据可视化、思维导图等。这是 macOS 平台独有的视觉增强体验，让 AI 交互更加直观和高效。
连接通讯渠道
OpenClaw 的强大之处在于支持连接 20+ 即时通讯平台。在 Mac 上配置渠道非常方便。
连接 iMessage
iMessage 是 Mac 用户的专属渠道，配置后可以在 Mac 的消息应用中直接与 AI 助手对话：
- 确保 Mac 上已登录 iCloud 账号并启用 iMessage
- 在 OpenClaw 配置中启用 iMessage 渠道：channels.imessage.enabled = true
- 重启 Gateway：openclaw gateway restart
- 向你自己发送一条 iMessage 即可触发 AI 回复
连接 Telegram
Telegram 是最容易配置的跨平台渠道之一：
- 在 Telegram 中搜索 @BotFather，创建新 Bot 获取 Token
- 编辑 OpenClaw 配置文件 channels.telegram.botToken
- 重启 Gateway：openclaw gateway restart
- 向你的 Bot 发送 /start 完成配对
连接 Discord
- 在 Discord Developer Portal 创建应用并生成 Bot Token
- 在 OAuth2 URL Generator 中选择 bot 和 messages.read 权限
- 将 Bot 邀请到你的服务器
- 在配置文件中设置 channels.discord.botToken
- 重启 Gateway 生效
安全与 DM 策略
由于 OpenClaw 接入的是真实的即时通讯平台，安全配置尤为重要。对于 Mac 用户的个人使用场景，默认配置已经足够安全：Gateway 绑定在 localhost，只允许本地访问。如果需要远程访问（比如从 iPhone 上连接 Mac 上的 Gateway），建议通过 Tailscale 等 VPN 方案建立安全隧道。
查看当前 DM 策略：
openclaw doctor
默认情况下，所有入站 DM 都要求配对（Pairing），即陌生用户发送消息后会收到一个配对码，只有在管理端批准后才允许继续对话。批准新用户：
openclaw pairing approve
配置文件详解
OpenClaw 的配置文件在 macOS 上位于 ~/.openclaw/config.yaml。以下是一些关键配置项：
- gateway.port：Gateway 监听端口，默认 18789
- gateway.host：绑定地址，默认 localhost
- agents.defaults.model：默认使用的 AI 模型
- agents.defaults.sandbox.mode：沙箱模式
- channels.imessage.enabled：iMessage 渠道开关（macOS 专属）
- nodes.talk.enabled：对话模式开关
- nodes.voicewake.enabled：语音唤醒开关
修改配置后需要重启 Gateway：
openclaw gateway restart
macOS 专属：菜单栏应用与快捷操作
OpenClaw 为 macOS 用户提供了原生菜单栏应用（Companion App），这是 Linux 和 Windows 用户享受不到的便利：
- 菜单栏图标：显示 Gateway 运行状态，点击即可快速访问
- 全局快捷键：设置快捷键呼出 AI 对话窗口
- 系统托盘通知：收到新消息时通过 macOS 原生通知展示
- 自动启动：登录时自动启动，无需手动操作
macOS 菜单栏应用可以从 OpenClaw 官方平台的下载页面获取，也可以从 GitHub Releases 页面下载最新版本。
使用 OpenClaw 命令行
除了控制面板和菜单栏应用，OpenClaw 在 macOS 上提供了丰富的 CLI 命令，在终端中即可完成所有操作：
- openclaw gateway status|start|stop|restart：管理 Gateway 进程
- openclaw agent –message “内容”：直接向 AI 助手发送消息
- openclaw message send –target 号码 –message “内容”：向指定渠道发送消息
- openclaw session list|get|delete：管理会话
- openclaw pairing approve|list|revoke：管理用户配对
- openclaw update：更新 OpenClaw 到最新版本
- openclaw doctor：运行健康诊断
更新与维护
OpenClaw 的更新频率较高，建议定期更新到最新版本以获得新功能和安全修复：
openclaw update
如果是从 npm 安装的：
npm update -g openclaw@latest
openclaw gateway restart
日常维护建议：
- 定期运行 openclaw doctor 检查系统健康状态
- 监控日志文件 ~/.openclaw/logs/ 排查异常
- 通过 brew update && brew upgrade node@24 保持 Node.js 版本最新
- 定期清理不再需要的会话历史以释放磁盘空间
- 关注 GitHub Releases 页面获取新版本通知
常见问题 FAQ
问：OpenClaw 在 Apple Silicon（M1/M2/M3/M4）上运行效果如何？
答：OpenClaw 在 Apple Silicon Mac 上运行非常流畅。Node.js 24 已经完全支持 ARM64 架构，所有依赖包都能正常运行。M 系列芯片的低功耗特性使其非常适合 7×24 小时运行 Gateway 服务，不会像 Intel Mac 那样发热严重。
问：Gateway 端口 18789 被占用怎么办？
答：在配置文件中修改 gateway.port 为其他可用端口（如 18889），或使用 –port 参数启动：openclaw gateway –port 18889。在 macOS 上可以通过 lsof -i :18789 查看哪个进程占用了该端口。
问：安装时报 Error: EACCES 权限错误怎么办？
答：macOS 上 npm 全局安装权限不足时，建议配置 npm prefix 为用户目录：npm config set prefix ~/.npm-global，并将 ~/.npm-global/bin 加入 PATH。也可以使用 sudo npm install -g openclaw@latest，但不推荐。更多系统工具和资源请访问 IT峰哥软件库 pan.92zl.cn。
问：如何设置开机自启动？
答：运行 openclaw onboard –install-daemon 会自动在 macOS 上注册 LaunchAgent。如果你希望手动管理，可以运行 openclaw gateway install 安装服务，或运行 openclaw gateway uninstall 移除服务。
问：Gateway 日志在哪里查看？
答：默认日志路径为 ~/.openclaw/logs/，在 macOS 上可以使用 log show –predicate ‘process == “openclaw”‘ –last 1h 通过统一日志系统查看。
问：如何卸载 OpenClaw？
答：运行 openclaw gateway stop && openclaw gateway uninstall && npm uninstall -g openclaw，然后删除 ~/.openclaw 目录即可完全移除。
问：macOS 菜单栏应用无法启动怎么办？
答：首先确认 Gateway 正在运行（openclaw gateway status），然后检查菜单栏应用是否下载了最新版本。如果仍然无法启动，尝试重新下载安装包或从 GitHub Releases 页面获取最新的 .dmg 文件。
总结
OpenClaw 是一个功能完善、生态丰富的自托管 AI 助手平台，在苹果 Mac 电脑上部署后，可以充分发挥 macOS 平台的硬件优势，实现语音唤醒、对话模式、菜单栏应用等原生体验。通过 Gateway 打通 iMessage、Telegram、Discord 等多个通讯渠道，你可以随时随地与 AI 助手保持连接。
从 Homebrew 安装 Node.js 到一键脚本部署 OpenClaw，从 Onboarding 初始化到渠道配置，再到语音唤醒和菜单栏应用的体验优化——本文涵盖了在苹果 Mac 上完整部署 OpenClaw 的全部关键环节。无论你是使用 M 系列芯片的 MacBook 还是 Intel Mac，都能按照上面的步骤快速搭建属于自己的 AI 助手平台。
如果你需要更多 macOS 系统工具和软件资源，欢迎访问 IT峰哥软件库 获取更多有用的资源。
