OpenClaw 安装与配置操作说明书

在Windows系统上从零部署OpenClaw：一份详尽的配置指南

准备在Windows上搭建OpenClaw环境？这份手把手的教程将带你走完全程。整个过程清晰直接，核心在于按顺序搭建好依赖环境，最终让OpenClaw顺利跑起来。下面，我们就从最基础的编程环境开始。

目录

前置环境：安装 Node.js → 安装千问 Coder（Qwen）→ 安装 CMake → 安装与配置 OpenClaw → 常见问题与注意事项

一、前置环境：安装 Node.js

OpenClaw的运行离不开Node.js，这是整个技术栈的基石，所以务必首先搞定它。

1.1 下载安装包

第一步是获取安装包。直接访问Node.js的中文官网，根据你电脑的系统架构（通常是64位）选择对应的Windows安装包（.msi格式）。

???? 下载地址：https://nodejs.cn/download/

对于绝大多数Windows用户，选择“Windows安装包 (.msi) 64位”这个选项就对了。

1.2 执行安装

下载完成后，双击运行安装包。安装过程本身很简单，但有个细节需要注意：在选择安装目录时，建议你记住这个路径（比如默认的 C:\Program Files\nodejs），因为后续配置环境变量会用到。之后，一路点击“Next”直到安装完成即可。

1.3 验证安装

安装是否成功，需要验证一下。打开命令提示符（按下Win + R，输入cmd后回车），依次输入下面两条命令：

node -v
npm -v

如果终端分别显示出Node.js和npm的版本号（例如v20.x.x和10.x.x），那么恭喜你，基础安装已经成功了。

1.4 配置全局模块与缓存路径

为了让后续的包管理更清晰，建议自定义npm的全局安装路径和缓存路径。进入Node.js的安装目录（比如刚才的C:\Program Files\nodejs），新建两个文件夹，分别命名为node_global和node_cache。

接着，打开命令提示符，执行以下命令（请务必将路径替换成你自己的实际安装路径）：

npm config set prefix "C:\Program Files\nodejs\node_global"
npm config set cache "C:\Program Files\nodejs\node_cache"

执行完成后，可以输入以下命令验证配置是否生效：

npm config get prefix
npm config get cache

终端输出的路径应该与你刚才设置的完全一致。

1.5 配置系统环境变量

这一步至关重要，它能确保你在任何命令行位置都能调用全局安装的npm包。

a. 新建系统变量

右键点击“此电脑”，选择“属性”，进入“高级系统设置”，点击“环境变量”。在“系统变量”区域，点击“新建”：

• 变量名：NODE_PATH
• 变量值：C:\Program Files\nodejs\node_global\node_modules（请替换为你的实际路径）

b. 修改用户变量中的 Path

在“用户变量”列表中，找到Path变量，双击编辑。将其中原有的npm路径（通常形如C:\Users\你的用户名\AppData\Roaming\npm）替换为：

C:\Program Files\nodejs\node_global

c. 修改系统变量中的 Path

接着，在“系统变量”列表中也找到Path，双击编辑。点击“新建”，然后输入：

%NODE_PATH%

1.6 验证环境变量配置

环境变量修改后，必须重新打开一个命令提示符窗口才能生效。在新窗口中，尝试全局安装一个测试包：

npm install express -g

如果整个安装过程没有报错并顺利结束，那就说明你的Node.js环境已经彻底配置妥当，可以进入下一阶段了。

二、安装千问 Coder（Qwen）

接下来登场的是阿里云出品的AI编程助手——千问Coder。它对国内用户非常友好，提供免费的调用额度。我们会借助它来简化后续工具的安装过程，事半功倍。

2.1 全局安装 Qwen

打开命令提示符，输入以下安装命令：

npm install -g @qwen-code/qwen-code@latest

耐心等待安装进度条走完。

2.2 认证与登录

安装完成后，在命令行中输入qwen并回车，即可启动对话助手。系统会提示你选择认证方式，这里选择选项 1 — Qwen OAuth。

随后，屏幕上会显示一个链接和一个二维码，任选一种方式在浏览器中完成登录认证。认证成功意味着你可以在命令行里直接和千问助手对话并让它执行任务了。

2.3 切换执行模式（推荐）

在Qwen的对话界面里，你可以通过按下Shift + Tab或Tab键来切换它的执行模式。为了获得更流畅的体验，建议激活YOLO模式（即全自动执行模式），这样它会在得到你确认后自动执行许多操作指令。

