关于wsl2部署OpenClaw中LLM request timed out问题解决方法

小龙虾部署遇阻？搞定“LLM request timed out”的实战三步法

折腾了半天，终于把“小龙虾”给装上了。这过程可算不上顺利，中间就卡在了那个经典的“LLM request timed out”错误上。网上的教程和讨论看了不少，试了一圈发现都对不上症结。经过一番排查，最终锁定了问题源头——原来是防火墙在“作祟”。如果你在部署OpenClaw时也碰到了同样的超时报错，不妨跟着下面这三步走一遍，很可能就迎刃而解了。

第一步 查看OpenClaw使用的端口

首先，咱们得摸清楚OpenClaw到底在哪个端口上“待客”。

在WSL2环境中，执行下面这条命令：

sudo netstat -tulpn

（执行前，请确认系统已经安装了网络工具包。如果没安装，先运行下面的命令来装一下；如果已经装好了，跳过这一步就行。）

sudo apt update && sudo apt install net-tools

命令执行后，从输出结果里找到OpenClaw对应的端口号，重点关注“Local Address”那一列的信息，把它记下来。这个端口号就是我们接下来要操作的关键。

第二步 配置防火墙入站规则

拿到了端口号，下一步就是去Windows防火墙里给它开个“绿色通道”。

具体操作很简单：按下键盘的Win+R组合键，在弹出的运行框里输入wf.msc，然后回车。这样就能打开“高级安全Windows Defender防火墙”的管理界面。

在左侧菜单选择“入站规则”，然后在右侧操作栏点击“新建规则…”。

规则类型选“端口”，点击下一步。在特定本地端口里，填入你第一步查到的那个OpenClaw端口号。协议类型保持默认的“TCP”即可。后续步骤依次选择“允许连接”、根据你的网络环境勾选相应的配置文件（域、专用、公用），最后为这个规则起个容易识别的名字，比如“OpenClaw_Port”，完成创建。

这步操作，本质上就是告诉Windows防火墙：“对这个端口的TCP连接请求，一律放行。”

第三步 配置完成后重新启动OpenClaw

规则添加好之后，别忘了重启服务让配置生效。

回到WSL2终端，执行启动命令：

openclaw gateway

服务启动后，再试着去和模型对话一下。如果一切顺利，之前恼人的“LLM request timed out”错误提示就应该消失了，你可以畅快地开始使用了。

说到底，这类问题很多时候就是系统和应用之间的网络策略没对上号。通过端口排查和防火墙规则调整，大部分类似的连接超时问题都能得到解决。当然，如果按照以上步骤操作后问题依旧，那就需要从其他方面，比如代理设置或者服务本身的状态进行更深度的排查了。