Windows 安装问题

编号格式 #NNNNN 对应 GitHub issue，可直接搜索去重。

CLI 冷启动极慢（10-14 秒）

来源：GitHub #30072（2026-02）

现象：升级到 v2026.2.26 后，Windows 上 CLI 冷启动时间从约 3 秒退化到 10-14 秒。

原因：该版本 dist 文件数量增加了 433 个，导致 Windows 文件 I/O 在启动时阻塞。Linux/macOS 不受影响。

解决方法：

降级到 v2026.2.19（已确认不受影响）：

bash

npm install -g openclaw@2026.2.19

或等待官方修复（已列入 backlog）。

注意：此问题仅影响 Windows 原生环境，WSL2 不受影响。这也是推荐 Windows 用户使用 WSL2 的原因之一。

来源：GitHub #45343（2026-03）

现象：升级到 2026.3.12 后，通过飞书、微信等渠道发送图片时报错：

Could not load the "sharp" module using the win32-x64 runtime
sharp-win32-x64.node is not a valid Win32 application

升级前正常，降回旧版本恢复。

原因：2026.3.12 发布时，sharp 模块预构建的 Windows x64 原生二进制（.node 文件）与当前平台不兼容——版本升级导致 sharp-win32-x64.node 被错误编译或损坏。

解决方法：

方案 1：强制重新安装 sharp 原生模块：

bash

cd $(npm root -g)/openclaw
npm rebuild sharp
# 或
npm install sharp --force

方案 2（推荐）：升级到最新版本（官方后续版本已修复）：

bash

npm install -g openclaw@latest

方案 3：确认 Node.js 架构与系统匹配：

bash

node -e "console.log(process.arch)"   # 应输出 x64

附带影响：此问题可能同时导致 TTS 语音损坏（输出空音频），因为 TTS 也依赖原生模块。