Openclaw(龙虾)部署踩坑指南

最近龙虾工具的热度确实不低，不少技术博主都在分享实测体验。我也跟风安装了一波，这里要特别感谢这篇指南：

2026.3.8最新windows安装龙虾openclaw步骤-CSDN博客

虽然照着步骤部署了下来，过程中还是遇到了几个值得留神的问题。

1.安装Openclaw提示错误码code 128

这个问题多半出在网络环境上。如果你用的是校园网宽带，在确认SSH连接和GitHub访问都没问题后，不妨切换成无线网络试试——有时候就是这么神奇。

2.‘openclaw’ 不是内部或外部命令

安装顺利完成，却在执行时遇到这个提示：

PS C:\WINDOWS\system32> openclaw
openclaw : 无法将“openclaw”项识别为 cmdlet、函数、脚本文件或可运行程序的名称。请检查名称的拼写，如果包括路径，请确保路径正确，然后再试一次。

这通常是因为使用了nvm管理Node.js版本。如果你也用了nvm，需要运行下面这个命令来启动：

npx openclaw onboard

3.聊着聊着宕机

使用过程中突然中断，提示：Agent failed before reply: OAuth token refresh failed for qwen-portal: Qwen OAuth refresh token expired or invalid. Re-authenticate with openclaw models auth login --provider qwen-portal.. Please try again or re-authenticate.

Logs: openclaw logs --follow

具体报错界面如下：

解决方法很简单：

npx openclaw models auth login --provider qwen-portal