安装后提示"command not found"怎么办？

安装OpenClaw后提示”command not found”是环境变量配置问题导致的。以下是系统性的解决方案：

 问题诊断流程图

1. graph TD
2. A[command not found] --> B{检查Node.js环境}
3. B -->|node -v失败| C[重新安装Node.js]
4. B -->|node -v成功| D{检查npm全局路径}
5. D -->|npm config get prefix| E[路径是否在PATH中?]
6. E -->|否| F[添加npm全局路径到PATH]
7. E -->|是| G{检查PowerShell执行策略}
8. G -->|Restricted| H[修改为RemoteSigned]
9. G -->|已修改| I[重新安装OpenClaw]
10. I --> J[验证安装成功]

 分步解决方案

第一步：基础环境检查

1. 验证Node.js安装（以管理员身份运行PowerShell）：

   1. node -v # 应显示 v22.x.x 或更高
   2. npm -v # 应显示版本号

   如果提示”node不是命令”，说明Node.js未安装或环境变量未配置。

2. 检查OpenClaw是否已安装：

   1. npm list -g openclaw

   如果显示版本号，说明已安装但路径未配置。

第二步：环境变量修复（最常见原因）

方案A：添加npm全局路径到PATH

1. 获取npm全局安装路径：

   1. npm config get prefix

   通常返回：C:\Users\你的用户名\AppData\Roaming\npm

2. 将此路径添加到系统PATH：

   • 按 Win + X → 选择”系统” → “高级系统设置”
   • 点击”环境变量” → 在”系统变量”中找到Path
   • 点击”编辑” → “新建” → 粘贴上一步获取的路径
   • 确认所有窗口

3. 重启PowerShell使更改生效。

方案B：中文用户名特殊处理

如果Windows用户名是中文，需要设置OPENCLAW_HOME环境变量：

1. 新建用户变量：
   • 变量名：OPENCLAW_HOME
   • 变量值：C:\Users\纯英文路径（如C:\Users\openclaw）
2. 重启终端。

第三步：PowerShell执行策略调整

Windows默认阻止脚本执行，需要修改策略：

1. # 以管理员身份运行PowerShell
2. Get-ExecutionPolicy # 查看当前策略（通常是Restricted）
3. Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

输入A确认更改。

第四步：重新安装OpenClaw

如果上述步骤无效，重新安装：

1. # 卸载旧版本
2. npm uninstall -g openclaw
4. # 清理npm缓存
5. npm cache clean --force
7. # 重新安装（使用--ignore-scripts避免权限问题）
8. npm install -g openclaw@latest --ignore-scripts

第五步：验证安装

1. # 方法1：使用npx临时运行
2. npx openclaw --version
4. # 方法2：检查可执行文件位置
5. where openclaw
7. # 方法3：直接运行
8. openclaw --version

 快速排查表

 备用方案

如果仍无法解决，尝试：

1. 使用CMD代替PowerShell：CMD不受执行策略影响
2. 使用WSL2（推荐）：
   1. wsl --install # 安装WSL2
   2. wsl # 进入Linux环境
   3. # 在WSL中执行OpenClaw安装命令
3. Docker方式：完全避免环境变量问题

 关键提醒

1. 始终以管理员身份运行PowerShell进行安装和配置
2. 安装后关闭并重新打开终端使环境变量生效
3. 如果使用代理，确保网络连接正常
4. 安装过程可能需要几分钟，请耐心等待

按照以上步骤，99%的”command not found”问题都能解决。如果仍有问题，建议查看OpenClaw官方文档或社区寻求帮助。

© 本文著作权归作者所有。转载请联系授权，禁止商用。

🔗 系列文章

1. openclaw能做什么？