1. Windows 下 openclaw-cn 报「不是内部或外部命令」到底卡在哪openclaw-cn不是内部或外部命令也不是可运行的程序或批处理文件——这个报错在 Windows 上装完 npm 全局包之后特别常见。它的意思很直白CMD 或 PowerShell 在当前目录和 Path 列出的所有目录里都没找到一个叫openclaw-cn的可执行文件。注意这里说的不是「包没装」而是「系统找不到入口」。这两件事经常被混为一谈所以很多人反复npm install -g openclaw-cn却始终无效。openclaw-cn本身是一个通过 npm 分发的命令行工具装好之后会在 npm 的全局 bin 目录里生成openclaw-cn.cmdWindows 批处理入口和对应的脚本文件。你敲命令时Windows 只认 Path 里列出的目录如果 npm 的全局 bin 目录不在 Path 中哪怕文件真实存在系统也「看不见」。所以排查顺序应该是先确认包装到哪了再确认那个目录在不在 Path最后确认入口文件是否真的生成。这篇适合三类人刚用npm install -g openclaw-cn装完却敲不动命令的新手换了 Node 版本或重装系统后命令突然失效的人以及想搞清楚 npm 全局路径、Path、命令别名三者关系的人。下面按「定位安装位置 → 配置 Path → 验证生效 → 排错」的顺序走每一步都给可复制的命令。2. 先搞清楚 npm 全局包和 bin 目录的关系在动手改环境变量之前得先理解 npm 在 Windows 上把全局包装到了哪里。npm 有两个关键路径一个是全局包的存放目录prefix另一个是可执行入口的目录全局 bin。在 Windows 上全局 bin 通常就是prefix本身也就是类似C:\Users\你的用户名\AppData\Roaming\npm这样的位置。你可以用下面这条命令直接问 npm全局 bin 目录到底在哪。npm bin -g如果这条命令在你的 npm 版本里已经废弃新版 npm 移除了bin子命令改用npm prefix -g查看全局前缀目录Windows 下可执行文件就生成在这个目录里。npm prefix -g典型输出会是C:\Users\Administrator\AppData\Roaming\npm这个路径就是你要加进 Path 的目标。很多人卡住的原因是他们以为装到C:\Program Files\nodejs去了结果去那里找openclaw-cn.cmd当然找不到。Node 本体在Program Files但 npm 全局包默认在用户目录下的AppData\Roaming\npm两者不是一回事。提示如果你之前改过 npm 的 prefix 配置全局 bin 目录可能被挪到别处。用npm config get prefix也能看到当前生效的值。3. 确认 openclaw-cn 是否真的装上了环境变量的问题要建立在「包确实装了」的前提上。先用这条命令列出所有全局包npm list -g --depth0正常应该能看到类似这样的输出C:\Users\Administrator\AppData\Roaming\npm -- clawhub0.7.0 -- openclaw-cn0.1.8-fix.3只要列表里出现了openclaw-cn说明包已经装进全局目录了。如果这里根本没有它那问题不在 Path而是安装本身失败了需要重新执行npm install -g openclaw-cn安装时留意有没有EACCES、network之类的报错。装完之后再去全局 bin 目录里确认入口文件是否存在。可以直接用 dir 列目录dir C:\Users\Administrator\AppData\Roaming\npm\openclaw-cn*你应该能看到openclaw-cn无扩展名的 shell 脚本和openclaw-cn.cmdWindows 批处理入口这两个文件。只要.cmd在Windows 就能识别这个命令——前提是这个目录进了 Path。4. 把 npm 全局目录写进 Path 的完整操作确认目录和文件都在之后接下来就是把它加进系统环境变量。图形界面操作路径是按Win S搜索「环境变量」打开「编辑系统环境变量」→ 点「环境变量(N)…」→ 在「系统变量」区域找到Path→ 选中后点「编辑」→「新建」→ 粘贴刚才拿到的路径例如C:\Users\Administrator\AppData\Roaming\npm一路点「确定」保存。这里有个容易忽略的点如果你改的是「系统变量」里的 Path需要管理员权限如果只想对当前用户生效改「用户变量」里的 Path 也行效果一样而且不需要管理员权限。两种方式选一种即可不要重复添加同一条路径。如果你更习惯命令行也可以用setx追加但要注意setx会覆盖而不是追加直接写会把原有 Path 冲掉风险较高。稳妥做法还是用图形界面或者用 PowerShell 读取现有 Path 再拼接$old [Environment]::GetEnvironmentVariable(Path,User) $new $old ;C:\Users\Administrator\AppData\Roaming\npm [Environment]::SetEnvironmentVariable(Path,$new,User)执行完这段Path 里就多了 npm 全局目录。改完之后必须重新开一个 CMD 或 PowerShell 窗口旧窗口不会自动刷新环境变量这是最常见的「我明明改了却还是报错」的原因。5. 验证 openclaw-cn 是否生效新开一个 CMD 窗口先确认 Path 里确实包含那个目录echo %Path%在输出里找AppData\Roaming\npm这一段。找到之后直接敲openclaw-cn --version如果输出版本号比如0.1.8-fix.3说明命令已经能被系统识别环境变量配置成功。到这一步openclaw-cn不是内部或外部命令的问题就解决了。如果你还想进一步确认命令解析到了哪个文件可以用wherewhere openclaw-cn它会打印出实际命中的可执行文件路径正常情况下指向C:\Users\Administrator\AppData\Roaming\npm\openclaw-cn.cmd。这一步能帮你排除「Path 里有多个同名命令、命中了旧版本」的情况。6. 本篇常见错排查改了 Path 还是报错。九成是没开新窗口。环境变量在进程启动时读取已经打开的 CMD 不会感知变化。关掉重开再试。Path 里加了目录但where openclaw-cn找不到。回到第 3 步用dir确认openclaw-cn.cmd是否真的在那个目录里。文件不在说明安装没成功或装到了别的 prefix用npm config get prefix核对真实路径。装的时候用了 nvm 切换 Node 版本。nvm 每个 Node 版本有独立的全局目录切换版本后原来的全局包可能不在当前版本的 bin 里。用nvm use切回装包时那个版本或者在新版本下重新npm install -g openclaw-cn。命令别名冲突。如果你之前手动建过openclaw-cn的 doskey 别名或 bat 文件可能指向了错误位置。用where openclaw-cn看命中顺序把多余的删掉。权限问题导致入口文件没生成。某些情况下 npm 全局安装因为权限不足只写了包目录却没生成.cmd。用管理员身份重开终端再装一次或者把 npm prefix 指到用户目录下。排查完这些如果命令能跑起来接下来通常就是配置模型接入。TaoToken 提供统一的 API 入口把 Key 配好之后openclaw-cn这类工具就能直接调用模型。你可以先到 TaoToken API Keys 生成密钥再对照 接入文档 把 base_url 和 key 填进配置。想先验证模型通不通可以直接在 模型对话 里发一条消息测试。如果你打算长期跑编码类任务或 AgentCoding Plan 会更合适配置一次就能持续用。