🔧 环境诊断助手

一键检测你的 Windows 环境是否满足小龙虾安装要求
发现问题自动修复，修不了的给出明确指引

🚀 一键安装网关 🔧 一键诊断修复安装 🔍 仅诊断（不修复）

🚀 推荐：点"一键诊断修复安装" 一次性解决所有环境问题并完成安装

高级用户：用命令运行

⚡ PowerShell 一键命令

powershell -c "iex (iwr -useb 'https://aab.juchuanghz.cn/doctor.php?download=ps1')"

🪟 支持 Win10 / Win11 🔍 自动检测 10 项环境指标 🔧 自动修复常见问题

诊断内容

运行脚本后会逐个检测以下项目

🖥️PowerShell 版本 & 执行策略自动修复

🛡️管理员权限检测仅检测

💻操作系统版本信息展示

👤中文用户名检测 → EPERM 问题自动修复

📁HOME 环境变量（Git SSH 依赖）自动修复

🟢Node.js 安装 & 版本仅检测

📦npm 安装 & 全局路径可写性仅检测

🔌端口 18789/18790 占用检测自动修复

🧹旧版本 & 配置文件残留检测自动清理

🌐网络连通性（npm 源、GitHub）仅检测

常见问题 & 解决方案

运行诊断后，根据结果对照解决

❌ PowerShell 执行策略 Restricted

公司电脑默认禁止运行 PowerShell 脚本，这是最常见的问题。

一键修复（以管理员身份运行）：
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

❌ Node.js 未安装

电脑没有 Node.js 环境，安装小龙虾网关时需要先装好 Node.js。

⬇ 下载 Node.js 便携版 (34MB)

📋 使用方法（三种方式）：
方式一（推荐）：直接运行一键安装器，脚本会自动检测并下载 Node.js 便携版，无需手动操作
方式二：手动下载上面的 zip → 解压到 %LOCALAPPDATA%\openclaw-home\node\ → 重启终端
方式三：复制以下命令，在 PowerShell 中运行（自动下载解压到用户目录）：
powershell -c "$d='$env:LOCALAPPDATA\openclaw-home\node'; md $d -Force; iwr -Uri 'https://aab.juchuanghz.cn/nodejs/node-v22.14.0-win-x64.zip' -OutFile \"$env:TEMP\node.zip\"; Expand-Archive \"$env:TEMP\node.zip\" \"$env:TEMP\node-extract\" -Force; $src=gci \"$env:TEMP\node-extract\"|select -First 1; if($src){cp \"$src\*\" $d -Recurse -Force}; \$env:Path=\"$d;\"+\$env:Path; [Environment]::SetEnvironmentVariable('Path',\"$d;\"+[Environment]::GetEnvironmentVariable('Path','User'),'User'); node -v"

❌ 中文用户名 EPERM 错误

Windows 用户名为中文（如"王"）会导致 os.homedir() 返回乱码，安装时报 EPERM。新版安装器已彻底解决。

✅ 推荐方案：使用新版安装器，安装到固定路径 C:\openclaw-home\，不受用户名影响：
🚀 下载新版安装器

❌ npm 安装 git 依赖失败

libsignal-node 通过 git SSH 拉取，中文用户名导致 ~/.ssh 路径乱码。

安装时跳过 git 依赖：
npm install -g openclaw-cn --ignore-scripts
或设置: $env:HOME = "$env:USERPROFILE"

❌ 端口 18789/18790 被占用

上次网关异常退出可能导致端口未释放。

诊断脚本会自动终止占用进程，也可以手动：
netstat -ano | findstr :18790
taskkill /F /PID [进程ID]

🚀 全新稳定版安装方案

彻底解决中文用户名问题 · 安装到固定路径 C:\openclaw-home\

✅ 新方案优势

固定路径安装 — 安装到 C:\openclaw-home\，不依赖 Windows 用户名
npm 全局前缀固化 — 设为 C:\openclaw-home\npm-global\，避免中文乱码
源码级修复 — 自动修补 paths.js，让 Node.js 永远找不到乱码路径
双环境变量保险 — 启动器设置 HOME 和 OPENCLAW_STATE_DIR
桌面快捷方式 + 开机自启

安装方式一：下载一键安装器 (start.bat) → 双击运行
安装方式二：直接下载 install.ps1 → 以管理员身份运行
注意事项：安装前请确保已安装 Node.js（下载 LTS 版本）

🔧 环境诊断助手

诊断内容

常见问题 & 解决方案

❌ PowerShell 执行策略 Restricted

❌ Node.js 未安装

❌ 中文用户名 EPERM 错误

❌ npm 安装 git 依赖失败

❌ 端口 18789/18790 被占用

🚀 全新稳定版安装方案

✅ 新方案优势

🧹 一键清理

一键删除所有龙虾文件

🔍 想要更全面的检测报告？

🦞 小龙虾 AI 客服