openclaw本地化部署体验与踩坑记录--windows

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

arduino 复制代码

npm config set registry https://registry.npmmirror.com/

3. 确认网络连接

确保你的电脑可以正常访问 GitHub 等国外资源。如果网络环境特殊，请提前准备好科学上网工具。

安装 OpenClaw

在管理员 PowerShell 中执行以下命令，全局安装 OpenClaw：

powershell

css 复制代码

npm install -g openclaw@latest

安装过程中的常见问题

问题：出现 code 128 错误

这通常是由于网络波动或 SSH 访问失败导致的。解决方法很简单：

执行缓存清理命令：

powershell
css 复制代码
```
npm cache clean --force
```
重新运行安装命令：

powershell
css 复制代码
```
npm install -g openclaw@latest
```

重复以上步骤直至安装成功即可。

运行 OpenClaw

1. （可选）运行新手引导

OpenClaw 提供了一个交互式新手引导，你可以试着玩一下：

powershell

css 复制代码

openclaw onboard --install-daemon

这一步不是必须的，但可以帮助你快速了解 OpenClaw 的基本功能。

2. （可选）检查 Gateway 网关健康状态

你可以通过以下命令检查网关运行状态：

powershell

lua 复制代码

openclaw status
openclaw health

这两步也不是必须的，主要用于确认服务是否正常启动。

3. ⚙️ 关键配置：切换网关模式

这一步非常重要，必须执行！

powershell

arduino 复制代码

openclaw config set gateway.mode local

该命令将 OpenClaw 的网关模式设置为本地模式，确保后续操作可以正常进行。

启动 Dashboard 面板

在 PowerShell 中运行以下命令，启动 OpenClaw 的 Web 管理面板：

powershell

复制代码

openclaw dashboard

此时，浏览器会自动打开一个新页面，但可能会显示加载失败（这是正常现象）。

解决加载失败问题

不要关闭浏览器标签页，回到 PowerShell 中继续运行：

powershell

arduino 复制代码

openclaw gateway run

然后再回去刷新浏览器页面，搞定！OpenClaw 的 Dashboard 面板应该就能正常显示了。

🎉 总结

至此，你已经在 Windows 上成功部署并运行了 OpenClaw。整个流程可以总结为：

准备 Node.js 环境
安装 OpenClaw（遇到 code 128 就清缓存重试）
设置网关模式为 local
启动 dashboard，再运行 gateway 后刷新

希望这篇教程能帮助你在 Windows 上顺利体验 OpenClaw。如果在安装过程中还有其他问题，欢迎留言交流！