Phase 1 / Ep 02: macOS 原生安装 —— 5 分钟极速启动

🎯 学习目标：在 macOS 上完成 OpenClaw 安装和首次 Onboarding，确认 Gateway 正常运行。

1. 前置依赖检查

开始之前，确保你的 Mac 具备以下条件：

如果缺少 Node.js，推荐使用 nvm 安装：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
nvm install 22

2. 一键安装

打开 Terminal，执行：

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

安装脚本会：

1. 下载 OpenClaw CLI 到 ~/.openclaw/bin/
2. 将 openclaw 命令加入你的 PATH
3. 自动启动 Onboarding 向导

3. Onboarding 向导全流程

安装完成后，向导会引导你完成四个核心步骤：

graph LR
    A["1️⃣ 选择 LLM\nAnthropic / OpenAI\n/ Ollama"] --> B["2️⃣ 填写 API Key\n或配置本地模型"]
    B --> C["3️⃣ 选择 Channel\nTelegram / Discord\n/ 稍后配置"]
    C --> D["4️⃣ Daemon 配置\n开机自启 · 后台运行"]

Step 1: 选择 LLM Provider

? Select your AI provider:
  ❯ Anthropic (Claude)
    OpenAI (GPT)
    Ollama (Local)
    Other

推荐：选择 Anthropic，Claude 在工具调用方面表现最佳。

Step 2: 填写 API Key

? Enter your Anthropic API Key: sk-ant-api03-xxxx
✅ API Key validated successfully!

⚠️ API Key 仅存储在本地 ~/.openclaw/ 目录，绝不上传到任何外部服务器。

Step 3: 选择消息频道

首次安装可以选择"稍后配置"（Skip），我们在 Ep 06 详细讲解 Telegram 接入。

Step 4: Daemon 配置

? Install as background daemon (auto-start on login)?
  ❯ Yes (recommended)
    No (manual start)

选择 Yes 后，OpenClaw 会创建 macOS LaunchAgent，实现开机自启。

4. 首次健康检查

安装完成后，运行两个验证命令：

# 查看 Gateway 状态
openclaw status

# 自动诊断并修复问题
openclaw doctor

你应该看到类似输出：

🦀 OpenClaw Status
══════════════════════════════
Gateway:    ● Running (PID 12345)
Agent:      personal (default)
LLM:        Anthropic / claude-sonnet-4-20250514
Channels:   None configured
Uptime:     2m 34s

5. 关键命令速查

下节预告： Ep 03，我们用 Docker 容器化 OpenClaw，实现更安全的进程级隔离。如果你计划在 VPS 上长期运行 Agent，这种方式更推荐。