1. Windows 装完 OpenClaw 却调不通？先把 settings 里的模型通道换掉
OpenClaw 在 Windows 上装完之后，很多人会卡在同一个地方：openclaw doctor显示环境正常，openclaw gateway start也能跑起来，但真正发一条指令过去，要么转圈半天没反应，要么直接抛一个模型鉴权失败。这个现象在首次本地跑通 OpenClaw 的开发者里非常普遍，原因往往不在 OpenClaw 本身，而在它默认指向的模型通道——安装向导里如果随手选了默认 provider，或者 API Key 填的是某个已经过期、余额不足、区域受限的 Key，通道就是断的。
OpenClaw（俗称小龙虾）本质上是一个“空壳执行器”：它负责调度浏览器、桌面控制、记忆、定时任务这些能力，但真正做推理、理解你指令的那部分，必须外接一个兼容 OpenAI 协议的大模型服务。所以“装完却调不通”的根因，九成出在 settings 配置里的 Base URL、API Key、Model ID 这三件套没有对齐。这篇就聚焦 Windows 环境下 OpenClaw 安装完成后的接入配置环节，把 settings 文件里 Base URL 与 API Key 的可复制改法讲清楚，再附一次最小请求验证动作，确认通道连通、模型能正常返回。
适合谁看：已经在 Windows 10/11 上用管理员 PowerShell 跑完openclaw onboard、openclaw --version能出版本号、但openclaw status或 Web 控制台发消息时报错的开发者。如果你还没装 OpenClaw，建议先把 Node.js 22+ 和 OpenClaw 本体装好，再回来改 settings。本文不重复安装步骤，只解决“装完之后怎么把模型通道接到 TaoToken”这个卡点。
先明确一个概念，避免后面混淆。OpenClaw 的配置分散在两个层面：一个是安装向导openclaw onboard写入的全局配置文件，Windows 下通常在C:\Users\<你的用户名>\.openclaw\openclaw.json；另一个是模型 provider 的 settings 片段，决定请求发往哪个 Base URL、用哪个 Key、调哪个 Model ID。很多人只改了向导里的选项，却没检查落盘的 JSON，结果向导显示成功、实际文件里还是旧值。所以第一步永远是打开那个 JSON 看一眼真实内容，而不是相信向导界面的回显。
我试过在 Windows 上反复重装 OpenClaw 来对比，发现只要 settings 里的 Base URL 结尾多了或少了一个/v1，请求就会 404 或 401，报错信息还特别含糊。这也是为什么本文要把“可复制配置”单独拎出来讲——配置这东西，差一个字符就是通与不通的区别。
2. 接入前的前置准备：TaoToken 的 Base URL、API Key 与 Model ID 怎么拿
在动 settings 之前，先把三件套准备好：Base URL、API Key、Model ID。这三样缺一不可，而且必须来自同一个服务方，否则会出现“Key 是 A 家的、URL 是 B 家的”这种低级但高频的错误。
TaoToken 的 API 入口是https://taotoken.net/api，注意这个地址后面不要自己乱加/v1，具体路径以接入文档为准。API Key 需要你在控制台里创建：打开https://taotoken.net/console，登录后进入 API Keys 管理页，新建一个 Key，复制保存。这个 Key 通常以特定前缀开头，创建后只显示一次，务必当场存好。如果你还没账号，可以先从官网https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=了解整体能力，再进控制台建 Key。
Model ID 这块要特别注意：OpenClaw 的 settings 里填的 Model ID 必须和服务方支持的模型名完全一致，大小写、连字符都不能错。常见的做法是先在模型对话页确认你要用的模型能正常返回，再把同一个 Model ID 抄进 settings。模型对话入口在https://taotoken.net/chat，你可以在这里先手动发一句话，确认这个模型对当前 Key 是可用的，再去配 OpenClaw。这一步能帮你排除掉“Key 没权限调这个模型”的情况。
如果你打算长期用 OpenClaw 跑编码、Agent 类任务，建议顺带看一下 Coding Plan，入口是https://taotoken.net/coding-plan。它的意义在于：OpenClaw 这类工具会频繁发起请求，按量计费容易在调试阶段就把额度烧掉，而包月/套餐形式更适合这种高频调用场景。不过本文的重点是先把单次请求跑通，套餐选择可以等通道验证成功后再决定。
这里插一句踩过的坑：有次我在 Windows 上把 API Key 复制进了 settings，但复制时带了一个看不见的换行符，结果请求一直 401。后来用Get-Content把 JSON 打出来逐字符看，才发现 Key 末尾多了个\n。所以后面给的可复制片段，建议你用纯文本编辑器粘贴，别从聊天窗口直接拖。
准备好三件套后，先别急着改 OpenClaw 的全局配置。更稳的做法是先用一个最小的 HTTP 请求，在 PowerShell 里直接打一次 TaoToken 的接口，确认 Key 和 URL 本身是通的。这样如果后面 OpenClaw 还是报错，你就能确定问题出在 OpenClaw 的 settings 解析上，而不是通道本身。这个最小验证动作我会放在第 4 节，和 OpenClaw 内的验证形成对照。
3. 可复制配置：把 OpenClaw 的 settings 改到 TaoToken
这一节是全文的核心，给出可直接复制的 JSON 片段。Windows 下 OpenClaw 的配置文件路径是：
C:\Users\<你的用户名>\.openclaw\openclaw.json把<你的用户名>换成你实际的 Windows 用户名。如果你不确定路径，可以在 PowerShell 里执行：
echo $env:USERPROFILE输出类似C:\Users\Administrator，那么配置文件就在C:\Users\Administrator\.openclaw\openclaw.json。用记事本或 VS Code 打开它。如果文件不存在，说明openclaw onboard没有真正写盘，需要重新跑一次向导。
下面是一个把模型 provider 指向 TaoToken 的 settings 片段。请把sk-你的实际Key和你的模型ID替换成第 2 节里拿到的真实值：
{ "models": { "providers": { "taotoken": { "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的实际Key", "api": "openai-completions", "models": [ { "id": "你的模型ID", "name": "你的模型ID", "contextWindow": 32768, "maxTokens": 4096 } ] } }, "default": "taotoken/你的模型ID" } }几个关键点必须说清楚。第一，baseUrl写https://taotoken.net/api，不要自作主张加/v1，路径以接入文档为准；如果文档明确要求带/v1，那就按文档来，但不要凭感觉拼。第二，api字段填openai-completions，因为 TaoToken 走的是 OpenAI 兼容协议，OpenClaw 用这个标识来构造请求体。第三，default字段的格式是provider名/模型ID，这里的taotoken必须和上面providers下的键名一致，模型 ID 必须和models数组里的id一致，三处对齐才不会路由失败。
如果你更习惯用 TOML 或者 OpenClaw 的 settings 界面，逻辑是一样的：找到 provider 配置区，把 Base URL 换成https://taotoken.net/api，API Key 换成你的 Key，Model ID 换成你的模型。区别只是文件格式，字段语义不变。改完之后保存，注意编码用 UTF-8，不要用带 BOM 的格式，Windows 记事本默认可能是 ANSI，建议用 VS Code 另存为 UTF-8。
改完 settings 后，建议先做一次语法校验，避免 JSON 里多了个逗号导致 OpenClaw 启动时静默失败：
Get-Content "$env:USERPROFILE\.openclaw\openclaw.json" -Raw | ConvertFrom-Json如果这条命令没有报错，说明 JSON 语法是合法的。如果报ConvertFrom-Json : 传入的对象无效，那就是括号或逗号问题，回去检查。这一步能挡掉相当一部分“配置看起来对但就是不通”的情况。
还有一个容易忽略的点：OpenClaw 可能有多个配置文件，比如全局的openclaw.json和项目级的 settings。如果你在某个项目目录下跑 OpenClaw，它会优先读项目级配置。确认你改的是当前生效的那一份，可以在项目目录下执行openclaw config path（如果该命令存在）或直接看启动日志里打印的配置路径。改错文件是另一个高频坑。
4. 验证请求：一次最小调用确认通道连通、模型正常返回
配置改完，先别急着开 Gateway 跑复杂任务。用最小请求验证，能把问题范围缩到最小。分两步：先在 PowerShell 里直接打 TaoToken 接口，再在 OpenClaw 里发一条指令。
第一步，PowerShell 直接验证。把下面的sk-你的实际Key和你的模型ID替换掉：
$headers = @{ "Authorization" = "Bearer sk-你的实际Key" "Content-Type" = "application/json" } $body = @{ model = "你的模型ID" messages = @( @{ role = "user"; content = "只回复两个字：通了" } ) } | ConvertTo-Json -Depth 5 Invoke-RestMethod -Uri "https://taotoken.net/api/chat/completions" -Method Post -Headers $headers -Body $body如果返回里能看到choices字段，并且message.content是“通了”或类似内容，说明 Base URL、API Key、Model ID 三件套本身没问题。如果这一步就报 401，那是 Key 的问题；报 404，那是 URL 路径的问题；报模型不存在，那是 Model ID 写错了。先把这一步跑通，再进 OpenClaw。
第二步，OpenClaw 内验证。确保 Gateway 在跑：
openclaw gateway start另开一个 PowerShell 窗口，执行：
openclaw status看到 Gateway running 后，用 OpenClaw 的命令行发一条最小指令。具体子命令以你的版本为准，常见形式是：
openclaw run "只回复两个字：通了"或者通过 Web 控制台http://127.0.0.1:18789/发消息。如果 OpenClaw 返回了模型输出，说明 settings 已经被正确加载，通道完全打通。如果 PowerShell 直连成功、但 OpenClaw 里失败，那问题就在 OpenClaw 的配置解析或 provider 路由上，回去检查第 3 节里default字段的provider名/模型ID是否和providers键名、models数组id三处一致。
验证成功后，建议把这次成功的配置备份一份：
Copy-Item "$env:USERPROFILE\.openclaw\openclaw.json" "$env:USERPROFILE\.openclaw\openclaw.json.bak"后面如果折腾其他 provider 把配置改乱了，可以直接还原。这个习惯在反复调试阶段能省很多时间。
5. 常见报错排查：401、local proxy failed、reading choices、OAuth 对照表
这一节按真实报错来对照，都是 Windows 上配 OpenClaw 接 TaoToken 时容易撞见的。
401 Unauthorized / invalid api key：最常见。原因通常是 Key 复制时带了空格或换行、Key 已失效、或者 Key 和 Base URL 不是同一服务方。排查方法：用第 4 节的 PowerShell 直连脚本单独测 Key，如果直连也 401，就是 Key 本身的问题，回控制台https://taotoken.net/api-keys重新建一个。注意 Windows 下从网页复制 Key 容易带上不可见字符，建议先粘到记事本再复制一次。
local proxy failed / connection refused：这个报错通常出现在 OpenClaw 尝试走本地代理时。检查 settings 里有没有残留的proxy字段指向127.0.0.1:某端口，如果有就删掉。另外确认系统环境变量里没有设置HTTP_PROXY、HTTPS_PROXY指向一个不存在的本地端口。在 PowerShell 里执行echo $env:HTTPS_PROXY检查，有值且不是你预期的就清掉。
reading choices / cannot read property 'choices'：这个报错说明请求发出去了，但返回体里没有choices字段，OpenClaw 解析失败。原因通常是 Base URL 路径不对，请求打到了一个返回 HTML 或错误 JSON 的地址。确认baseUrl是https://taotoken.net/api，并且 OpenClaw 拼接后的完整路径是/chat/completions。如果服务方文档要求带/v1，就按文档补上，但不要两边都加导致/v1/v1。
OAuth / token expired：如果你之前用 OAuth 方式登录过某个 provider，settings 里可能残留了 OAuth token 字段，而 OpenClaw 优先读它，导致忽略了你新填的 API Key。解决办法是在 settings 里删掉oauth相关字段，只保留apiKey。Codex 的auth.json如果存在，也要检查里面有没有旧的凭据覆盖。三件套（Base URL + Key + Model ID）必须同时正确，缺一个都会以各种奇怪的报错形式出现。
模型上下文窗口太小 / context length exceeded：OpenClaw 的 Agent 任务会带较长的上下文，如果 Model ID 对应的模型窗口太小，会在多轮后报错。在 settings 的models数组里把contextWindow设成模型实际支持的值，比如 32768。注意这个值要和模型真实能力一致，填大了服务端会拒绝。
JSON 解析失败 / 配置未生效：用第 3 节的ConvertFrom-Json校验语法。另外确认改的是当前生效的配置文件，项目级配置会覆盖全局配置。Windows 路径里的反斜杠在 JSON 里要转义成\\，但本文给的片段里没有路径字段，所以不涉及这个问题。
排查顺序建议：先 PowerShell 直连测 Key 和 URL，再校验 JSON 语法，再看 OpenClaw 启动日志里打印的配置路径和 provider 名，最后对照default字段的三处一致性。按这个顺序走，基本能定位到具体哪一环断了。
6. 通道跑通之后：把 OpenClaw 接到长期可用的模型服务上
最小请求验证通过，只代表“这一次”通了。OpenClaw 的实际使用场景是长时间挂机、自动刷网页、定时任务、多轮 Agent 调用，这对模型通道的稳定性和额度管理提出了更高要求。如果你只是临时试一下，按量计费没问题；但如果你打算让 OpenClaw 每天跑任务，建议把模型服务换成更适合高频调用的形式。
TaoToken 的 Coding Plan 就是为这类长期编码、Agent 场景准备的，入口在https://taotoken.net/coding-plan。它的价值在于把不可预测的按量消耗变成可预期的套餐，避免 OpenClaw 在后台跑一夜把额度跑光。配置方式不变，还是第 3 节那三件套，只是 Key 换成套餐对应的 Key。
另外，OpenClaw 支持多 provider 并存。你可以在 settings 的providers下同时保留 TaoToken 和其他 provider，通过default字段切换当前使用哪个。这样在某个通道临时波动时，改一行default就能切走，不用重装。切换后记得重启 Gateway：
openclaw gateway stop openclaw gateway start最后给一个实用技巧：把第 4 节的 PowerShell 直连验证脚本存成一个.ps1文件，比如check-taotoken.ps1，每次改完 settings 先跑它。脚本里把 Key 和 Model ID 做成参数，避免硬编码。这样以后换 Key、换模型，改参数就行，验证动作标准化，能省掉大量“改了配置不知道哪错了”的时间。通道通了之后，OpenClaw 才真正开始干活，而一个稳定的模型通道，是它 24 小时不休息的前提。