1. Win11 下 WSL 跑 OpenClaw 浏览器操作为什么会 401 和 local proxy failed在 Win11 上用 WSL 部署 OpenClaw前面几集我们把安装、Gateway、浏览器扩展都跑通了但真正让浏览器操作跑起来时很多人会卡在两个报错上一个是local proxy failed一个是401 Unauthorized。这两个错误看起来像网络问题实际上大部分是 endpoint 和鉴权配置没对齐导致的。先说清楚 OpenClaw 的浏览器操作是什么。它本质上是让智能体通过一个独立的浏览器实例或者复用你本机 Chrome 的标签页去打开网页、读取 DOM、点击输入、截图。这个过程中OpenClaw 的 Gateway 需要调用一个模型来完成「理解页面 决定下一步动作」而模型调用走的是 HTTP 请求。只要这个请求的 Base URL 或 API Key 不对就会直接 401如果 WSL 里的网络出口和宿主机不一致或者本地代理端口没监听就会报 local proxy failed。适合谁看如果你已经在 Win11 WSL2 里装好了 OpenClawopenclaw browser --browser-profile chrome tabs能列出标签页但一让它执行「打开百度搜索并截图」就报错那这篇就是给你写的。我试过在 WSL 里直接改环境变量、改auth.json、改 Gateway 配置三种方式最后稳定跑通的是把 endpoint 和 Key 统一到 TaoToken 的 API 通道下面把可复制的配置和验证动作完整给你。核心检索词先明确Win11 本地部署 OpenClaw、WSL 浏览器操作、local proxy failed、401 报错、TaoToken API 通道。这几个词你在排障时搜到的方案大多只讲一半要么只改环境变量要么只改配置文件结果两边不一致还是报错。这篇会把三处配置WSL 环境变量、OpenClaw auth.json、Gateway 模型配置一次性对齐。先理解报错链路。OpenClaw 执行浏览器操作时流程是这样的你在终端输入指令 → Gateway 接收 → Gateway 调用模型 API 做推理 → 模型返回动作指令 → OpenClaw 驱动浏览器执行。401 出现在第三步说明模型 API 的 Key 无效或没带上local proxy failed 出现在 Gateway 到模型 API 的网络层说明请求根本没发出去或者发到了一个不存在的本地端口。WSL 环境有个特殊点WSL2 是独立虚拟机它的localhost和 Win11 宿主机的localhost不是同一个。如果你在 Win11 上跑了一个本地代理然后在 WSL 里写http://localhost:端口那请求会打到 WSL 自己身上自然连不上。这就是 local proxy failed 最常见的来源。解决办法不是去折腾端口转发而是直接把 endpoint 指向一个 WSL 能直接访问的公网 API 地址比如 TaoToken 的 API 通道。TaoToken 在这里的角色是统一 Key 和 API 通道。你不需要在 WSL 里再跑一个代理进程也不需要把宿主机的代理端口映射进 WSL。把 Base URL 设成https://taotoken.net/apiKey 用你在控制台生成的统一 Key模型 ID 填你实际要用的模型三处配置一致401 和 local proxy failed 会同时消失。下面先讲前置准备再给可复制配置然后是验证请求和排错。如果你还没拿到 Key先去控制台生成一个地址是 https://taotoken.net/console 生成后复制保存后面三处都要用同一个。2. TaoToken 前置准备统一 Key 与 API 通道怎么拿在改配置之前先把 TaoToken 这边的三件套准备好Base URL、API Key、Model ID。这三样东西后面在 WSL 环境变量、auth.json、Gateway 配置里都要出现而且必须完全一致否则就会出现「环境变量改了但 auth.json 没改」这种半吊子状态报错依旧。Base URL 固定用https://taotoken.net/api。注意这里不要加 UTM 参数API 调用地址就是纯路径。很多人从官网首页复制地址时带了一串?utm_source...粘到配置文件里会导致请求路径异常虽然不一定报 401但会出现 404 或解析失败。API 地址和官网地址是两回事官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end API 是 https://taotoken.net/api 别混。API Key 去控制台生成。打开 https://taotoken.net/console 登录后找到 API Keys 页面新建一个 Key。生成后立刻复制页面刷新后可能不再完整显示。Key 的格式通常是一串以特定前缀开头的字符串长度较长不要手动截断。如果你之前已经生成过直接复用同一个即可不需要每个模型单独建 Key。Model ID 取决于你要用哪个模型。在模型对话页面可以查看当前可用的模型列表地址是 https://taotoken.net/models 。选一个你常用的比如做浏览器操作这种需要理解页面结构和生成动作指令的场景选一个指令跟随能力强的模型。把 Model ID 完整记下来比如claude-sonnet-4-5这种格式后面配置里要原样填。如果你打算长期跑编码和 Agent 类任务可以看一下 Coding Plan地址是 https://taotoken.net/coding-plan 。它适合高频调用场景比按量单独买更省心。但如果你只是先跑通浏览器操作验证用普通 API Key 就够了不用一上来就上套餐。前置准备做完你手里应该有三样东西配置项值来源Base URLhttps://taotoken.net/api固定API Key你的 Key 字符串控制台 API Keys 页Model ID你选的模型标识模型列表页这三样先放在手边下面开始改 WSL 里的配置。改之前建议先备份原文件尤其是auth.json改错了还能回滚。备份命令很简单cp ~/.openclaw/auth.json ~/.openclaw/auth.json.bak后面如果配置乱了直接还原。还有一个前置检查确认 WSL 里能直接访问https://taotoken.net/api。在 WSL 终端执行curl -I https://taotoken.net/api如果返回 HTTP 状态码哪怕是 401 或 404说明网络通如果卡住或报连接失败那是 WSL 的 DNS 或网络配置问题先解决这个再改 OpenClaw 配置。这一步能帮你区分「网络不通」和「鉴权不对」省得后面瞎猜。3. 可复制配置WSL 环境变量 auth.json Gateway 三处对齐这一节是核心三处配置必须同时改缺一处就会继续报错。我按「环境变量 → auth.json → Gateway 配置」的顺序来每处都给可复制的片段。3.1 WSL 环境变量配置在 WSL 终端里编辑你的 shell 配置文件。如果你用 bash是~/.bashrc如果用 zsh是~/.zshrc。用nano ~/.bashrc或vim ~/.bashrc打开在文件末尾追加以下内容# TaoToken API 通道配置 export OPENAI_BASE_URLhttps://taotoken.net/api export OPENAI_API_KEY你的API Key export OPENCLAW_MODEL你的Model ID export OPENCLAW_BROWSER_PROXY这里有几个点要注意。OPENAI_BASE_URL和OPENAI_API_KEY是很多工具链通用的环境变量名OpenClaw 在没读到自己的专属配置时会回退到这两个。OPENCLAW_BROWSER_PROXY设为空字符串是为了显式禁用本地代理避免它去连一个不存在的本地端口这是解决 local proxy failed 的关键一步。保存后执行source ~/.bashrc让配置生效。然后验证echo $OPENAI_BASE_URL echo $OPENAI_API_KEY应该输出你填的值。如果输出为空说明没 source 成功或者写错了文件。注意 Key 不要直接明文写在会提交到 git 的文件里如果你有 dotfiles 仓库把 Key 放到单独的~/.secrets文件里再 source。3.2 auth.json 配置OpenClaw 的鉴权文件在~/.openclaw/auth.json。先备份再编辑cp ~/.openclaw/auth.json ~/.openclaw/auth.json.bak nano ~/.openclaw/auth.json把内容改成下面这样如果文件里已有其他字段保留它们只改和 API 相关的部分{ api: { baseUrl: https://taotoken.net/api, apiKey: 你的API Key, model: 你的Model ID }, browser: { proxy: , mode: chrome-relay } }browser.proxy设为空字符串和上面环境变量里的OPENCLAW_BROWSER_PROXY呼应双重保险禁用本地代理。browser.mode填chrome-relay表示用 Chrome 扩展中继模式如果你用的是托管浏览器模式改成对应的值。保存后检查 JSON 格式是否正确用python3 -m json.tool ~/.openclaw/auth.json验证如果输出格式化后的 JSON 说明格式没问题如果报错说明有语法错误比如多了逗号或少了引号。3.3 Gateway 模型配置Gateway 的配置文件通常在~/.openclaw/gateway.toml或~/.openclaw/config.toml具体路径看你的安装版本。用ls ~/.openclaw/看一下有哪些配置文件。找到包含模型配置的那个编辑[model] base_url https://taotoken.net/api api_key 你的API Key model_id 你的Model ID timeout 120 [browser] proxy headless falsetimeout设 120 秒因为浏览器操作涉及页面加载和模型推理太短容易超时。headless false表示显示浏览器窗口方便你观察执行过程调试阶段建议开着稳定后再改 true。三处配置改完重启 Gateway 让配置生效openclaw gateway restart如果 restart 命令不存在用openclaw gateway stop再openclaw gateway start。重启后查看日志确认没有配置解析错误openclaw gateway logs --tail 50日志里如果出现model base_url loaded或类似字样说明配置读到了。如果出现proxy connection refused说明还有地方在尝试连本地代理回去检查三处配置里的 proxy 字段是否都清空了。4. 验证请求一次浏览器操作调用与预期返回配置改完现在做一次完整的浏览器操作验证。这一步能同时验证模型 API 通不通、浏览器驱动通不通、鉴权对不对。先确认浏览器扩展已连接。在 Chrome 里打开你要操作的页面点击右上角 OpenClaw 扩展图标徽章显示 ON。然后在 WSL 终端执行openclaw browser --browser-profile chrome tabs预期返回当前 Chrome 打开的标签页列表包含标题和 URL。如果这一步就报 401说明 Gateway 到模型 API 的鉴权没过回去检查 auth.json 里的 apiKey 和环境变量是否一致。如果报 local proxy failed检查三处 proxy 字段。标签页能列出后执行一次实际的浏览器操作。下面这个指令让 OpenClaw 打开百度、搜索、截图openclaw run 使用 Chrome 扩展中继模式打开 https://www.baidu.com在搜索框输入 OpenClaw 浏览器操作点击百度一下等待结果加载完成后截图保存到 ~/openclaw-search.png并返回前 3 条结果的标题和链接预期返回分两部分。第一部分是终端里的执行日志你会看到类似[gateway] model request - https://taotoken.net/api [gateway] model response 200 [browser] navigating to https://www.baidu.com [browser] typing into search box [browser] clicking search button [browser] screenshot saved to /home/你的用户名/openclaw-search.png第二部分是模型返回的结构化结果包含前 3 条搜索结果的标题和链接。如果看到model response 200说明 401 问题彻底解决如果看到screenshot saved说明浏览器操作链路通了。验证截图文件是否真的生成ls -lh ~/openclaw-search.png应该看到一个非零大小的 PNG 文件。如果文件不存在检查~路径在 WSL 里是否可写以及 OpenClaw 进程是否有权限。再验证一次模型对话通道确认 Key 在纯文本场景也能用curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer 你的API Key \ -H Content-Type: application/json \ -d { model: 你的Model ID, messages: [{role: user, content: 回复 OK}] }预期返回 JSON包含choices数组第一条 message 的 content 是OK或类似内容。如果返回 401说明 Key 本身有问题去控制台重新生成如果返回reading choices相关错误说明返回结构解析有问题检查 Model ID 是否填对。到这里一次完整的浏览器操作调用就验证完了。整个过程的关键是模型 API 返回 200浏览器动作执行成功截图文件生成。三个都满足说明配置正确。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节把你会遇到的报错逐个拆开对照真实错误信息给排查路径。401 Unauthorized。错误信息通常是{error:{message:Invalid API key,type:invalid_request_error}}。原因有三个Key 填错、Key 没带上、Key 和 Base URL 不匹配。排查顺序先echo $OPENAI_API_KEY确认环境变量有值再cat ~/.openclaw/auth.json确认 apiKey 字段和环境变量一致最后确认 Base URL 是https://taotoken.net/api而不是官网首页地址。如果三处都一致还报 401去控制台确认 Key 是否被禁用或过期。local proxy failed。错误信息通常是local proxy failed: dial tcp 127.0.0.1:7890: connect: connection refused。这里的端口号可能是 7890、1080、8080 等取决于你之前配过什么。根因是 OpenClaw 在尝试连一个本地代理端口但 WSL 里没有这个服务。解决把OPENCLAW_BROWSER_PROXY设为空把auth.json里browser.proxy设为空把 Gateway 配置里browser.proxy设为空。三处都清空后重启 Gateway。如果还报用grep -r proxy ~/.openclaw/搜一下还有哪个文件里残留了代理配置。reading choices 报错。错误信息通常是failed to parse response: reading choices或cannot read property choices of undefined。这说明模型 API 返回的结构和 OpenClaw 预期的结构不一致。常见原因是 Base URL 指向了一个不兼容 OpenAI 格式的端点或者 Model ID 填错导致返回了错误结构。排查用上面第 4 节的 curl 命令直接测 API看返回的 JSON 里有没有choices字段。如果没有说明 Base URL 或 Model ID 有问题。确认 Base URL 是https://taotoken.net/apiModel ID 从模型列表页复制完整。OAuth 相关报错。错误信息可能是OAuth token expired或failed to refresh token。OpenClaw 某些版本会用 OAuth 方式鉴权如果你之前配过 OAuth 又切到了 API Key 模式残留的 OAuth 配置会干扰。排查检查~/.openclaw/下有没有oauth.json或credentials.json之类的文件如果有且你不再用 OAuth重命名备份掉。然后在auth.json里确保用的是apiKey字段而不是oauthToken。Codex auth.json 冲突。如果你同时装了 Codex 类工具它也有自己的auth.json路径可能在~/.codex/auth.json。两个工具的配置文件不要混用。OpenClaw 读的是~/.openclaw/auth.json确认你改的是这个路径。如果两个工具都要用同一个 Key分别配置不要用软链接指向同一个文件因为字段结构可能不同。CC Switch / Cline MCP 场景。如果你在用 CC Switch 或 Cline 的 MCP 模式配置里同样需要 Base URL、Key、Model ID 三件套。CC Switch 的配置通常在~/.cc-switch/config.jsonCline 的在 VS Code 设置里。确保这三处的 Base URL 都是https://taotoken.net/apiKey 用同一个Model ID 一致。任何一处不一致都会导致部分请求 401。排错时养成看日志的习惯。openclaw gateway logs --tail 100能看到最近的请求记录包括请求发往哪个 URL、返回什么状态码。401 和 local proxy failed 在日志里都有明确记录比猜快得多。6. 把浏览器操作稳定跑在 TaoToken 通道上的几个实用技巧配置跑通后还有几个细节能让它更稳定。第一WSL 的 DNS 偶尔会抽风导致taotoken.net解析失败。如果遇到间歇性连接失败在/etc/resolv.conf里加一行nameserver 8.8.8.8或者用sudo sh -c echo nameserver 8.8.8.8 /etc/resolv.conf。注意 WSL 重启后这个文件可能被重置可以写进~/.bashrc里每次启动时检查。第二浏览器操作涉及截图时确保 WSL 里的~目录可写并且路径用绝对路径。相对路径在不同工作目录下会出问题。截图保存后可以用explorer.exe .在 Win11 资源管理器里打开当前 WSL 目录方便查看。第三如果你要长期跑自动化任务把 Model ID 换成一个指令跟随更稳的模型。浏览器操作需要模型理解页面结构并生成精确的点击和输入指令模型能力不够会出现「点错位置」或「输入到错误框」的情况。在模型列表页可以对比不同模型的能力描述。第四Key 的安全管理。不要把 Key 明文提交到 git 仓库。如果~/.bashrc会被同步把 Key 单独放到~/.openclaw/.env文件里在~/.bashrc里用source ~/.openclaw/.env加载并把.env加入.gitignore。第五定期检查 Gateway 日志里的 401 计数。如果偶尔出现 401可能是 Key 轮换或网络抖动。如果频繁出现回去检查三处配置是否被其他操作覆盖了。OpenClaw 升级后有时会重置配置文件升级后重新检查一遍。最后如果你需要更完整的接入文档包括不同工具链的配置示例可以看 https://taotoken.net/doc 。模型对话验证在 https://taotoken.net/models API Key 管理在 https://taotoken.net/api-keys 。长期跑编码和 Agent 任务的话Coding Plan 在 https://taotoken.net/coding-plan 。把这几处配置对齐Win11 WSL 下的 OpenClaw 浏览器操作就能稳定跑起来401 和 local proxy failed 不会再出现。