Windows 本地部署 OpenClaw 极简教程
我们知道 OpenClaw 与 macOS 相性较高，但相信很多人的工作电脑和个人电脑都是以 Windows 为主力。在体验了 macOS 和桌面端之后，本文将带你尝试在 Windows 上进行 OpenClaw 的本地部署。
本教程将采用最简洁的步骤，帮助你快速在 Windows 环境中跑通 OpenClaw。
环境准备
1. 确认 Node.js 环境
OpenClaw 依赖 Node.js 运行，无脑建议使用最新版本或较高版本的 Node.js。
以管理员身份运行 PowerShell，然后检查你的 Node.js 版本：
powershell
node -v
如果未安装 Node.js 或版本过低，建议先通过 nvm-windows 或官方安装包进行安装。
2. 配置国内镜像源（可选但推荐）
如果你在国内，建议将 npm 源切换为淘宝镜像，可以大幅提升下载速度：
powershell
npm config set registry https://registry.npmmirror.com/
3. 确认网络连接
确保你的电脑可以正常访问 GitHub 等国外资源。如果网络环境特殊，请提前准备好科学上网工具。
安装 OpenClaw
在管理员 PowerShell 中执行以下命令，全局安装 OpenClaw：
powershell
npm install -g openclaw@latest
安装过程中的常见问题
问题：出现 code 128 错误
这通常是由于网络波动或 SSH 访问失败导致的。解决方法很简单：
-
执行缓存清理命令：
powershell
npm cache clean --force -
重新运行安装命令：
powershell
npm install -g openclaw@latest
重复以上步骤直至安装成功即可。
问题：出现 4048 错误
# 先卸载已有的不完全安装
winget uninstall --id Microsoft.VisualStudio.2022.BuildTools
# 重新安装，明确指定需要 MSVC 编译工具
winget install --id Microsoft.VisualStudio.2022.BuildTools --source winget --force --override "--passive --wait --add Microsoft.VisualStudio.Component.VC.Tools.x86.x64 --add Microsoft.VisualStudio.Component.Windows10SDK.20348"
运行 OpenClaw
1. （可选）运行新手引导
OpenClaw 提供了一个交互式新手引导，你可以试着玩一下：
powershell
openclaw onboard --install-daemon
这一步不是必须的，但可以帮助你快速了解 OpenClaw 的基本功能。
2. （可选）检查 Gateway 网关健康状态
你可以通过以下命令检查网关运行状态：
powershell
openclaw status
openclaw health
这两步也不是必须的，主要用于确认服务是否正常启动。
3. 关键配置：切换网关模式
这一步非常重要，必须执行！
powershell
openclaw config set gateway.mode local
该命令将 OpenClaw 的网关模式设置为本地模式，确保后续操作可以正常进行。
启动 Dashboard 面板
在 PowerShell 中运行以下命令，启动 OpenClaw 的 Web 管理面板：
powershell
openclaw dashboard
此时，浏览器会自动打开一个新页面，但可能会显示加载失败（这是正常现象）。
解决加载失败问题
不要关闭浏览器标签页，回到 PowerShell 中继续运行：
powershell
openclaw gateway run
然后再回去刷新浏览器页面，搞定！OpenClaw 的 Dashboard 面板应该就能正常显示了。
🎉 总结
至此，你已经在 Windows 上成功部署并运行了 OpenClaw。整个流程可以总结为：
- 准备 Node.js 环境
- 安装 OpenClaw（遇到 code 128 就清缓存重试）
- 设置网关模式为 local
- 启动 dashboard，再运行 gateway 后刷新
希望这篇教程能帮助你在 Windows 上顺利体验 OpenClaw。如果在安装过程中还有其他问题，欢迎留言交流！
