1. OpenClaw 在 Windows 上 local proxy failed 到底是什么OpenClaw 是一个能在本地跑起来的开源 AI 智能体常被叫「小龙虾」核心能力是让模型接管电脑操作整理文件、批量处理表格、自动开浏览器抓数据、定时推送消息。它适合不想写代码、又想让 AI 真正动手干活的 Windows 用户。但很多人装完之后第一次发指令就卡在local proxy failed这个报错上界面显示 Gateway 离线或者请求直接失败。这个报错字面意思是「本地代理失败」。OpenClaw 的架构里客户端和模型服务之间会经过一层本地转发用来统一管理 endpoint、鉴权和请求格式。当这层转发连不上你配置的模型服务地址时就会抛出 local proxy failed。换句话说问题多半不在 OpenClaw 本身而在它要连的那个 endpoint 上。我见过最多的三种情况一是 endpoint 还停留在默认的本地地址比如http://127.0.0.1:11434但本机根本没跑对应的服务二是 endpoint 写成了某个需要额外网络条件的地址在 Windows 上解析不了三是 Base URL 少了/v1或者多了斜杠请求路径拼错。这三种都会表现成同一个 local proxy failed所以排查要从 endpoint 配置入手而不是反复重装。这篇就按「先定位、再改 endpoint、再验证」的顺序走。你不需要懂编程只要会改一个 JSON 文件、会点一次测试按钮就行。下面所有配置片段都可以直接复制把 Key 换成你自己的即可。2. 把 endpoint 指向 TaoToken 的前置准备在改配置之前先把两样东西准备好一个可用的 API Key和一个明确的 Base URL。TaoToken 的 API 入口是https://taotoken.net/api这个地址就是你要填进 OpenClaw 的 endpoint 根路径。注意它不带任何多余后缀OpenClaw 会自己在后面拼/v1/chat/completions这类路径。拿 Key 的流程很简单打开https://taotoken.net/api-keys登录后创建一个新的 Key复制那串以sk-开头的字符串。这个 Key 只显示一次建议先粘到记事本里备用。如果你还没决定用哪个模型可以先去https://taotoken.net/models看一眼当前可用的模型列表把 Model ID 记下来比如常见的对话模型 ID 会直接列在页面上。这里有个容易踩的坑很多人把官网首页https://taotoken.net/当成 API 地址填进去结果请求打到网页上自然连不通。官网是给人看的API 是给程序调的两者不是一回事。填 endpoint 时一定用https://taotoken.net/api。另外OpenClaw 在 Windows 上默认可能带着一个本地 endpoint 配置。你要做的是把它替换掉而不是新增。替换的位置通常在 OpenClaw 安装目录下的config文件夹里文件名可能是settings.json或gateway.json。如果你找不到可以在 OpenClaw 界面里点「设置」→「模型服务」那里一般会直接显示当前 endpoint 和编辑入口。准备阶段还要确认一件事你的 Windows 能正常访问https://taotoken.net/api。可以在浏览器里直接打开这个地址如果返回一段 JSON 而不是超时说明网络层没问题。如果浏览器都打不开那 local proxy failed 就不是配置问题而是网络本身的问题先解决网络再往下走。3. 可复制的 endpoint 配置片段下面这段 JSON 是 OpenClaw 在 Windows 上最常用的模型服务配置结构。你可以直接复制把sk-你的Key换成第 2 步拿到的真实 Key把model换成你想用的 Model ID。路径按你实际的安装位置来常见的是D:\OpenClaw\config\settings.json。{ gateway: { endpoint: https://taotoken.net/api, apiKey: sk-你的Key, model: claude-3-5-sonnet, timeout: 60000, retry: 2 }, proxy: { enabled: false, localPort: 0 } }这里有几个参数值得单独说。endpoint必须是https://taotoken.net/api结尾不要加/v1也不要加斜杠。apiKey就是你的 Key注意不要带引号以外的空格。model填你在模型列表里看到的 ID大小写要一致。timeout单位是毫秒60000 表示 60 秒模型响应慢的时候可以调大。retry是失败重试次数设 2 比较稳。proxy这一段是重点。OpenClaw 的 local proxy failed 很多时候是因为它自己启了一个本地代理端口但这个端口被占用或者没起来。把enabled设为false让它直接走 endpoint可以绕开这一层。如果你确实需要本地代理那就把localPort设成一个没被占用的端口比如 17890然后确认防火墙没拦它。如果你用的是 TOML 格式的配置文件等价写法是这样[gateway] endpoint https://taotoken.net/api apiKey sk-你的Key model claude-3-5-sonnet timeout 60000 retry 2 [proxy] enabled false localPort 0改完保存完全退出 OpenClaw 再重新启动。注意是「完全退出」不是关窗口要在任务栏右下角找到小龙虾图标右键退出否则配置不会重新加载。重启后看界面右上角如果显示 Gateway 在线说明 endpoint 至少被读进去了。4. 验证请求与成功结果配置改完不代表就通了要做一次真实的连通性测试。OpenClaw 界面里一般有个「测试连接」按钮点它会发一个最小请求到 endpoint。如果返回绿色对勾或者显示模型名称说明链路通了。如果没有这个按钮可以手动发一条最简单的指令比如「你好回复一个字」看它能不能正常回。更稳妥的方式是用命令行验证。Windows 上打开 PowerShell执行下面这条命令把 Key 换成你自己的curl.exe -X POST https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer sk-你的Key -H Content-Type: application/json -d {\model\:\claude-3-5-sonnet\,\messages\:[{\role\:\user\,\content\:\ping\}]}如果返回一段包含choices的 JSON里面有模型回复的内容说明 endpoint、Key、Model ID 三件套全部正确。这时候再回到 OpenClaw 发指令local proxy failed 应该就消失了。如果这条命令也失败那问题就锁定在 Key 或 Model ID 上跟 OpenClaw 无关。成功的结果长这样返回体里有choices数组第一项里有message内容是模型对 ping 的回复。看到这个你就可以放心在 OpenClaw 里跑自动化任务了。实测下来从改配置到验证通过整个过程不超过五分钟比反复重装快得多。验证通过后建议把这条 curl 命令存成一个.ps1文件放桌面以后换 Key 或者换模型时先跑一遍能快速判断是配置问题还是 OpenClaw 本身的问题。这个习惯能帮你省掉大量排查时间。5. 本篇常见报错排查报错一local proxy failed 依旧出现但 curl 能通。这说明 endpoint 没问题问题在 OpenClaw 的本地代理层。回到配置文件确认proxy.enabled是false。如果已经是 false 还报检查localPort是不是被别的程序占了。用netstat -ano | findstr 17890看端口占用换一个没被占的端口再试。报错二401 Unauthorized。这是 Key 的问题。常见原因是 Key 复制时带了空格或者用了已经删除的旧 Key。重新去https://taotoken.net/api-keys生成一个新的粘贴时注意首尾不要有空格。还有一种情况是配置文件里 Key 被引号包住但引号是中文引号改成英文引号即可。报错三reading choices 相关错误。这通常出现在返回体解析阶段说明请求发出去了但返回格式不对。检查model字段是不是写错了比如把claude-3-5-sonnet写成了claude-3.5-sonnet。Model ID 必须和模型列表里完全一致。另外确认 endpoint 没有多写/v1因为 OpenClaw 会自己拼路径多写会变成/api/v1/v1/...。报错四OAuth 或鉴权跳转。如果你在配置里误填了需要 OAuth 的地址OpenClaw 会尝试走浏览器鉴权但它是后台服务弹不出浏览器就会卡住报错。确认 endpoint 是https://taotoken.net/api这种纯 API 地址不要填控制台或登录页地址。报错五Gateway 长期离线。先确认配置文件路径对不对OpenClaw 可能读了另一个目录下的配置。可以在界面里点「打开配置目录」确认实际读取位置。然后确认改完配置后是完全退出重启不是关窗口。最后看 Windows 防火墙有没有拦 OpenClaw 的出站请求在防火墙里给它放行即可。排查顺序建议固定成先 curl 验证 endpoint 和 Key再检查配置文件路径和格式最后看本地代理和防火墙。按这个顺序走基本不会绕弯路。6. 配好之后怎么用起来endpoint 通了之后OpenClaw 的能力才真正展开。你可以在主界面底部直接输入自然语言指令比如「整理 D 盘下载文件夹里的图片按创建日期建文件夹分类」它会自动拆解步骤并执行。指令写得越具体执行越准。常用的还有「打开浏览器检索 AI 资讯汇总成 Excel 存桌面」「遍历桌面 Word 文档提取核心内容生成汇总表」这类。如果你打算长期跑编码类或 Agent 类任务可以了解一下 Coding Plan地址是https://taotoken.net/coding-plan适合需要稳定调用、批量执行的场景。只是想先试试模型对话效果可以直接去https://taotoken.net/models看可用模型并在线体验。接入过程中遇到配置问题接入文档在https://taotoken.net/doc里面有各客户端的完整参数说明。回到 local proxy failed 这件事核心就一句话OpenClaw 报这个错九成是 endpoint 没指对。把 endpoint 改成https://taotoken.net/apiKey 和 Model ID 填对本地代理关掉重启验证基本都能解决。剩下的那一成用第 4 节的 curl 命令一测就知道卡在哪。配置这件事测一次比猜十次有用。