如何3分钟本地安装OpenClaw Agent？2026年最新分步教程

引言

欢迎来到 OpenClaw 中国社区。本指南旨在帮助您在几分钟内，于本地计算机上成功部署并运行一个纯净、安全的 OpenClaw Agent。无论您是希望快速体验其核心功能，还是准备进行深度开发，本文都将提供清晰的步骤指引。

系统要求

在开始安装之前，请确保您的开发环境满足以下最低要求。

• Node.js >= 22 (下载 Node.js v22)
• 操作系统: macOS, Linux，或通过 WSL2 运行的 Windows (推荐 Ubuntu 发行版)
  • macOS: 如果您计划进行应用构建，请安装 Xcode 或 Command Line Tools。若仅使用 CLI 和 Gateway 网关功能，则 Node.js 环境已足够。
  • Windows: 强烈推荐使用 WSL2。原生 Windows 环境未经充分测试，可能遇到较多问题且工具链兼容性较差。

快速安装（推荐）

对于大多数用户，我们推荐使用官方安装脚本，它能自动设置命令行工具并运行新手引导流程。

适用于 macOS、Linux 及 WSL2

在终端中执行以下命令：

curl -fsSL https://open-claw.org.cn/install-cn.sh | bash

适用于 Windows (PowerShell)

请注意，安装脚本在原生 Windows 环境下不会自动安装 Git，需要您手动先行安装。

• Git: 用于代码管理 (下载 Git)

以管理员身份运行 PowerShell，然后执行：

iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

从源代码安装（开发者/贡献者）

OpenClaw CN 集成了最新的底层安全机制与现代化构建工具链。若您选择从源代码构建，请严格遵循以下环境配置。

• Node.js: 必须 >= v22.0.0 (下载 Node.js v22)
• 包管理器: 强制推荐使用 pnpm。使用 npm 在处理复杂依赖树时可能导致进程卡死。
• Git: 用于克隆代码仓库 (下载 Git)

步骤 0: 安装 pnpm

如果您尚未安装 pnpm，请首先全局安装它。

npm install -g pnpm

步骤 1: 克隆代码仓库

为确保国内用户的最佳下载速度，请从 Gitee 镜像仓库克隆代码。我们推荐切换到最新的稳定版本分支以获得最可靠的体验。

# 1. 克隆仓库
git clone https://gitee.com/OpenClaw-CN/openclaw-cn.git
cd openclaw-cn

步骤 2: 配置国内镜像源（关键步骤！）

在安装项目依赖之前，务必为 pnpm 设置国内镜像源，否则依赖下载速度将极其缓慢。

pnpm config set registry https://registry.npmmirror.com/

步骤 3: 安装依赖与项目构建

OpenClaw 是一个现代化的全栈应用。首次运行需要编译前端用户界面和后端核心服务。

# 安装项目依赖 (配置镜像后速度飞快 🚀)
pnpm install

# 构建前端界面 (首次运行时会自动安装 UI 相关依赖)
pnpm ui:build

# 构建核心服务
pnpm build

💡 提示: 由于这是在项目本地而非全局安装，后续所有 OpenClaw 命令都需要通过 pnpm openclaw ... 的形式运行。

步骤 4: 运行初始化向导

我们提供了一个交互式初始化工具，可以帮您一键完成 DeepSeek 模型的配置。

pnpm openclaw onboard --install-daemon

💡 提示: 在向导的 Select Provider 步骤中，请直接选择 DeepSeek，系统将自动完成所有必要的配置。

步骤 5: 启动服务

初始化完成后，您可以使用以下命令启动网关服务（假设网关当前已停止）。

# 启动网关 (Gateway)
pnpm openclaw gateway

如果您关闭了 Web 管理页面，可以通过以下命令重新打开。

# 打开仪表板 (Dashboard)
pnpm openclaw dashboard

安装后验证

成功安装后，您可以使用以下命令进行基本验证和状态检查。

• 快速环境检查: openclaw doctor
• 检查网关健康状态: openclaw status 与 openclaw health
• 打开管理仪表板: openclaw dashboard

您的第一个任务

当 Agent 成功启动后，您可以进入管理面板或使用交互式命令行，尝试下达第一个指令，体验其自动化执行能力。

Agent 将自动解析该任务，进行规划，调用相应的文件系统 API，并最终完成文件创建与内容写入的操作。