OpenClaw命令未找到主因是Node.js全局bin路径未加入PATH或Node版本低于v22.16；需依系统类型修正PATH配置，并用nvm切换至v24等兼容版本。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在终端中输入 openclaw --version 或 openclaw-cn --version 后提示 command not found，则极大概率是 Node.js 全局 bin 路径未正确写入系统 PATH 环境变量，或 Node.js 本身未满足 OpenClaw 的最低版本要求。以下是针对该问题的多种修复路径：
一、确认并修正 Node.js 全局 bin 路径（macOS / Linux zsh）
zsh 是 macOS Catalina 及更新版本的默认 shell，其配置文件为 ~/.zshrc。若 npm 全局安装的命令无法被识别，说明该路径未纳入 shell 的可执行搜索范围。
1、执行命令获取 npm 全局安装目录：npm prefix -g
2、将该目录下的 bin 子路径追加至 PATH：echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
3、立即加载新配置：source ~/.zshrc
4、强制刷新 zsh 内部命令缓存：rehash
5、验证是否生效：openclaw --version
二、修正 Node.js 全局 bin 路径（macOS / Linux bash）
bash 用户需修改 ~/.bashrc（Linux）或 ~/.bash_profile（旧版 macOS），但部分发行版在非交互式登录时不会自动加载 ~/.bashrc，因此需同步写入 ~/.profile 以确保持久生效。
1、执行命令获取全局路径：npm prefix -g
2、向 ~/.bashrc 追加 PATH 配置：echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc
3、向 ~/.profile 同步写入：echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.profile
4、分别加载两个配置：source ~/.bashrc && source ~/.profile
5、验证命令可用性：openclaw-cn --version
三、Windows PowerShell 环境变量修复（图形界面方式）
Windows 系统需将 npm 全局 bin 目录显式添加至用户级环境变量 PATH 中，此操作通过图形界面完成可确保对所有新启动的 PowerShell 实例生效，且无需重启系统。
1、按 Win + S 搜索“环境变量”，选择“编辑系统环境变量”
2、点击“环境变量”按钮，在“用户变量”区域找到名为 Path 的条目
3、点击“编辑”，再点击“新建”
OpenClaw 安全漏洞检查与配置审计工具。用于检测当前版本已知安全漏洞和公网访问风险，对比版本差异，提供漏洞详情、风险评估、配置审计和升级建议。适用场景：(1) 用户询问检查 OpenClaw 版本安全漏洞，(2) 用户要求检查 OpenClaw 相关安全问题
4、粘贴 npm 全局路径（通常为 C:\Users\用户名\AppData\Roaming\npm）
5、连续点击“确定”保存全部设置
6、关闭当前 PowerShell 窗口，重新打开一个新窗口后执行：openclaw --version
四、Windows PowerShell 环境变量修复（命令行方式）
该方式可在当前会话立即生效，并同步写入用户级环境变量实现持久化，适合批量部署或脚本化操作场景。
1、在 PowerShell 中执行获取路径：$npmBin = npm prefix -g
2、临时添加至当前会话 PATH：$env:Path += ";$npmBin"
3、永久写入用户环境变量：[Environment]::SetEnvironmentVariable("Path", "$([Environment]::GetEnvironmentVariable('Path', 'User'));$npmBin", "User")
4、验证路径已更新：$env:Path -split ';' | Select-String npm
5、执行最终验证：openclaw-cn --version
五、Node.js 版本强制校验与 nvm 切换（全平台通用）
OpenClaw 明确要求 Node.js ≥ v22.16，低于该版本即使命令可执行，运行时也会因语法不兼容崩溃。使用 nvm 可安全切换版本，避免系统级 Node.js 冲突。
1、检查当前版本：node --version
2、若版本不足，先安装 nvm（macOS/Linux）：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
3、刷新 shell 配置：source ~/.zshrc（zsh）或 source ~/.bashrc（bash）
4、安装推荐版本：nvm install 24
5、设为默认版本：nvm alias default 24
6、验证生效：node --version 应显示 v24.x.x
