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/api，Key 和 Model ID 填对，本地代理关掉，重启验证，基本都能解决。剩下的那一成，用第 4 节的 curl 命令一测就知道卡在哪。配置这件事，测一次比猜十次有用。
