🛠️ 环境准备

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

配置国内加速 (关键！)

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

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

安装与构建

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

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

# 构建前端界面
pnpm ui:build

# 构建核心服务
pnpm build

启动初始化向导

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

pnpm openclaw onboard --install-daemon

💡 提示

在向导中，Select Provider 步骤请直接选择 DeepSeek (Recommended for CN)，系统会自动完成所有配置。

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

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

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

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

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