- 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。
安装时勾选:
- 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 模式。
原因可能有两类:
- Gateway 没启动
- 端口未开放 / 被占用
正确启动方式:
然后访问:
若你启用了 dev 模式,端口变为 19001:
其中:
- setup:初始化 ~/.openclaw 目录
- onboard:引导配置
- gateway:启动核心服务
- dashboard:打开你的控制面板
必须 按顺序 执行一次。
之后使用时,只需启动:
浏览器访问:
Windows 一旦进入 sleep/hibernate:
- CPU 停止
- 内存冻结
- 所有 OpenClaw 服务暂停
OpenClaw 无法在睡眠中运行。
解决方案:
- 禁用睡眠(推荐)
- 或把 OpenClaw 装在 Always-ON 的设备(NAS、小主机等)
- 打开 PowerShell:
出现:
即表示系统完全正常。
你成功解决了三个核心问题:
- PowerShell 执行权限不足 → 开启 RemoteSigned
- Node 版本过低 → 升级 Node >= 22.12
- 缺少 C++ 编译链 → 安装 VS Build Tools(最关键)
- npm 缓存损坏 → 清理 _npx 缓存
- Gateway 未启动 → Dashboard 无法连接 → 手动启动
现在你的 i3-N305 Mini PC 已经可作为一个:
本地 AI 自动化服务器(OpenClaw Agent Node)
你可以随时通过:
来启动它,并远程访问 Dashboard 进行操作。
发布者:全栈程序员-站长,转载请注明出处:https://javaforall.net/249582.html原文链接:https://javaforall.net
