环境要求
· 系统：macOS / Linux / Windows（官方推荐 Windows 走 WSL2，更稳）
· Node.js ≥ 22（node -v 检查；这是硬门槛，低于 22 装完也跑不起来）
· 一个模型 API Key（官方推荐 Anthropic Claude；OpenAI/OpenRouter 等也支持）
· 硬件无特殊要求——重活都由模型 API 在云端干，本地只跑网关和工具
方式一：官方脚本安装（推荐）
curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash
脚本会装 CLI 并可直接进入新手引导。常用标志：--install-method npm|git 选安装方式、--no-onboard 跳过引导、--dry-run 只看不装。
方式二：包管理器
npm install -g openclaw@latest
pnpm add -g openclaw@latest
注意：如果全局装了 libvips（macOS Homebrew 常见）导致 sharp 模块编译失败，用 pnpm approve-builds -g 批准 openclaw 等包的预构建二进制，或设 SHARP_IGNORE_GLOBAL_LIBVIPS=1。
方式三：源码构建（开发者）
git clone https://github.com/openclaw/openclaw.git
cd openclaw && pnpm install && pnpm ui:build && pnpm build
openclaw onboard --install-daemon
新手引导逐步走
安装完敲 openclaw onboard --install-daemon，向导依次问四件事：
① 本地 vs 远程网关——个人使用选本地；
② 模型认证——选 API Key 方式粘贴（Anthropic 推荐 Key 方式，也支持 Claude Code 订阅 OAuth：claude setup-token）；
③ 聊天渠道——可以先全部跳过，跑通再说（下一步详见渠道接入）；
④ 守护进程——选安装，后台常驻开机自启（launchd/systemd，WSL2 用 systemd）。
向导还会生成一个 Gateway 令牌存进 gateway.auth.token，凭证统一在 ~/.openclaw/。
首次对话闭环
引导结束会给 WebChat 本地地址，浏览器打开输入"你好"，收到回复 = 闭环成功 🎉。然后花两分钟敲一条 openclaw doctor（如有）或 openclaw configure 检查配置健康度，进入下一站配置详解。