OpenClaw在Win10部署踩坑记

本篇主要介绍在Win10下手动部署OpenClaw的详细步骤和常见问题解决方法。

准备工作

• OpenClaw GitHub
  https://github.com/openclaw/openclaw
• OpenClaw 中文文档
  https://docs.openclaw.ai/zh-CN

第一步 安装Node.js

• 官网下载Node.js（版本须≥22，建议LTS）
  https://nodejs.org/
• 安装完成后验证版本（PowerShell下运行）：

  node -v   # 应该输出  v24.xx.x
  npm -v   # 应该输出  11.xx.x
  

• 若已安装node.js但版本过低，Win10无法通过npm install -g n 加 n lts升级，可直接下载新版node.js安装包覆盖安装。

第二步 安装OpenClaw

以管理员权限打开PowerShell，执行：

npm -i -g openclaw

这里我折腾了许久，一直遇到下图错误，包括在WSL下仍然报错。解办法是安装visual-cpp-build-tools 组件。

下载 vs_BuildTools：https://visualstudio.microsoft.com/visual-cpp-build-tools
安装必要组件：

安装完成后，再次安装就可以成功了。
如果不安装组件，我用下面命令安装，仍然会有报错。

npm -i -g openclaw --ignore-scripts

安装组件后，如果还报错，请检查网络或者是否安装git等。

第三步 配置OpenClaw

在Powershell中运行以下命令开始配置

openclaw onboard --install-daemon

配置过程如果想修改，按esc可以重新配置。

Openclaw 基于大模型来运行，需要先准备一个大模型的API，目前支持大多数常见大模型。
Openclaw本身不能做什么，可以把大模型比作大脑，openclaw是个承载大脑的躯体。