openclaw doctor 能跑
说明 CLI 已经进入可用状态。
一句话总结
对于大多数普通用户来说，macOS 是 OpenClaw 最容易跑通的一条安装路线。打开终端、执行官方安装脚本、完成 onboarding、确认 Dashboard 能打开，这篇的任务就完成了。
macOS Install
Mac 用户的安装路线通常最简单，按顺序做就行。
如果你用的是 MacBook、iMac 或 Mac mini，这通常是 OpenClaw 最省心的一条安装路线。你基本只需要打开终端、运行官方安装脚本，然后完成 onboarding，就能看到 Dashboard。
Mac 主路线
8-15 分钟
适合第一次安装
Before You Start
开始前先知道 3 件事
Mac 这条路最容易成功，但有些判断还是提前知道更好。
大多数 Mac 都能走这条路
你不需要额外装 WSL2，也不用先研究服务管理。对普通用户来说，macOS 是最接近“一路到底”的环境。
Apple Silicon 没问题
M1 / M2 / M3 / M4 都可以用，不需要因为芯片架构额外绕路。
真正容易卡住的是网络
Mac 安装的主要问题通常不是系统兼容，而是下载 Node、npm 依赖或安装脚本时的网络状态。
先跑通，再补高级配置
第一次安装的目标只是让 Dashboard 打开，不用一开始就把代理、服务和本地模型全部配满。
Overview
整个安装过程其实只有 4 步
你可以先扫一遍，再从下面的教程步骤开始逐步执行。
01
打开终端
进入 macOS 自带 Terminal，就可以开始了。
02
运行官方安装脚本
让系统自动处理 Node 检测和 OpenClaw 安装。
03
完成 onboarding
完成基础配置，并准备好 Gateway。
04
验证 Dashboard
确认系统已经真正跑通，而不是只装完命令。
第 1 步：打开终端
按 Command + Space 打开 Spotlight，输入 Terminal 或“终端”，回车即可。
如果你想先看一眼当前 Node 版本，也可以执行：
node --version看到 v22 或更高版本当然更好；如果没有，也没关系，官方安装脚本通常会处理。
第 2 步：运行官方安装脚本
在终端里直接执行：
curl -fsSL https://openclaw.ai/install.sh | bash这条命令会处理 Node 检测、OpenClaw 安装，并通常直接进入 onboarding。这里建议直接用官方脚本地址，不要一开始就切到第三方镜像脚本。
第 3 步：如果下载慢，先加代理再重试
Mac 上真正容易卡住的地方通常是网络，而不是系统。你如果已经在用 Clash、Surge 或其他代理工具，可以先临时设置：
export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890然后再重新执行安装脚本。这里的端口用你自己本机代理端口替换。
第 4 步：完成 onboarding
官方安装脚本通常会自动进入 onboarding。如果没有自动进入，你可以手动执行：
openclaw onboard --install-daemon这一步会把安装后的基础配置补齐，包括后续运行 Gateway 所需的准备。
第 5 步：检查状态并打开 Dashboard
安装完成后，建议按顺序执行：
openclaw doctor
openclaw gateway status
openclaw dashboard如果浏览器正常打开，或者你手动访问 http://127.0.0.1:18789/ 能看到页面，就说明这条 macOS 路线已经跑通了。
Success Check
怎样才算安装成功
不要只看脚本执行完了没，真正的成功标准是下面这些结果能出现。
openclaw gateway status 有结果
说明网关服务至少已经进入可检查状态。
Dashboard 能打开
只要 Dashboard 正常出来，就说明你已经跨过安装阶段了。
终端里能继续执行 openclaw 命令
说明 PATH 和 CLI 基本已经正常，不只是脚本临时跑了一次。
Troubleshooting
Mac 最常见的 4 个小问题
大多数 Mac 用户的问题都集中在这几个点上。
没有 curl 或命令行工具异常
先试
xcode-select --install，把 Apple 命令行工具补上。
安装卡在 Node 或 npm 下载
先排查网络，再考虑手动装 Node。大多数情况下，代理比单独折腾 Node 更有效。
Dashboard 打不开
先跑
openclaw gateway status，有需要就执行 openclaw gateway restart。
装完找不到 openclaw 命令
通常是 PATH 问题，先检查
npm prefix -g 和 echo "$PATH"。
Common Commands
以后最常用的几个命令
Mac 用户后面基本只会频繁用到这一小组命令。
openclaw dashboard
openclaw doctor
openclaw gateway status
openclaw update