人人都会AI编程

小龙虾OpenClaw的完整安装流程

更新时间：2026-07-14

<span style="font-family:inherit;font-size:16px;font-weight:400;">OpenClaw 是一款开源、本地优先的 AI Agent 执行引擎（俗称“小龙虾”），支持 Windows / macOS / Linux / WSL2 多平台部署。以下是覆盖新手一键安装、开发者定制化安装、初始化配置与效果验证的完整安装流程。</span>

一、前置准备与系统要求

1.1 系统与硬件要求

平台
最低要求
推荐配置

Windows
Windows 10 64位及以上
Windows 11，4核8线程CPU，8GB+内存，40GB+可用磁盘空间

macOS
macOS 12+
M1及以上芯片，8GB+内存

Linux / WSL2
内核 5.0+，主流发行版
Ubuntu 22.04，4核8线程，8GB+内存

注意：WSL2 需开启硬件虚拟化，BIOS 中启用 VT-x/AMD-V。

1.2 核心依赖说明

  • 必需依赖：Node.js ≥ 22.19（推荐 Node 24 LTS 版本），一键安装脚本会自动检测并补全
  • 可选依赖：
  • Git：源码安装、技能插件拉取时需要
  • Python 3.10+：运行 Python 编写的技能插件时需要
  • 浏览器（Chrome/Edge）：网页自动化、浏览器操作技能需要

1.3 国内环境加速准备

国内用户建议提前配置 npm 镜像源，避免下载超时：

# 配置淘宝 npm 镜像
npm config set registry https://registry.npmmirror.com

二、新手推荐：官方一键脚本安装（全平台通用）

最简单、不易出错的安装方式，脚本自动检测环境、补全依赖、配置环境变量。

2.1 Windows 系统

  1. 右键开始菜单，选择 终端(管理员) 或 Windows PowerShell(管理员)，在 UAC 弹窗点击「是」。
  2. 执行官方一键安装命令：
iwr -useb https://openclaw.ai/install.ps1 | iex
  1. 国内用户若下载缓慢，使用国内镜像加速脚本：
iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex
  1. 等待脚本执行完成，全程自动完成 Node.js 检测、核心程序安装、环境变量配置。

2.2 macOS / Linux / WSL2 系统

  1. 打开系统终端。
  2. 执行官方一键安装命令：
curl -fsSL https://openclaw.ai/install.sh | bash
  1. 国内用户使用镜像加速：
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
  1. 等待脚本执行结束，安装完成后重启终端使环境变量生效。

三、Windows 可视化：GUI 一键安装包

适合完全不想接触命令行的用户，图形化界面全程引导安装。

  1. 获取安装包：从官方站点或国内镜像站下载 Openclaw-win 一键安装包。
  2. 解压文件：使用 WinRAR/7-Zip 解压到纯英文目录（禁止中文、空格、特殊字符）。

> 错误示例：D:\软件\小龙虾\；推荐示例：D:\OpenClaw\

  1. 启动安装程序：双击 Openclaw Windows 一键启动.exe，若弹出 SmartScreen 拦截，点击「更多信息 → 仍要运行」。
  2. 配置安装路径：进入欢迎页后点击「开始使用」，选择纯英文安装路径，勾选用户协议，点击「开始安装」。
  3. 等待部署：程序自动完成环境检测、依赖安装、核心文件部署、快捷方式创建，全程 3-5 分钟，请勿关闭窗口。

四、开发者方式：npm 包管理器安装

适合已有 Node.js 环境，需要精准控制版本的开发者。

  1. 验证环境：打开终端执行以下命令，确认 Node 版本符合要求：
node -v
npm -v

版本低于 v22.19 请先升级 Node.js。

  1. 全局安装 OpenClaw：
npm install -g openclaw

推荐使用 pnpm 以获得更快的安装速度和更少的磁盘占用：

pnpm add -g openclaw
  1. 验证安装：执行 openclaw --version，输出版本号即安装成功。

五、进阶方式：源码编译安装

适合二次开发、贡献代码的开发者。

  1. 前置环境：提前安装 Node.js 24+、Git、pnpm。
  2. 克隆源码仓库：
git clone https://github.com/openclaw/openclaw.git
cd openclaw
  1. 安装依赖并编译：
pnpm install
pnpm build
pnpm ui:build
  1. 全局链接使用：
pnpm link --global

链接完成后，即可在全局使用 openclaw 命令。

六、安装后初始化配置

安装完成后，需要完成初始化向导，配置大模型与核心服务。

6.1 启动初始化向导

终端执行命令进入配置流程：

openclaw onboard --install-daemon

GUI 安装包会在安装完成后自动弹出配置页面。

6.2 核心配置项

  1. 运行模式选择：新手推荐选择「Local Gateway」本地网关模式，所有数据本地运行。
  2. 工作目录设置：指定记忆文件、技能、配置的存储路径，建议选择非系统盘的纯英文目录。
  3. 大模型 API 配置：
  • 填入你使用的大模型 API Key（支持 DeepSeek、OpenAI、通义千问、Claude 等主流模型）
  • 选择默认使用的模型，配置接口地址（国内模型需填写对应代理/官方地址）
  1. Gateway 后台服务：确认安装后台守护进程，实现开机自启、后台常驻运行。

七、安装验证与功能测试

7.1 基础版本验证

终端执行命令，确认命令可用：

openclaw --version

7.2 服务状态检查

执行以下命令查看 Gateway 后台服务运行状态：

openclaw status

显示 running 即代表核心服务正常运行。

7.3 功能测试

  1. 终端输入 openclaw chat 进入对话模式，发送简单指令（如「介绍一下你自己」）。
  2. 确认 AI 可以正常回复、调用基础能力，即代表安装与配置全部完成。

八、常见问题与排错

  1. 安装下载慢/超时
  • 切换国内镜像源重新执行安装脚本
  • 手动配置 npm 镜像后再进行安装
  1. Gateway 启动失败
  • 检查端口是否被占用，默认端口冲突会导致启动失败
  • 查看日志：openclaw logs 定位具体错误
  • Windows 检查防火墙是否拦截了 Node.js 进程
  1. 命令不生效 / 找不到 openclaw
  • 重启终端/电脑，刷新环境变量
  • 检查 Node.js 的全局 bin 目录是否在系统 PATH 中
  1. 中文路径报错
  • 安装路径、工作目录必须全程使用纯英文，禁止包含中文、空格、特殊字符
  1. 第一次启动慢
  • 首次启动 Gateway 需要初始化资源，等待 1-3 分钟即可，后续启动会显著加快