跳到主要内容

2.2 macOS 安装

本文是 macOS 一条龙实操：从安装到 onboarding，再到启动验证。
安装命令采用 OpenClaw 官方一键脚本。

一、安装前准备​

系统与环境建议​

  • macOS 可正常联网
  • Node 最低 22.16+（推荐 24.x，官方安装脚本会自动处理）
  • 准备好至少一个模型供应商 API Key（如 OpenAI / Anthropic / Google 等）

打开终端​

  1. 按 Command + Space
  2. 输入 Terminal
  3. 回车打开终端

二、安装 OpenClaw（官方一键命令）​

在终端执行：

只安装二进制文件,不启动引导程序，引导程序可后面手动启动

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

脚本会自动完成：

  • 检测系统环境
  • 处理 Node 版本（若不满足会自动安装）
  • 安装 OpenClaw CLI

注: 如果想要在安装完自动启动引导程序，请使用以下命令:

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

三、验证是否安装成功​

openclaw --version
openclaw doctor

如果 openclaw --version 输出版本号，说明 CLI 已可用。

四、运行 onboarding​

推荐命令（同时安装守护服务）：

openclaw onboard --install-daemon

你会进入交互式引导。下面按常见步骤给出“新手推荐选项”。

引导配置请看: 引导配置