⚡ 快速开始 #

欢迎来到 OpenClaw 中国社区。本指南将帮助你在 3 分钟内，在本地电脑上启动并运行一个纯净、安全的 OpenClaw Agent。

🛠️ 环境准备 #

OpenClaw CN 引入了最新的底层安全机制与构建工具，请确保环境满足以下要求：

• Node.js：必须 >= v22.0.0 (下载 Node.js v22)
• 包管理器：强制推荐使用 pnpm (npm 在处理依赖树时可能会卡死)
• Git：用于下载代码 (下载 Git)

安装 pnpm (如果你还没有) #

npm install -g pnpm

🚀 安装步骤 #

1. 下载代码与版本选择 #

为了确保国内访问速度，请从 Gitee 镜像仓库下载。 为了获得最稳定的体验，推荐切换到最新的稳定版分支：

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

# 2. (推荐) 切换到稳定版分支，例如：v2026.2.2-cn
# 你可以通过 git tag 查看所有版本
git checkout v2026.2.2-cn

2. 配置国内加速 (关键！) #

在安装依赖前，务必设置 pnpm 镜像源，否则下载速度会很慢：

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

3. 安装与构建 #

OpenClaw 是一个现代化的全栈应用，首次运行需要编译前端 UI 和后端核心：

# 安装依赖 (飞快 🚀)
pnpm install

# 构建前端界面
pnpm ui:build

# 构建核心服务
pnpm build

4. 启动初始化向导 #

我们提供了交互式的初始化工具，帮你一键配置 DeepSeek：

pnpm openclaw onboard --install-daemon

5. 启动服务 (初始化完成后) #

初始化完成后，你可以通过以下命令再次启动网关服务（前提是网关已经关闭）：

# 启动网关 (Gateway)
node openclaw.mjs gateway --port 18789 --verbose

如果你关闭了管理页面，可以通过以下命令再次打开：

# 打开管理面板 (Dashboard)
node openclaw.mjs dashboard

🎯 你的第一个任务 #

启动成功后，进入管理面板或交互式命令行，试着给 Agent 下达第一个指令：

"请帮我在桌面上创建一个名为 hello_openclaw.txt 的文件，并在里面写入：大道至简，实战落地。"

Agent 将会自动规划任务、调用文件系统 API，并完成操作。