
很多人第一次安装 OpenClaw 会卡在同一个问题上模型能配上但请求发不出去。尤其是使用 OpenAI / Anthropic / Gemini 这类国外模型时网络链路是关键。这篇文章我尽量用“能落地”的方式讲清楚你到底该怎么配怎么测怎么排错。一、先明确OpenClaw 的“联网点”在哪里你在本地跑 OpenClaw但它要访问外部模型服务。所以通常要保证这几段都通你的机器 → 模型 API如 OpenAI你的机器 → 第三方聚合网关你的机器 → OpenClaw Gateway 本地服务通常没问题你真正需要处理的是第 1、2 段的网络可达性。二、常见三种方案方案 A系统全局代理最省心适合新手把系统代理开好后CLI 和 OpenClaw 一般可直接走代理。优点简单、一次配置多处生效缺点不够精细可能影响其它软件方案 B终端环境变量代理推荐只让当前终端会话走代理干净可控。在 PowerShell 中设置示例$env:HTTP_PROXYhttp://127.0.0.1:7890$env:HTTPS_PROXYhttp://127.0.0.1:7890如果你用 SOCKS5部分工具支持可用$env:ALL_PROXYsocks5://127.0.0.1:7890端口7890只是示例按你自己的代理工具端口改。方案 C模型改走中转网关更灵活如果直连某模型不稳定可改成兼容 OpenAI 格式的网关例如 OpenRouter / 自建代理。核心思路把请求发到更稳定的可达地址而不是直连原厂域名。三、OpenClaw 里该配什么1先完成模型认证OpenAI 方向常见两种API Key按量付费Codex / ChatGPT OAuth订阅授权可用安装向导配置或后续补登授权。2确认默认模型是否可用安装后先跑一次模型列表确认 OpenClaw 已识别模型openclaw models list如果模型显示出来但调用失败十有八九是网络链路问题。3按需切换模型做连通性对比例如先切到一个你确认可用的模型测试是否能回包。如果 A 能用、B 不能用基本就是目标服务链路或账号权限问题不是 OpenClaw 主程序坏了。四、最小排错流程非常实用按这个顺序查最快看服务状态openclaw status看模型是否被识别openclaw models list确认代理变量是否生效当前终端echo$env:HTTP_PROXYecho$env:HTTPS_PROXY切换模型做 A/B 测试一个你确定可用的模型一个当前失败的模型看错误关键词timeout / connect reset网络问题401/403鉴权或权限问题model not allowed / not found模型名或账号 entitlement 问题五、稳定性建议优先选你网络下更稳定的 provider准备一个“兜底模型”主模型超时时自动切换不要把代理写死在系统全局除非你明确需要分环境配置工作机/服务器/家里避免互相污染记录一份你自己的“可用组合”模型 代理端口 认证方式六、常见误区误区 1能打开官网就等于 API 一定通不一定API 域名链路和网页链路可能不同。误区 2模型显示在列表里就代表能调用列表是“识别到”不是“网络保证可用”。误区 3只盯 OpenClaw 配置不看系统网络实际上大部分问题都在网络/代理层。结语一句话总结OpenClaw 本身不复杂难点在“你本机到模型服务”的网络路径。把代理策略全局 / 环境变量 / 中转网关理顺再配好认证基本就稳了。