永远雪山1. 项目概述
OpenClaw是一款基于大模型技术的智能助手框架，能够帮助开发者和技术爱好者快速搭建本地AI应用环境。作为一名长期关注AI技术落地的开发者，我在Windows 11系统上完成了OpenClaw的完整部署流程，过程中遇到了不少值得分享的技术细节和避坑经验。
这个项目特别适合以下几类人群：
- 想体验最新大模型技术的个人开发者
- 需要本地化AI开发环境的技术团队
- 对AI应用开发感兴趣的技术爱好者
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备
2.1 Node.js安装与配置
官方要求Node.js版本必须在22以上，我选择了最新的Node 24版本。这里有个重要细节：虽然官网提供了.msi安装包可以一键安装，但我更推荐使用nvm（Node Version Manager）来管理Node版本，原因有三：
- 可以随时切换不同Node版本
- 避免全局安装导致的权限问题
- 方便后续版本升级和回退
安装完成后，必须执行以下关键命令：
bash复制node -v
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
注意：执行策略设置是Windows系统特有的步骤，这个操作允许运行本地脚本而不需要数字签名，对后续的npm包管理至关重要。
2.2 PowerShell问题排查
在实际安装过程中，可能会遇到PowerShell执行npm命令报错的情况。根据我的经验，90%的问题可以通过以下步骤解决：
- 完全关闭所有PowerShell窗口后重新打开
- 执行解除网络阻止标记命令：
powershell复制Unblock-File npm.ps1, npx.ps1
- 验证文件属性：
powershell复制Get-Item npm.ps1 | Select-Object Name, IsReadOnly, Attributes
3. Git环境配置
3.1 安装注意事项
Git的安装过程中有几个关键配置选项需要特别注意：
- 终端选择：建议使用"Use Windows' default console window"
- 兼容性更好
- 不需要额外配置winpty