AI 工具

    OpenClaw 接 ChatGPT 或其他模型时报错 LLM request timeout

    在 Windows 使用 WSL + Ubuntu 时,我碰到过一个最头疼的问题,现在终于解决了:

    1
    LLM request timed out

    我当时挂了 V2RayN,并开启了 TUN 和 PAC。最开始我一直以为是代理软件本身的问题。确实,关掉 TUN 后有一阵子可以连上;但随后又出现 ChatGPT 无法访问的问题。

    后来我重新梳理目标:我需要的是“在正常访问 ChatGPT 的同时,让 OpenClaw 正常工作”,所以放弃了仅靠关 TUN 的临时方案。

    经过排查,最终确认关键原因是 WSL 网络模式设置:

    1
    networkingMode=mirrored

    将其修改为:

    1
    networkingMode=nat

    问题立刻解决。本文记录完整排查过程和最终方案。


    一、问题现象

    在 OpenClaw UI 中发送消息后超时,于是先在 WSL 中直接测试 OpenAI API:

    1
    curl https://api.openai.com/v1/models

    结果:一直卡住,没有任何返回。


    二、确认 Windows 网络正常

    为了排除主机网络问题,在 Windows PowerShell 中测试:

    1
    curl https://www.google.com

    结果:正常返回 HTML 页面。

    配图建议:PowerShell curl google 成功截图。

    结论:

    • Windows 网络正常
    • WSL 网络异常

    三、在 WSL 中测试网络

    在 WSL 中运行:

    1
    curl https://www.google.com

    结果:一直卡住。

    配图建议:WSL curl google 卡住截图。

    结论:WSL 无法访问外网。


    四、WSL 网络架构背景

    WSL2 并不是 Windows 进程,而是运行在 Hyper-V 虚拟机中。

    网络结构类似:

    1
    2
    3
    4
    5
    Windows
    |
    Hyper-V Virtual Switch
    |
    WSL Linux VM

    WSL 具有:

    • 独立虚拟网卡
    • 独立路由
    • 独立 DNS

    WSL 支持两种网络模式:

    模式 说明
    NAT(默认) WSL 在虚拟子网中,通过 Windows 转发网络
    Mirrored WSL 直接镜像 Windows 网卡

    WSL 默认使用 NAT 网络架构。


    五、问题根因:Mirrored Networking 与 VPN / TUN 冲突

    我的 .wslconfig 配置如下:

    1
    2
    3
    4
    [wsl2]
    networkingMode=mirrored
    dnsTunneling=true
    autoProxy=true

    Mirrored 模式会让 WSL 直接使用 Windows 网卡。理论上可以获得:

    • IPv6 支持
    • LAN 访问
    • localhost 互通

    但在实际环境中,如果系统使用:

    • VPN
    • V2Ray
    • Clash
    • TUN Adapter

    就可能出现:

    • Windows 网络正常
    • WSL 无法访问网络

    微软也确认某些 Windows 更新会导致 Mirrored Networking + VPN 出现网络异常,例如 No route to host。

    核心原因之一是 VPN 虚拟网卡不会响应 ARP 请求,导致 WSL 无法解析网关地址。


    六、最终解决方案

    把 WSL 网络模式从 mirrored 改成 nat。


    七、关键步骤

    1. 修改 .wslconfig

    在 Windows PowerShell 中打开:

    1
    notepad $env:USERPROFILE\.wslconfig

    找到:

    1
    networkingMode=mirrored

    修改为:

    1
    networkingMode=nat

    完整示例:

    1
    2
    3
    4
    5
    [wsl2]
    networkingMode=nat
    dnsTunneling=true
    autoProxy=true
    firewall=true

    2. 重启 WSL

    1
    wsl --shutdown

    这一步非常关键,因为 WSL 只有在完全关闭后才会重新加载配置。

    3. 重新打开 WSL

    重新启动 Ubuntu。


    八、验证网络恢复

    测试 Google:

    1
    curl https://www.google.com

    结果:返回 HTML 页面。

    配图建议:WSL curl google 成功截图。

    结论:WSL 网络恢复。


    九、测试 OpenAI API

    再次运行:

    1
    curl https://api.openai.com/v1/models

    返回示例:

    1
    2
    3
    4
    5
    {
    "error": {
    "message": "Missing bearer authentication in header"
    }
    }

    这个结果是正确的,因为没有提供 API Key。

    结论:WSL -> OpenAI API 链路已恢复正常。


    十、OpenClaw 恢复正常

    回到 OpenClaw:

    1
    http://localhost:18789

    再次发送消息:

    1
    你好

    模型正常返回,问题解决。


    十一、为什么 NAT 能解决问题

    Mirrored 模式

    1
    2
    3
    4
    WSL
    -> 直接使用 Windows 网卡
    -> VPN / TUN
    -> Internet

    如果 VPN 虚拟网卡不响应 ARP:

    • WSL 无法找到网关 MAC
    • 结果:No route to host

    NAT 模式

    1
    2
    3
    4
    WSL
    -> 虚拟子网
    -> Windows NAT 转发
    -> VPN / Internet

    Windows 负责路由和 ARP,因此通常不会受到 VPN 虚拟网卡限制。


    十二、总结

    如果 WSL 出现以下症状:

    • curl 卡住
    • apt update 卡住
    • pip install 卡住
    • OpenAI API timeout

    可以按以下流程排查:

    1. 测试网络
    1
    curl https://www.google.com
    1. 如果失败,检查 .wslconfig
    2. 将网络模式改为 networkingMode=nat
    3. 重启 WSL
    1
    wsl --shutdown

    最终结论

    在 WSL + VPN / 代理 / TUN 环境中,networkingMode=nat 通常比 networkingMode=mirrored 更稳定。

    很多情况下,mirrored -> nat 可以直接修复:

    • WSL 无法联网
    • OpenAI API timeout
    • OpenClaw request timeout

    参考资料