Windows下OpenClaw的安裝與Debug配置教程最終版(MiniPC i3-N305 / 無 GPU)
我要評論
OpenClaw Windows 安裝與 Debug 最終版教程（適用于 MiniPC i3-N305 / 無 GPU）,OpenClaw 核心使用 TypeScript 編寫。Node 是推薦的運行時。 不推薦 Bun 用于 Gateway 網(wǎng)關(guān)（WhatsApp/Telegram 存在 bug）。配套應用適用于 macOS（菜單欄應用）和移動節(jié)點（iOS/Android）。Windows 和 Linux 配套應用已在計劃中，但 Gateway 網(wǎng)關(guān)目前已完全支持。 Windows 原生配套應用也在計劃中；推薦通過 WSL2 使用 Gateway 網(wǎng)關(guān)。
一、前置條件
1. 系統(tǒng)要求
- Windows 10 / 11
- x64 CPU（你的是 i3-N305，完全 OK）
- 至少 8GB RAM（16GB 更穩(wěn)）
2. 必須安裝的依賴
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（默認）
3. PowerShell 允許執(zhí)行腳本（解決 npm.ps1 Cannot be loaded）
管理員 PowerShell：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
二、安裝 OpenClaw（最終正確流程）
1. 全局安裝 OpenClaw（指向最新版本）
管理員 PowerShell：
npm install -g openclaw@latest
如果出現(xiàn)：
EBADENGINE Unsupported engine requires node >=22.12.0
說明 Node.js 版本太低 → 升級 Node 后重新安裝。
2. 驗證安裝成功
openclaw --help
看到完整命令列表即成功。
三、常見錯誤與完整 Debug 過程（基于你的實際日志）
以下是你遇到的錯誤 + 對應解決方式，已整理成可復用的 Debug 手冊。
錯誤 1：npm.ps1 cannot be loaded
原因：PowerShell 默認禁止腳本執(zhí)行解決：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
錯誤 2：node-llama-cpp 反復 Clone llama.cpp / 編譯失敗
日志關(guān)鍵：
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++ 編譯鏈，無法構(gòu)建 llama.cpp。解決：安裝 VS Build Tools + C++ Workload。
錯誤 3：ENOENT: Could not read package.json
例如：
Could not read package.json: C:\Users\...\_npx\xxxx\package.json
原因：npm 緩存損壞。解決：清空緩存目錄：
Remove-Item -Recurse -Force "$env:LOCALAPPDATA\npm-cache\_npx"
錯誤 4：Vulkan 支持失敗
The prebuilt binary with Vulkan support is not compatible falling back to building from source
你的 mini PC 沒有獨立 GPU → 不支持 Vulkan → 正常警告，可忽略。OpenClaw 會 fallback 到 CPU 模式。
錯誤 5：Gateway 無法訪問（127.0.0.1 refused）
原因可能有兩類：
Gateway 沒啟動
端口未開放 / 被占用
正確啟動方式：
openclaw gateway
然后訪問：
http://127.0.0.1:18789或
http://localhost:18789（端口可能隨配置不同）
若你啟用了 dev 模式，端口變?yōu)?19001：
openclaw --dev gateway
四、安裝完成后如何啟動 OpenClaw 的 Dashboard
全流程：
openclaw setup openclaw onboard openclaw gateway openclaw dashboard
其中：
- setup：初始化 ~/.openclaw 目錄
- onboard：引導配置
- gateway：啟動核心服務
- dashboard：打開你的控制面板
必須 按順序 執(zhí)行一次。
之后使用時，只需啟動：
openclaw gateway
瀏覽器訪問：
http://localhost:18789
五、休眠 / 睡眠的影響（關(guān)鍵）
Windows 一旦進入 sleep/hibernate：
- CPU 停止
- 內(nèi)存凍結(jié)
- 所有 OpenClaw 服務暫停
OpenClaw 無法在睡眠中運行。
解決方案：
- 禁用睡眠（推薦）
- 或把 OpenClaw 裝在 Always-ON 的設(shè)備（NAS、小主機等）
六、推薦的 Windows 永不休眠設(shè)置（適合當成 AI 自動化節(jié)點）
設(shè)置 → 系統(tǒng) → 電源與睡眠 → 睡眠 = 從不 設(shè)置 → 屏幕 = 可關(guān)閉 高級電源設(shè)置 → 睡眠之后 = 從不
七、最終驗證（確認一切正常）
打開 PowerShell：
openclaw doctor
出現(xiàn)：
? Gateway running ? Workspace OK ? Browser OK
即表示系統(tǒng)完全正常。
最終總結(jié)（給未來的你或別人參考）
你成功解決了三個核心問題：
- PowerShell 執(zhí)行權(quán)限不足 → 開啟 RemoteSigned
- Node 版本過低 → 升級 Node >= 22.12
- 缺少 C++ 編譯鏈 → 安裝 VS Build Tools（最關(guān)鍵）
- npm 緩存損壞 → 清理 _npx 緩存
- Gateway 未啟動 → Dashboard 無法連接 → 手動啟動
openclaw gateway
現(xiàn)在你的 i3-N305 Mini PC 已經(jīng)可作為一個：
本地 AI 自動化服務器（OpenClaw Agent Node）
你可以隨時通過：
openclaw gateway
來啟動它，并遠程訪問 Dashboard 進行操作。
相關(guān)文章
OpenClaw 完全可以在筆記本上用，但很多人會推薦 Mac mini，是因為「長期當服務器」這件事對硬件有不同要求，低功耗、配置容易上手、錯誤少，所以選擇mini是更好的選擇2026-03-02
蘋果Macmini下OpenClaw保姆級配置教程(全網(wǎng)最簡單)
如果你也想把 Macmini 變成 24h 在線的 私人秘書，這篇就是保姆級喂飯教程，為什么選擇mac mini來配置OpenClaw，因為OpenClaw是在unix開發(fā)的，而openclaw也是unix系統(tǒng)，所2026-03-09
Mac mini上部署配置OpenClaw并接入國產(chǎn)大模型與飛書
本文詳細介紹了在Macmini上部署OpenClaw的全過程,包括配置安裝及國產(chǎn)大模型接入以及飛書機器人集成,搭建一個的AI助手,滿足日常自動化需求，需要的朋友們下面隨著小編來一起2026-03-09