三、安装 CMake

CMake是一个经典的构建工具，OpenClaw的部分底层依赖在编译时需要它。利用已经安装好的千问助手，我们可以实现一键安装。

3.1 使用 Qwen 自动安装

确保你正在Qwen的对话界面中，然后直接输入以下指令并回车：

请帮我安装 cmake 并暴露到当前的环境变量中，并帮我验证

千问助手会理解你的需求，自动完成从下载、安装到配置环境变量的全过程。

3.2 验证

安装指令执行完毕后，留意命令行的输出。如果出现了CMake的版本信息（例如cmake version 3.x.x），那就表示CMake已经成功安装并配置好了。

四、安装与配置 OpenClaw

所有铺垫就绪，现在可以迎接主角OpenClaw了。

4.1 安装 OpenClaw

继续在Qwen对话界面中，输入如下指令：

阅读 https://openclaw.ai/ 后，帮我使用 npm 全局安装 openclaw，并帮我验证

看，这就是AI助手的便利之处。它会先去官网获取最新信息，然后自动执行对应的npm全局安装命令，并完成验证。

4.2 初始化配置（onboard）

安装成功只是第一步，接下来需要进行初始化配置。在命令行中直接输入：

openclaw onboard

稍等片刻，一个交互式的配置向导就会启动。跟着向导一步步来：

步骤一：快速开始

依次选择以下选项：

步骤二：模型认证

系统会弹出认证链接，按提示完成登录即可。你可以根据自身情况选择支持的模型厂商进行认证。

认证通过后，在后续选项中选择 Keep current 以保持当前配置。

步骤三：选择社交媒体集成

根据你实际想要集成的平台进行选择。

步骤四：配置网络搜索

这一步可以根据实际需要决定是否启用。

步骤五：启用技能（Skills）

根据个人使用场景选择需要的技能，如果暂时不确定，完全可以跳过，后续再随时配置。

步骤六：启用 Hooks（重要）

系统会列出可选的Hooks，这里强烈推荐勾选以下两项：

另外两个选项，boot-md和bootstrap-extra-files，更适合有自定义需求的高级用户，初次安装时跳过即可。

步骤七：选择交互界面

选择 TUI（终端用户界面），这样就可以直接在命令行中使用OpenClaw了。

4.3 验证安装

所有配置完成后，试着在命令行中向OpenClaw提个问题。如果它能正常回应你，那么恭喜，安装与配置已经大功告成。

4.4 初始化个性设置

为了让助手更贴合你的使用习惯，可以进行一些个性化设置，这标志着你的OpenClaw个体初始化正式完成：

1. 取名字：给你的AI助手起个喜欢的名字。
2. 设置边界偏好：根据你的需求，设定AI的行为准则和边界。
3. 删除预设脚本：进入目录 C:\Users\你的用户名\.openclaw\workspace（将“你的用户名”替换为实际名称），删除里面的预设脚本文件。这可以让你从一个干净的工作区开始。

五、常见问题与注意事项

即使是保姆级教程，也难免会遇到一些小麻烦。以下是几个高频问题的解决方案：

⚠️ 环境变量修改后不生效

这是最常见的问题。记住黄金法则：每次修改系统环境变量后，都必须关闭并重新打开命令提示符窗口，新的设置才会被加载。

⚠️ npm 全局安装报错权限不足

如果遇到权限错误，最简单的解决方法是：以管理员身份重新运行命令提示符（右键点击CMD图标，选择“以管理员身份运行”），然后在其中执行安装命令。

⚠️ 找不到 .openclaw 文件夹

这个文件夹默认是隐藏的。有两种方法找到它：

1. 直接在文件资源管理器的地址栏输入完整路径：C:\Users\你的用户名\.openclaw。
2. 在文件资源管理器中开启“显示隐藏的项目”（点击“查看”菜单，勾选对应选项）。

附录：安装流程总览

最后，让我们用一张流程图和耗时预估来回顾整个部署过程：

Node.js 安装 → 环境变量配置 → 千问 Coder 安装 → CMake 安装 → OpenClaw 安装 → 初始化配置 → 完成

总计预估时间：约 30-50 分钟（具体时长取决于你的网络环境和操作熟练度）。

如果在安装过程中遇到本指南未覆盖的问题，可以访问 OpenClaw 官方网站 https://openclaw.ai/ 获取更进一步的文档支持和社区帮助。