macOS安装OpenClaw完整指南

前言

macOS 是运行 OpenClaw 的理想平台之一，拥有稳定的 Unix 环境和优秀的终端体验。本文将介绍两种安装方式——Homebrew 和 npm，并详细讲解如何利用 macOS 的 launchd 实现开机自启。

环境要求

第一步：安装前置依赖

安装 Xcode 命令行工具

OpenClaw 的部分依赖在安装时需要编译原生模块，因此需要 Xcode 命令行工具：

xcode-select --install

在弹出的对话框中点击"安装"，等待下载和安装完成。

验证安装：

xcode-select -p
# 输出: /Library/Developer/CommandLineTools

安装 Homebrew

如果你还没有安装 Homebrew，执行以下命令：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Apple Silicon 用户安装完成后需要将 Homebrew 添加到 PATH：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

第二步：安装 Node.js

方式一：通过 Homebrew 安装（推荐）

brew install node@22

# 将 node@22 链接到 PATH
brew link --overwrite node@22

# 验证版本
node --version
npm --version

方式二：通过 nvm 安装

# 安装 nvm
brew install nvm

# 配置 nvm 环境
mkdir -p ~/.nvm
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo '[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && . "/opt/homebrew/opt/nvm/nvm.sh"' >> ~/.zshrc
source ~/.zshrc

# 安装 Node.js 22
nvm install 22
nvm use 22
nvm alias default 22

第三步：安装 OpenClaw

你可以选择 Homebrew 或 npm 两种方式安装。

方式一：Homebrew 安装（推荐）

brew install openclaw

Homebrew 方式的优点是自动处理依赖关系，更新也更方便。

方式二：npm 全局安装

npm install -g openclaw@latest

验证安装

openclaw --version

第四步：初始化配置

运行初始化向导：

openclaw onboard

按照提示完成以下配置：

1. 选择 AI 模型提供商（Claude / OpenAI / Ollama / Gemini / OpenRouter）
2. 输入对应的 API 密钥
3. 选择要对接的即时通讯频道
4. 确认网关端口（默认 18789）

配置文件保存在：

~/.config/openclaw/openclaw.json5

你可以用 VS Code 或其他编辑器打开进行手动调整：

code ~/.config/openclaw/openclaw.json5

第五步：启动 OpenClaw

openclaw up

成功启动后会看到：

[OpenClaw] Gateway started on port 18789
[OpenClaw] Model provider: Claude (claude-sonnet-4-20250514)
[OpenClaw] Channels: ready
[OpenClaw] Dashboard: http://localhost:18789/dashboard

常用管理命令

# 查看运行状态和环境检测
openclaw doctor

# 打开管理面板
openclaw dashboard

# 查看实时日志
openclaw logs

# 重启服务
openclaw restart

# 列出已安装的技能
openclaw skill list

第六步：配置 launchd 自动启动

macOS 使用 launchd 管理后台服务，相当于 Linux 的 systemd。以下步骤将 OpenClaw 注册为 launchd 用户级服务。

创建 plist 文件

mkdir -p ~/Library/LaunchAgents

创建 ~/Library/LaunchAgents/com.openclaw.agent.plist 文件，内容如下：

<?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.agent</string>

    <key>ProgramArguments</key>
    <array>
        <string>/opt/homebrew/bin/openclaw</string>
        <string>up</string>
    </array>

    <key>RunAtLoad</key>
    <true/>

    <key>KeepAlive</key>
    <true/>

    <key>WorkingDirectory</key>
    <string>/Users/YOUR_USERNAME</string>

    <key>StandardOutPath</key>
    <string>/Users/YOUR_USERNAME/.openclaw/logs/stdout.log</string>

    <key>StandardErrorPath</key>
    <string>/Users/YOUR_USERNAME/.openclaw/logs/stderr.log</string>

    <key>EnvironmentVariables</key>
    <dict>
        <key>PATH</key>
        <string>/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin</string>
    </dict>
</dict>
</plist>

请将 YOUR_USERNAME 替换为你的实际用户名，如果使用 npm 安装，需要将 /opt/homebrew/bin/openclaw 替换为 which openclaw 的输出路径。

创建日志目录并加载服务

# 创建日志目录
mkdir -p ~/.openclaw/logs

# 加载服务
launchctl load ~/Library/LaunchAgents/com.openclaw.agent.plist

# 确认服务已启动
launchctl list | grep openclaw

管理 launchd 服务

# 停止服务
launchctl unload ~/Library/LaunchAgents/com.openclaw.agent.plist

# 启动服务
launchctl load ~/Library/LaunchAgents/com.openclaw.agent.plist

# 查看服务状态（macOS 13+）
launchctl print gui/$(id -u)/com.openclaw.agent

macOS 专属优化技巧

允许后台网络连接

首次启动 OpenClaw 时，macOS 可能会弹出防火墙提示。点击"允许"即可。

如果错过了弹窗，可以手动添加：

1. 打开"系统设置" > "网络" > "防火墙"
2. 点击"选项"
3. 找到 Node.js 或 OpenClaw，设置为"允许传入连接"

防止 macOS 休眠中断服务

如果你的 Mac 长时间运行 OpenClaw，建议禁止系统休眠：

# 防止系统休眠（在终端中运行）
caffeinate -s &

# 或者通过系统设置调整
# 系统设置 > 锁定屏幕 > 关闭显示器后不锁定

Apple Silicon 性能优化

如果你使用 Apple Silicon Mac 运行本地模型（如 Ollama），可以利用 Metal 加速：

# 安装 Ollama
brew install ollama

# 启动 Ollama（自动使用 Metal GPU 加速）
ollama serve

# 在 openclaw.json5 中配置 Ollama 作为模型提供商

使用 iTerm2 监控

推荐使用 iTerm2 的分屏功能同时监控 OpenClaw 日志和系统资源：

# 左侧窗格：查看 OpenClaw 日志
openclaw logs

# 右侧窗格：监控系统资源
top -pid $(pgrep -f openclaw)

Homebrew 更新

使用 Homebrew 安装的用户，更新非常简单：

# 更新 Homebrew 索引
brew update

# 升级 OpenClaw
brew upgrade openclaw

# 重启服务
openclaw restart

卸载

如果需要卸载 OpenClaw：

# Homebrew 安装的情况
brew uninstall openclaw

# npm 安装的情况
npm uninstall -g openclaw

# 清理配置文件（可选）
rm -rf ~/.config/openclaw
rm -rf ~/.openclaw

# 移除 launchd 服务
launchctl unload ~/Library/LaunchAgents/com.openclaw.agent.plist
rm ~/Library/LaunchAgents/com.openclaw.agent.plist

总结

macOS 凭借其稳定的 Unix 基础和出色的硬件性能，是运行 OpenClaw 的绝佳选择。通过 Homebrew 安装可以获得最流畅的体验，配合 launchd 自动启动，你的 AI 助手将始终在线。接下来可以继续阅读频道对接和技能插件相关教程，进一步发挥 OpenClaw 的潜力。