最近国外的OpenClaw这个专家级助手异常火爆，围绕着其开发的各种Skills也是逐渐丰富，国内由于网络条件的原因，让很多人望而却步。想了解更深入的却总被各种专业技术门槛挡在门外。这里我用自己的亲身实践来整理出一份保姆级的尝鲜教程。我将从环境要求、前置配置（解决国内网络 / 环境变量问题）、安装步骤、常见问题修复四个维度整理，确保新手能一步步落地，避开各种踩坑。
|
环境 / 工具 |
最低版本要求 |
说明 |
|
Node.js |
v16.0.0+ |
推荐 LTS 版本（v18/v20），openclaw 依赖 Node.js 运行构建工具 |
|
pnpm |
v7.0.0+ |
openclaw 基于 monorepo 管理，必须用 pnpm 而非 npm/yarn |
|
Git |
任意稳定版 |
用于拉取 openclaw 源码 |
|
操作系统 |
Windows/macOS/Linux |
教程以 Windows 为主，macOS/Linux 仅标注差异 |
|
网络环境 |
可访问国内镜像 |
配置淘宝 /npm 镜像加速依赖安装，避免下载失败 |
步骤 1：安装 Node.js + 配置国内镜像
下载 Node.js：
- 官网（国内慢）：https://nodejs.org/zh-cn/（选 LTS 版本）
- 国内镜像（推荐）：https://nodejs.org/dist/（或阿里云镜像：https://mirrors.aliyun.com/nodejs/）
- 安装时勾选「Add to PATH」（自动配置环境变量），Windows 建议默认安装到 C:\Program Files\nodejs。
验证 Node.js 安装：
# 打开 CMD/PowerShell 执行 node -v # 输出版本号如 v20.10.0 npm -v # 输出版本号如 10.2.3配置 npm/pnpm 国内镜像（关键）：
# 配置 npm 淘宝镜像 npm config set registry https://registry.npmmirror.com # 配置 pnpm 镜像（后续安装 pnpm 后执行） pnpm config set registry https://registry.npmmirror.com步骤 2：安装 pnpm 并配置环境变量
全局安装 pnpm：
npm install -g pnpm验证 pnpm 环境变量（Windows 必做）：
-
openclaw 安装
- 执行 pnpm -v，若报错「找不到命令」，按以下步骤配置： 执行 npm config get prefix，复制输出路径（如 C:\Users\你的用户名\AppData\Roaming\npm）； 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」→ 编辑「系统变量 – Path」； 新增上述路径，保存后重启终端，重新执行 pnpm -v 验证（输出版本号即成功）。
步骤 3：安装 Git（可选，若需拉取源码）
- 下载地址：https://git-scm.com/download/win（国内镜像：https://npm.taobao.org/mirrors/git-for-windows/）
- 安装时勾选「Git Bash Here」「Add Git to PATH」，其他默认。
步骤 1：拉取 openclaw 源码（若已有源码可跳过）
直接到中国适配版Gitee官网下载：
https://gitee.com/OpenClaw-CN/openclaw-cn
OpenClaw中国适配版官网下载地址
步骤2：安装与构建
OpenClaw 是一个现代化的全栈应用，首次运行需要编译前端 UI 和后端核心：
# 安装依赖 pnpm install # 构建前端界面 pnpm ui:build # 构建核心服务 pnpm build步骤3：启动初始化向导
我们提供了交互式的初始化工具，帮你一键配置 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启动成功后，进入管理面板或交互式命令行，试着给 Agent 下达第一个指令：
“请帮我在桌面上创建一个名为 hello_openclaw.txt 的文件，并在里面写入：大道至简，实战落地。”
Agent 将会自动规划任务、调用文件系统 API，并完成操作。
至此，完结。
发布者：全栈程序员-站长，转载请注明出处：https://javaforall.net/252802.html原文链接：https://javaforall.net
