1. Windows 下 OpenClaw 装完却连不上模型问题多半出在配置收尾OpenClaw 在 Windows 上的一键安装脚本跑完之后很多人会卡在同一个地方网关起来了、Dashboard 能打开、openclaw -v也有版本号但一发消息就报模型不可用。这个现象不是安装失败而是安装脚本只负责把运行时和默认配置铺好模型通道这一段它默认留空需要你自己补上。OpenClaw 本身是一个本地网关形态的 Agent 运行框架它把「模型调用」和「工具/插件调用」拆成两层网关负责鉴权、路由、插件挂载模型层则通过一个兼容 OpenAI 协议的 base_url api_key 去请求。默认生成的openclaw.json里agent.model写的是anthropic/claude-opus-4-6这类标识但没有任何凭证来源所以网关启动后第一次真正发起推理就会 401 或超时。这篇面向的是「脚本已经跑完、Node 22 环境就绪、网关能启动」的开发者。要解决的就是配置收尾把模型通道指向一个统一的入口用一份 Key 打通 OpenClaw 的模型调用链路。我实测下来用 TaoToken 作为统一入口最省事因为它同时兼容 OpenAI 与 Anthropic 两种协议风格OpenClaw 里改base_url和api_key两个字段就能通不用为每个模型厂商单独维护一套配置。下面按「先确认现状 → 写配置 → 验证通道 → 排错」的顺序走每一步都给可复制的命令和文件骨架。目标是一次性从安装完成走到「发一条消息能拿到回复」的闭环。2. 前置确认 OpenClaw 网关状态与配置目录在动配置文件之前先把当前状态摸清楚避免改了半天发现改的是旧文件。OpenClaw 在 Windows 下的配置目录固定在用户目录下# 查看配置目录是否存在 Test-Path $env:USERPROFILE\.openclaw # 列出目录内容确认 openclaw.json 在 Get-ChildItem $env:USERPROFILE\.openclaw # 查看当前网关状态 openclaw gateway status # 查看当前生效的配置会打印合并后的结果 openclaw config如果gateway status显示未运行先启动openclaw gateway start --port 18789启动后访问http://127.0.0.1:18789/?token你的token能看到 Dashboard说明网关层没问题。token 可以用openclaw config get gateway.auth.token取出来。接着确认模型层当前指向哪里openclaw config get agent.model openclaw config get agent.base_url openclaw config get agent.api_key大概率后两个是空的或者指向一个你本地并不存在的地址。这就是「装完不能用」的根因。TaoToken 在这里的角色是一个统一模型入口你只需要在它那边生成一个 Key然后把这个 Key 和它的 API 地址写进 OpenClaw 的模型配置OpenClaw 就能通过这一个通道调用到背后多种模型。对 OpenClaw 来说它只是换了一个 OpenAI 兼容的 base_url不需要改任何代码。Key 的获取入口在控制台的 API Keys 页面生成后复制出来注意它只显示一次。地址是https://taotoken.net/api-keys登录后新建即可。如果你还没决定用哪种接入方式可以先在模型对话页面试一条请求确认通道本身是通的再去配 OpenClaw。3. 可复制配置settings.json 与 config.toml 骨架OpenClaw 的配置有两套常见写法一套是网关主配置openclaw.jsonJSON 格式脚本默认生成的就是它另一套是部分版本或插件读取的config.toml。两者字段名接近但结构不同。下面分别给骨架你按自己实际生效的那份改。先看openclaw.json的完整骨架重点是agent段{ gateway: { mode: local, port: 18789, auth: { token: 你的网关token保持脚本生成的原值 } }, agent: { model: claude-sonnet-4-5, base_url: https://taotoken.net/api, api_key: sk-你的TaoTokenKey, protocol: openai, timeout: 120 }, plugins: { dingtalk: {}, feishu: {}, feishu_calendar: {} } }几个字段说明一下。model填你要用的模型标识TaoToken 侧支持多种命名写你实际要调的那个即可。base_url固定填https://taotoken.net/api注意不要带末尾斜杠也不要加 UTM 参数OpenClaw 拼接路径时是直接拼/v1/chat/completions的。api_key就是上一步生成的 Key。protocol建议显式写openai因为 OpenClaw 默认可能按 Anthropic 风格发请求显式声明能避免路径拼错。如果你用的是config.toml版本等价骨架是这样[gateway] mode local port 18789 [gateway.auth] token 你的网关token [agent] model claude-sonnet-4-5 base_url https://taotoken.net/api api_key sk-你的TaoTokenKey protocol openai timeout 120 [plugins.dingtalk] [plugins.feishu] [plugins.feishu_calendar]写入方式有两种。直接编辑文件notepad $env:USERPROFILE\.openclaw\openclaw.json或者用 OpenClaw 自带的 config set 逐项写这样不用手动处理 JSON 转义openclaw config set agent.base_url https://taotoken.net/api openclaw config set agent.api_key sk-你的TaoTokenKey openclaw config set agent.model claude-sonnet-4-5 openclaw config set agent.protocol openai改完必须重启网关让配置生效openclaw gateway restart --port 18789注意api_key写进配置文件后这个文件就是敏感文件。别把它提交到 Git也别贴到公开的 issue 里。脚本生成的备份目录~/.openclaw/backups同样要留意。4. 验证请求一条 curl 确认通道连通配置写完不要急着在 Dashboard 里发消息先用 curl 直接打模型接口把「配置问题」和「网关问题」分开。Windows 的 PowerShell 里curl是Invoke-WebRequest的别名参数不兼容所以显式用curl.execurl.exe -X POST https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer sk-你的TaoTokenKey -H Content-Type: application/json -d {\model\:\claude-sonnet-4-5\,\messages\:[{\role\:\user\,\content\:\ping\}],\max_tokens\:32}返回体里如果出现choices数组和一段content说明 Key 和通道都没问题。如果返回 401是 Key 写错或没生效返回 404多半是 base_url 拼错检查是不是多写了/v1TaoToken 的 base_url 到/api为止/v1/chat/completions由客户端拼。通道确认后再验证 OpenClaw 网关这一层。OpenClaw 网关本身也暴露了一个兼容接口可以用同样的方式打本地curl.exe -X POST http://127.0.0.1:18789/v1/chat/completions -H Authorization: Bearer 你的网关token -H Content-Type: application/json -d {\model\:\claude-sonnet-4-5\,\messages\:[{\role\:\user\,\content\:\ping\}]}这条能通说明「客户端 → 网关 → 模型通道」整条链路都活了。此时再打开 Dashboard 发消息应该能正常拿到回复。如果本地这条报错但直连 TaoToken 那条是好的问题就在 OpenClaw 的配置读取上回到第 3 步检查agent段是否真的写进了生效的那份文件。可以用openclaw config打印合并后的配置来核对它显示的是最终生效值比直接看文件更可靠。5. 本篇常见错排查报错一401 Unauthorized但 Key 明明是对的。最常见的原因是 Key 前后带了空格或换行。用openclaw config set写入时如果从剪贴板粘贴容易带上不可见字符。用openclaw config get agent.api_key打印出来看长度对不对。另一个可能是配置文件里同时存在api_key和apiKey两种写法OpenClaw 只认其中一种多余的字段会干扰。报错二404 Not Found或路径里出现双斜杠。检查base_url末尾有没有斜杠。写成https://taotoken.net/api/会导致拼接出//v1/chat/completions部分服务端会拒绝。统一去掉末尾斜杠。报错三网关重启后配置没变。OpenClaw 的config set写的是用户级配置但如果你之前手动编辑过文件、又用config set改过可能存在两份来源。以openclaw config打印的结果为准它显示的是合并后的最终值。如果打印结果和文件不一致说明有更高优先级的配置覆盖了文件检查是否有环境变量OPENCLAW_AGENT_API_KEY之类的注入。报错四Dashboard 能开但发消息转圈超时。先看网关日志。OpenClaw 的日志一般在~/.openclaw/logs下或者启动时加--verbose直接看控制台输出。超时通常是timeout设得太短或者模型标识写了一个 TaoToken 侧不支持的名称。把timeout调到 120 秒模型标识换成确认可用的再试。报错五protocol没写导致请求体格式不对。OpenClaw 默认可能按 Anthropic 的messages结构发请求而 TaoToken 的 OpenAI 兼容端点期望的是标准 OpenAI 格式。显式写protocol: openai能避免这类结构错位。如果确实要用 Anthropic 风格把protocol改成anthropic同时确认 base_url 对应的端点支持该协议。报错六开机自启后网关起来了但模型不通。脚本里的开机自启用的是计划任务任务启动时的环境变量和交互式终端不同。如果 Key 是通过环境变量注入的计划任务里读不到。解决办法是把 Key 直接写进配置文件而不是依赖环境变量。6. 收尾与后续接入入口走到这里OpenClaw 的安装到可用闭环就完成了脚本铺好运行时配置段补上模型通道curl 验证两层链路排错覆盖了最常见的六类问题。整个过程里真正需要你手动填的只有两个值——网关 token脚本已生成和模型 Key。如果你还没生成 Key去控制台的 API Keys 页面新建一个地址是https://taotoken.net/api-keys。生成后按第 3 步写进agent.api_key即可。想先确认通道本身能不能用可以在模型对话页面直接发一条测试消息比配 OpenClaw 更快定位问题。接入过程中如果卡在某个具体报错接入文档里有各协议的端点说明和字段对照地址是https://taotoken.net/doc。如果你打算把 OpenClaw 长期挂在本地跑编码或 Agent 任务Coding Plan 的额度模型比按次调用更适合高频场景入口在https://taotoken.net/coding-plan。配置这件事没有一劳永逸模型标识和额度会变但 base_url 和 Key 的写入位置是固定的。把这两处记牢下次换模型只改agent.model一个字段重启网关就完事。
