<p cms-style="font-L strong-Bold">OpenClaw Windows 安装与 Debug 最终版教程（适用于 MiniPC i3-N305 / 无 GPU）</p><p cms-style="font-L strong-Bold">一、前置条件</p><p cms-style="font-L strong-Bold">1. 系统要求</p><ul cms-style="ul"><li cms-style="li"><p cms-style="font-L">Windows 10 / 11</p></li><li cms-style="li"><p cms-style="font-L">x64 CPU（你的是 i3-N305，完全 OK）</p></li><li cms-style="li"><p cms-style="font-L">至少 8GB RAM（16GB 更稳）</p></li></ul><p cms-style="font-L strong-Bold">2. 必须安装的依赖</p><p cms-style="font-L">OpenClaw 是 Node.js-based 的 CLI 工具，因此需要：</p><ol cms-style="ol"><li cms-style="li"><p cms-style="font-L strong-Bold">Node.js ≥ 22.12.0</p><p cms-style="font-L">下载地址：nodejs.org</p><p cms-style="font-L">勾选 “Add to PATH”。</p></li><li cms-style="li"><p cms-style="font-L strong-Bold">VS Build Tool（必须）</p><p cms-style="font-L">解决 node-gyp / llama.cpp 编译失败的核心：</p><font cms-style="font-L">必须安装 </font><font cms-style="font-L strong-Bold">Microsoft Visual Studio Build Tools + Desktop C++ workload</font><font cms-style="font-L">。</font></li></ol><p cms-style="font-L">下载：</p><p cms-style="font-L">https://visualstudio.microsoft.com/visual-cpp-build-tools/</p><p cms-style="font-L">安装时勾选：</p><ul cms-style="ul"><li cms-style="li"><p cms-style="font-L">Desktop development with C++</p></li><li cms-style="li"><p cms-style="font-L">Windows SDK（默认）</p></li></ul><p cms-style="font-L strong-Bold">3. PowerShell 允许执行脚本（解决 npm.ps1 Cannot be loaded）</p><p cms-style="font-L">管理员 PowerShell：</p><p>Set-ExecutionPolicy RemoteSigned -Scope CurrentUser</p><p cms-style="font-L strong-Bold">二、安装 OpenClaw（最终正确流程）</p><p cms-style="font-L strong-Bold">1. 全局安装 OpenClaw（指向最新版本）</p><p cms-style="font-L">管理员 PowerShell：</p><p>npm install -g openclaw@latest</p><p cms-style="font-L">如果出现：</p><p>EBADENGINE Unsupported engine requires node >=22.12.0</p><p cms-style="font-L">说明 Node.js 版本太低 → 升级 Node 后重新安装。</p><p cms-style="font-L strong-Bold">2. 验证安装成功</p><p>openclaw --help</p><p cms-style="font-L">看到完整命令列表即成功。</p><p cms-style="font-L strong-Bold">三、常见错误与完整 Debug 过程（基于你的实际日志）</p><p cms-style="font-L">以下是你遇到的错误 + 对应解决方式，已整理成可复用的 Debug 手册。</p><p cms-style="font-L strong-Bold">错误 1：npm.ps1 cannot be loaded</p><p cms-style="font-L strong-Bold">原因：PowerShell 默认禁止脚本执行</p><p cms-style="font-L strong-Bold">解决：</p><p>Set-ExecutionPolicy RemoteSigned -Scope CurrentUser</p><p cms-style="font-L strong-Bold">错误 2：node-llama-cpp 反复 Clone llama.cpp / 编译失败</p><p cms-style="font-L">日志关键：</p><p>Failed to download cmakeFailed to build llama.cppERR! find VS Could not find Visual Studio installationYou need “Desktop development with C++”</p><p cms-style="font-L strong-Bold">原因：你的机器缺少 C++ 编译链，无法构建 llama.cpp。</p><p cms-style="font-L strong-Bold">解决：安装 VS Build Tools + C++ Workload。</p><p cms-style="font-L strong-Bold">错误 3：ENOENT: Could not read package.json</p><p cms-style="font-L">例如：</p><p>Could not read package.json:C:Users..._npxxxxxpackage.json</p><p cms-style="font-L strong-Bold">原因：npm 缓存损坏。</p><p cms-style="font-L strong-Bold">解决：清空缓存目录：</p><p>Remove-Item -Recurse -Force "$env:LOCALAPPDATA 

pm-cache_npx”

错误 4：Vulkan 支持失败

The prebuilt binary with Vulkan support is not compatiblefalling back to building from source

你的 mini PC 没有独立 GPU → 不支持 Vulkan → 正常警告，可忽略。

OpenClaw 会 fallback 到 CPU 模式。

错误 5：Gateway 无法访问（127.0.0.1 refused）

原因可能有两类：

1. Gateway 没启动
2. 端口未开放 / 被占用

正确启动方式：

openclaw gateway

然后访问：

http://127.0.0.1:18789

或

（端口可能随配置不同）

若你启用了 dev 模式，端口变为 19001：

openclaw –dev gateway

四、安装完成后如何启动 OpenClaw 的 Dashboard

全流程：

openclaw setupopenclaw onboardopenclaw gatewayopenclaw dashboard

其中：

• setup：初始化 ~/.openclaw 目录
• onboard：引导配置
• gateway：启动核心服务
• dashboard：打开你的控制面板

必须 按顺序 执行一次。

之后使用时，只需启动：

openclaw gateway

浏览器访问：

http://localhost:18789

五、休眠 / 睡眠的影响（关键）

Windows 一旦进入 sleep/hibernate：

• CPU 停止
• 内存冻结
• 所有 OpenClaw 服务暂停

OpenClaw 无法在睡眠中运行。

解决方案：

• 禁用睡眠（推荐）
• 或把 OpenClaw 装在 Always-ON 的设备（NAS、小主机等）

六、推荐的 Windows 永不休眠设置（适合当成 AI 自动化节点）

设置 → 系统 → 电源与睡眠 → 睡眠 = 从不设置 → 屏幕 = 可关闭高级电源设置 → 睡眠之后 = 从不

七、最终验证（确认一切正常）

1. 打开 PowerShell：

openclaw doctor

出现：

✔ Gateway running✔ Workspace OK✔ Browser OK

即表示系统完全正常。

最终总结（给未来的你或别人参考）

你成功解决了三个核心问题：

1. PowerShell 执行权限不足 → 开启 RemoteSigned
2. Node 版本过低 → 升级 Node >= 22.12
3. 缺少 C++ 编译链 → 安装 VS Build Tools（最关键）
4. npm 缓存损坏 → 清理 _npx 缓存
5. Gateway 未启动 → Dashboard 无法连接 → 手动启动 openclaw gateway

现在你的 i3-N305 Mini PC 已经可作为一个：

本地 AI 自动化服务器（OpenClaw Agent Node）

你可以随时通过：

openclaw gateway

来启动它，并远程访问 Dashboard 进行操作。