macOS 安装

前置条件

验证 Node.js 已安装：

node --version
# 期望输出：v22.x.x 或更高

curl -fsSL https://openclaw.ai/install.sh | bash

该脚本将：

npm install -g openclaw@latest

验证安装：

openclaw --version

运行引导向导：

openclaw onboard --install-daemon

向导将引导你完成：

# 检查 Gateway 状态
openclaw gateway status

# 打开控制面板
openclaw dashboard

控制面板默认打开 http://127.0.0.1:18789/。

OpenClaw 作为 macOS 启动代理安装，实现自动启动：

# 启动守护进程
openclaw service start

# 停止守护进程
openclaw service stop

# 检查状态
openclaw service status

启动代理 plist 文件位于：

~/Library/LaunchAgents/ai.openclaw.gateway.plist

配置文件位于：

~/.openclaw/openclaw.json

如果 macOS 阻止了二进制文件：

xattr -d com.apple.quarantine $(which openclaw)

如果通过 Homebrew 安装了 Node.js，确保 PATH 包含：

export PATH="/opt/homebrew/bin:$PATH"

修复安装目录的权限：

sudo chown -R $(whoami) /usr/local/bin