1. OpenClaw 本地装完卡在模型配置?先把通道这件事理顺
OpenClaw 在 Windows 11 的 WSL 里跑起来之后,真正让人头疼的往往不是安装,而是模型通道怎么填。openclaw dashboard能打开,控制台也正常,但一到 Config 里的models段就懵了:baseUrl 到底写哪个、apiKey 从哪来、模型 id 和请求通道是不是一回事。我见过太多人把官网地址直接塞进 baseUrl,结果请求一直 404;也有人把带查询参数的链接粘进去,保存后聊天窗口输入 hello 毫无反应。
这篇就按「接入配置视角」把这件事讲透。适合已经在 Windows 11 + WSL 下装好 OpenClaw、准备接一个统一 API 通道的人。核心思路是:OpenClaw 侧保留你熟悉的模型选择(比如 qwen3.5-plus、qwen3-coder-next),但所有模型请求统一走 TaoToken 的 API 地址。这样以后换模型只改 OpenClaw 配置,不用重装环境、不用换机器。
你需要提前准备三样东西:一个能正常打开的 OpenClaw dashboard、一个 TaoToken 的 Key、以及确认 WSL 里能访问外网。下面从拿 Key 开始,一步步配到 hello 测通。
2. 前置准备:TaoToken 拿 Key 与 OpenClaw 环境确认
2.1 注册并创建 Key
打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 完成注册,进入控制台后找到 API Keys 页面,创建一个新的 Key。创建时建议给它起个能认出来的名字,比如openclaw-local,方便以后在多个环境里区分。Key 只在创建时完整显示一次,复制后先存到安全的地方,别直接贴在聊天记录里。
这里有个容易混的点:注册用的官网地址和后面要填的 API 地址不是同一个。官网带utm_source这类参数,是给人看的;API 请求地址是给程序用的,两者不能互换。记住这个区别,后面配置就不会填错。
2.2 确认 OpenClaw 已就绪
在 WSL 终端里执行:
openclaw -v能打印版本号说明安装没问题。再启动控制台:
openclaw dashboard浏览器打开http://127.0.0.1:18789,能看到 Web UI 就说明服务在跑。如果 dashboard 打不开,先确认 WSL 里的进程没退出,必要时重新执行一次启动命令。
3. 可复制配置:把 baseUrl 换成 TaoToken
3.1 进入配置编辑位置
在 dashboard 里依次点 Setting(设置)> Config(配置)> Authentication,然后点菜单下方的 Raw,进入原始 JSON 编辑模式。找到models这一段,准备替换。
3.2 替换 models 配置
下面这份配置可以直接复制,重点看两个字段:baseUrl填https://taotoken.net/api,注意不要加/v1,也不要填带 utm 的官网地址;apiKey填你在 TaoToken 创建的那串 Key。模型 id 保留 OpenClaw 侧的选择,请求通道由 baseUrl 决定。
"models": { "mode": "merge", "providers": { "taotoken": { "baseUrl": "https://taotoken.net/api", "apiKey": "你的_TaoToken_Key", "api": "openai-completions", "models": [ { "id": "qwen3.5-plus", "name": "qwen3.5-plus", "reasoning": false, "input": ["text", "image"], "contextWindow": 1000000, "maxTokens": 65536 }, { "id": "qwen3-coder-next", "name": "qwen3-coder-next", "reasoning": false, "input": ["text"], "contextWindow": 262144, "maxTokens": 65536 } ] } } }, "agents": { "defaults": { "model": { "primary": "taotoken/qwen3.5-plus" }, "models": { "taotoken/qwen3.5-plus": {}, "taotoken/qwen3-coder-next": {} } } }几个参数对照说明:
| 字段 | 填什么 | 说明 |
|---|---|---|
| baseUrl | https://taotoken.net/api | 统一请求入口,不加 /v1 |
| apiKey | TaoToken 创建的 Key | 不要填官网链接 |
| api | openai-completions | 兼容 OpenAI 协议 |
| primary | taotoken/qwen3.5-plus | 主模型,前缀是 provider 名 |
注意:provider 名
taotoken是你自己起的,只要和agents.defaults.model.primary里的前缀一致就行。改完 provider 名,记得把 primary 和 models 里的前缀一起改,否则会找不到模型。
3.3 保存并 Update
配置粘贴完成后,点右上角 Save 保存,再点 Update 让配置生效。这一步别省,很多人只点了 Save 没点 Update,结果聊天还是走旧通道。
4. 验证请求:输入 hello 看是否通
回到聊天窗口,输入hello发送。正常情况下会收到模型回复,说明请求已经通过 TaoToken 的通道发出并返回。如果回复内容正常,模型配置就算通了。
想进一步确认走的是哪个模型,可以在对话里用切换命令:
/model taotoken/qwen3-coder-next或者用命令行方式:
openclaw models set taotoken/qwen3-coder-next切换后再发一条消息,观察回复风格或能力是否符合预期。这一步能帮你确认多模型配置都指向了同一个通道,而不是某个模型偷偷走了别的地址。
5. 本篇常见错排查
5.1 baseUrl 填成官网或带了 /v1
最常见的错误就是把https://taotoken.net/?utm_source=...直接填进 baseUrl。带查询参数的地址是网页地址,不是 API 地址,请求会失败。另一个高频错误是画蛇添足加/v1,正确写法就是https://taotoken.net/api,多一个字符都可能 404。
5.2 apiKey 填错或过期
Key 复制时容易多带空格,或者复制了不完整的片段。建议重新去控制台复制一次,粘贴后检查首尾有没有空白。如果 Key 被删除或重置过,旧 Key 会失效,需要重新创建并更新配置。
5.3 模型前缀和 provider 名不一致
agents.defaults.model.primary写的是taotoken/qwen3.5-plus,但 provider 段里写的是别的名字,就会报找不到模型。检查两处前缀是否完全一致,大小写也要对上。
5.4 改了配置没 Update
Save 只是保存到文件,Update 才是让运行中的服务重新加载。改完配置后养成 Save + Update 的习惯,再不行就重启一次 dashboard。
5.5 WSL 网络问题
如果 hello 一直转圈或超时,先在 WSL 里确认能正常访问外网。可以执行一条简单的网络检查命令,排除是环境网络问题还是配置问题。WSL 的网络通常和 Windows 共享,但偶尔需要重启 WSL 实例。
6. 后续切换模型与长期使用建议
配通之后,OpenClaw 侧换模型就变成改配置的事。比如想从 qwen3.5-plus 切到 qwen3-coder-next,只需要改primary字段,或者用/model命令临时切换,不用动 baseUrl 和 apiKey。这就是统一通道的好处:模型是模型,通道是通道,两者解耦。
如果你打算长期在本地跑 OpenClaw 做编码或 Agent 类任务,可以了解下 Coding Plan 这类方案,配合统一 API 通道使用,token 消耗会更可控。日常调试模型回复是否正常,可以直接在模型对话里试;需要管理 Key 和查看用量,去 API Keys 页面;接入细节有疑问就翻接入文档。这几个入口分工清楚,遇到问题知道去哪找。
最后提醒一句:OpenClaw 的 token 消耗在复杂任务下确实不低,本地部署虽然省了服务器钱,但模型调用成本要心里有数。把通道配稳、模型选对,比反复重装环境划算得多。hello 测通只是起点,后面把常用模型都挂到同一个通道下,切换起来才真的顺手。