OpenClaw Windows 安装与 Debug 最终版教程(适用于 MiniPC i3-N305 / 无 GPU)

OpenClaw Windows 安装与 Debug 最终版教程(适用于 MiniPC i3-N305 / 无 GPU)

 


  • Windows 10 / 11
  • x64 CPU(你的是 i3-N305,完全 OK)
  • 至少 8GB RAM(16GB 更稳)

OpenClaw 是 Node.js-based 的 CLI 工具,因此需要:

  1. Node.js ≥ 22.12.0
    下载地址:nodejs.org
    勾选 “Add to PATH”。

  2. VS Build Tool(必须)
    解决 node-gyp / llama.cpp 编译失败的核心:
    必须安装 Microsoft Visual Studio Build Tools + Desktop C++ workload

安装时勾选:

  • Desktop development with C++
  • Windows openclaw SDK(默认)

管理员 PowerShell:



管理员 PowerShell:


如果出现:


说明 Node.js 版本太低 → 升级 Node 后重新安装。


看到完整命令列表即成功。


以下是你遇到的错误 + 对应解决方式,已整理成可复用的 Debug 手册。


原因:PowerShell 默认禁止脚本执行
解决:



日志关键:


原因:你的机器缺少 C++ 编译链,无法构建 llama.cpp。
解决:安装 VS Build Tools + C++ Workload。


例如:


原因:npm 缓存损坏。
解决:清空缓存目录:




你的 mini PC 没有独立 GPU → 不支持 Vulkan → 正常警告,可忽略。
OpenClaw 会 fallback 到 CPU 模式。


原因可能有两类:

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

正确启动方式


然后访问:

若你启用了 dev 模式,端口变为 19001:




其中:

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

必须 按顺序 执行一次。

之后使用时,只需启动:


浏览器访问:



Windows 一旦进入 sleep/hibernate:

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

OpenClaw 无法在睡眠中运行。

解决方案:

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



  1. 打开 PowerShell:

出现:


即表示系统完全正常。


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

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

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

本地 AI 自动化服务器(OpenClaw Agent Node)

你可以随时通过:


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

 

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请联系我们举报,一经查实,本站将立刻删除。

发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/249582.html原文链接:https://javaforall.net

(0)
上一篇 2026年3月15日 下午3:28
下一篇 2026年3月15日 下午3:28


相关推荐

关注全栈程序员社区公众号