1
按图打开 macOS Terminal
- - 先按 Command + Space
- - 输入 Terminal
- - 打开图里第 3 个标注指向的 Terminal 结果
零基础用户最稳的入口是 Spotlight。只要打开 Terminal，后面的命令就有地方粘贴了。
详细图文教程
macOS 从零安装小龙虾，按这 5 步走
这页按官方推荐的 macOS 路线来：打开 Terminal → 复制官方安装脚本 → 准备 DeepSeek Key → 完成 onboarding → 验证 Gateway 和控制台。 不需要你先学 Homebrew，也不需要你先自己配一堆环境变量。
开始前先准备好这 4 样
只要这四样到位，后面就是照着做。最关键的是 DeepSeek Key，等会第三步先拿。
你需要准备
- 1. 一台能联网的 Mac
- 2. 一个可用浏览器
- 3. 一个 DeepSeek API Key
- 4. 能打开 Terminal 的本机账户
这页的真实顺序
- 1. 先打开 Terminal
- 2. 再复制官方 macOS 安装命令
- 3. 再把 DeepSeek Key 准备好
- 4. 然后完成安装和 onboarding
- 5. 最后验证 Gateway 和控制台
第 1 步，先把 Terminal 打开
后面的命令都在 Terminal 里执行。最稳的打开方式，就是用 Spotlight 搜索 Terminal。
第 2 步，先确认你抄的是官方 macOS 安装命令
macOS、Linux、WSL2 用的是同一条 install.sh 脚本。先在官方页面认准这条命令，再回到 Terminal。
2
打开官方安装页，复制 macOS / Linux 命令
浏览器里打开：
https://docs.openclaw.ai/install/index- - 看图里 1，认准 macOS / Linux / WSL2 这个标签
- - 看图里 2，复制下面这条安装命令
curl -fsSL https://openclaw.ai/install.sh | bash
官方安装脚本会自动检测系统、补齐需要的依赖，并进入 onboarding。
第 3 步，把 DeepSeek API Key 先准备好
等安装脚本开始 onboarding 再临时找 Key，会特别容易乱。先把 Key 拿到手，等会直接粘贴。
3
先拿到 DeepSeek Key，再回到 Terminal
- - 先进入 API Keys 页面
- - 创建新的 Key
- - 看到完整 Key 后立刻复制，并先贴到记事本临时保存
先进入 API Keys 页面，再点 Create API Key。
完整 Key 往往只显示一次，所以创建后马上复制，不要拖。
第 4 步，回到 Terminal 完成安装和 onboarding
这一步会把 OpenClaw 真正装起来。前面准备的命令和 DeepSeek Key，都会在这里用上。
4
先运行安装脚本，再完成 DeepSeek onboarding
回到 Terminal，粘贴你刚才复制的官方命令并回车：
curl -fsSL https://openclaw.ai/install.sh | bash
脚本运行时别急着关窗口。第一次安装时，依赖检查和下载都会比想象中久一点。
正常情况下，安装脚本会继续进入 onboarding。如果它没有自动继续，按官方 Getting Started 再手动执行：
openclaw onboard --install-daemon
官方 onboarding 命令在 Getting Started 页里写得很清楚，没自动继续时就手动跑它。
平台选 DeepSeek，粘贴刚才保存的 Key，默认模型先用 deepseek-chat。
第 5 步，验证是否真的装好了
不要只看有没有报错。必须把 Gateway 状态查出来，再打开控制台发一条测试消息。
5
先查 Gateway，再打开控制台发第一条消息
openclaw gateway status
openclaw dashboard
官方验证顺序就是先看 gateway status，再执行 dashboard。
Gateway 正常监听后，再执行 dashboard。浏览器能打开控制台，就说明主链路已经通了。
真正的成功标准不是 UI 打开，而是你发测试消息后，控制台真的返回 AI 回复。