OpenClaw Windows 安装与 Debug 最终版教程（适用于 MiniPC i3-N305 / 无 GPU）,OpenClaw 核心使用 TypeScript 编写。Node 是推荐的运行时。 不推荐 Bun 用于 Gateway 网关（WhatsApp/Telegram 存在 bug）。配套应用适用于 macOS（菜单栏应用）和移动节点（iOS/Android）。Windows 和 Linux 配套应用已在计划中，但 Gateway 网关目前已完全支持。 Windows 原生配套应用也在计划中；推荐通过 WSL2 使用 Gateway 网关。
- Windows 10 / 11
- x64 CPU（你的是 i3-N305，完全 OK）
- 至少 8GB RAM（16GB 更稳）
OpenClaw 是 Node.js-based 的 CLI 工具，因此需要：
Node.js ≥ 22.12.0下载地址：nodejs.org
勾选 “Add to PATH”。
VS Build Tool（必须）解决 node-gyp / llama.cpp 编译失败的核心：
必须安装 Microsoft Visual Studio Build Tools + Desktop C++ workload。
下载：https://visualstudio.microsoft.com/visual-cpp-build-tools/
安装时勾选：
- Desktop development with C++
- Windows SDK（默认）
管理员 PowerShell：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
管理员 PowerShell：
npm install -g openclaw@latest
如果出现：
EBADENGINE Unsupported engine requires node >=22.12.0
说明 Node.js 版本太低 → 升级 Node 后重新安装。
openclaw --help
看到完整命令列表即成功。
以下是你遇到的错误 + 对应解决方式，已整理成可复用的 Debug 手册。
原因：PowerShell 默认禁止脚本执行解决：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
日志关键：
Failed to download cmake Failed to build llama.cpp ERR! find VS Could not find Visual Studio installation You need “Desktop development with C++”
原因：你的机器缺少 C++ 编译链，无法构建 llama.cpp。解决：安装 VS Build Tools + C++ Workload。
例如：
Could not read package.json: C:Users..._npxxxxxpackage.json
原因：npm 缓存损坏。解决：清空缓存目录：
Remove-Item -Recurse -Force "$env:LOCALAPPDATA pm-cache_npx"
The prebuilt binary with Vulkan support is not compatible falling back to building from source
你的 mini PC 没有独立 GPU → 不支持 Vulkan → 正常警告，可忽略。OpenClaw 会 fallback 到 CPU 模式。
原因可能有两类：
- Gateway 没启动
- 端口未开放 / 被占用
正确启动方式：
openclaw gateway
然后访问：
若你启用了 dev 模式，端口变为 19001：
openclaw --dev gateway
openclaw setup openclaw onboard openclaw gateway openclaw dashboard
其中：
- setup：初始化 ~/.openclaw 目录
- onboard：引导配置
- gateway：启动核心服务
- dashboard：打开你的控制面板
必须 按顺序 执行一次。
之后使用时，只需启动：
openclaw gateway
浏览器访问：
http://localhost:18789
Windows 一旦进入 sleep/hibernate：
- CPU 停止
- 内存冻结
- 所有 OpenClaw 服务暂停
OpenClaw 无法在睡眠中运行。
解决方案：
- 禁用睡眠（推荐）
- 或把 OpenClaw 装在 Always-ON 的设备（NAS、小主机等）
设置 → 系统 → 电源与睡眠 → 睡眠 = 从不 设置 → 屏幕 = 可关闭 高级电源设置 → 睡眠之后 = 从不
打开 PowerShell：
openclaw doctor
出现：
✔ Gateway running ✔ Workspace OK ✔ Browser OK
即表示系统完全正常。
你成功解决了三个核心问题：
- PowerShell 执行权限不足 → 开启 RemoteSigned
- Node 版本过低 → 升级 Node >= 22.12
- 缺少 C++ 编译链 → 安装 VS Build Tools（最关键）
- npm 缓存损坏 → 清理 _npx 缓存
- Gateway 未启动 → Dashboard 无法连接 → 手动启动
openclaw gateway
现在你的 i3-N305 Mini PC 已经可作为一个：
本地 AI 自动化服务器（OpenClaw Agent Node）
你可以随时通过：
openclaw gateway
来启动它，并远程访问 Dashboard 进行操作。
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/278237.html