返回首页

🚀 OpenClaw 本地部署详细教程（小白完全版）

从0开始一步步教你如何在Windows笔记本上完整部署OpenClaw

📖 文档说明

本教程专为零基础用户编写，从0开始一步步教你如何在Windows笔记本上完整部署OpenClaw。建议按照顺序操作，不要跳过步骤。

1第一章：准备工作与环境检查

1.1 确认电脑配置

1. 检查操作系统版本

  1. 右键点击"此电脑"或"我的电脑"
  2. 选择"属性"
  3. 查看Windows版本
项目最低要求推荐配置
操作系统Windows 10 家庭版Windows 10/11 专业版
内存(RAM)4GB8GB或以上
硬盘空间5GB可用空间20GB可用空间
网络普通宽带稳定网络连接
CPU双核处理器四核或更高

1.2 检查磁盘空间

2. 查看C盘和D盘空间

  1. 打开"此电脑"
  2. 查看C盘和D盘的剩余空间
  3. 确保C盘至少有5GB空间，建议D盘有10GB以上空间

⚠️ 重要提示：

如果C盘空间不足，建议先清理垃圾文件或将部分文件移动到D盘，否则安装可能失败。

2第二章：安装Node.js（详细图解步骤）

什么是Node.js？

Node.js是运行JavaScript代码的环境，OpenClaw基于Node.js开发，必须先安装它才能运行OpenClaw。

2.1 下载Node.js安装包

1. 访问官方网站

  1. 打开浏览器（Chrome、Edge、Firefox都可以）
  2. 在地址栏输入：https://nodejs.org/
  3. 按回车键访问网站

2. 选择版本下载

【推荐】选择LTS版本（长期支持版）：

  • 在网页上找到绿色的大按钮，写着 "18.x.x LTS"
  • 点击这个按钮下载
  • 下载的文件名类似：node-v18.x.x-x64.msi

为什么不选择Current版本？

Current版本是最新功能版，可能有不稳定因素，LTS版本更稳定可靠，适合新手使用。

2.2 安装Node.js

3. 运行安装程序

  1. 打开下载文件夹（通常在"下载"文件夹中）
  2. 找到 node-v18.x.x-x64.msi 文件
  3. 右键点击 → 选择"以管理员身份运行"
  4. 如果出现Windows安全提示，点击"是"或"允许"

4. 安装向导步骤

第1步 - 欢迎界面：

点击 "Next >"

第2步 - 许可协议：

勾选 "I accept the terms in the License Agreement"，点击 "Next >"

第3步 - 安装位置：

保持默认路径（不要修改！），默认路径是：C:\Program Files\nodejs\，点击 "Next >"

第4步 - 自定义安装：

保持默认选项（全部勾选），确保 "Add to PATH" 被勾选（非常重要！），点击 "Next >"

第5步 - 安装工具：

取消勾选可选工具，点击 "Next >"

第6步 - 开始安装：

点击 "Install" 按钮，等待安装完成（约1-3分钟），点击 "Finish" 完成安装

2.3 验证Node.js安装

5. 打开命令提示符

方法一：

按键盘上的 Win + R 键，输入 cmd，按回车键

方法二：

右键点击"开始"按钮，选择"Windows终端"或"命令提示符"

6. 检查Node.js版本

node --version

✅ 成功标志：

如果显示类似 v18.20.0 或 v20.x.x 的版本号，说明Node.js安装成功！

❌ 如果显示"'node' 不是内部或外部命令"：

  1. 重启电脑
  2. 重新打开命令提示符
  3. 再次输入命令测试
  4. 如果还是不行，需要卸载重装Node.js，确保安装时勾选了"Add to PATH"

7. 检查npm版本

npm --version

如果显示类似 10.x.x 的版本号，说明npm也安装成功了。

3第三章：安装OpenClaw

安装前准备：

  • 确保Node.js已正确安装（第二章已完成）
  • 确保网络连接正常
  • 确保有管理员权限

3.1 通过npm安装OpenClaw（推荐）

1. 打开命令提示符（管理员权限）

  1. 按 Win + R
  2. 输入 cmd
  3. 不要直接按回车！
  4. 按 Ctrl + Shift + Enter 以管理员身份运行
  5. 如果出现UAC提示，点击"是"

2. 执行安装命令

npm install -g openclaw

📌 命令解释：

  • npm：Node包管理器
  • install：安装命令
  • -g：全局安装（所有用户都能使用）
  • openclaw：要安装的软件包名称

3. 等待安装完成

安装过程需要几分钟时间，会显示下载进度和安装信息，看到类似 added 1 package in 30s 表示安装成功。

⚠️ 安装过程常见问题：

问题1：安装卡住不动

解决：按 Ctrl + C 取消，然后更换npm源：

npm config set registry https://registry.npmmirror.com
npm install -g openclaw

问题2：权限错误（EACCES）

解决：确保以管理员身份运行命令提示符

问题3：网络超时

解决：检查网络连接，或使用代理/VPN

3.2 验证OpenClaw安装

4. 检查版本

openclaw --version

如果显示类似 1.x.x 的版本号，恭喜你！OpenClaw安装成功！

📞 获取帮助

📚 官方文档

https://docs.openclaw.ai

文档版本：1.0

创建时间：2025-03-10

适用系统：Windows 10/11

OpenClaw版本：最新版