openclaw命令无法识别的根本原因是path未正确添加其bin目录路径。需先用test-path验证安装路径是否存在,再用get-childitem确认openclaw.exe存在;若路径有效,则在系统变量path中添加c:\users\%username%\appdata\local\programs\openclaw\bin,关闭所有终端后新开powershell,执行$env:path -split ';' | select-string -pattern 'openclaw'验证路径写入,并运行openclaw --version确认生效。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenClaw部署后环境变量配置错误会导致命令行无法识别openclaw、openclaw-cli等可执行文件,执行时提示“不是内部或外部命令”,根本原因是系统PATH中未正确添加其二进制目录路径或路径拼写错误、权限不足、终端未重载环境变量。
确认OpenClaw安装路径是否真实存在
打开PowerShell(非管理员权限即可),执行:
Test-Path "$env:LOCALAPPDATA\Programs\OpenClaw\bin"
如果返回False,说明OpenClaw未安装到默认位置,或安装过程被中断——此时需重新运行安装程序,【务必勾选“将OpenClaw添加到系统PATH”选项】,否则后续手动配置极易出错。
若返回True,继续执行:
Get-ChildItem "$env:LOCALAPPDATA\Programs\OpenClaw\bin" -Filter "openclaw.exe"
确认该目录下确实存在openclaw.exe文件。不存在则说明安装包损坏,需从官网重新下载安装器。
手动修正系统PATH环境变量
右键“此电脑”→“属性”→“高级系统设置”→“环境变量”;
在“系统变量”区域找到Path,点击“编辑”→“新建”;
粘贴以下路径(注意:末尾不加反斜杠):
C:\Users\%USERNAME%\AppData\Local\Programs\OpenClaw\bin
点击“确定”逐级保存。这一步必须用%USERNAME%动态变量写法,不能直接写成你的用户名,否则多用户环境下会失效。
强制刷新终端环境并验证
第一步:关闭所有已打开的CMD、PowerShell、VS Code终端窗口——【旧终端不会自动读取新PATH,必须彻底关闭再新开】;
第二步:以普通用户身份新开一个PowerShell窗口;
第三步:执行命令:
$env:Path -split ';' | Select-String -Pattern 'OpenClaw'
若输出中包含刚才添加的路径,说明写入成功;
第四步:直接运行:
openclaw --version
能正常打印版本号即表示配置完成。










