openclaw onboard 卡在选模型？很多人在 Choose a model provider 这一步粘完 API Key 就报 401，根本不是 OpenClaw 的问题。TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 创建 Key 后，回到向导选 OpenAI-compatible 通道，Base URL 只填 https://taotoken.net/api 就能直接跑通，最后会看到 Onboarding complete 和 Web UI 地址 http://127.0.0.1:18789/?token=xxxx。
新手教程里也常把这一关写成「输入 API Key」一句带过，默认你已经搞定了模型商的账号。真正执行时，下拉框里有月之暗面、MiniMax、智谱，每个平台的 Key 不能互换，Base URL 又各不相同；选错一个就要回到第 3 步反复试。这篇文章把 onboard 报错的两种形态、TaoToken 的简单用法、以及 openclaw.json 兜底配置一次讲全。配置好后你不用记一堆平台地址，记 https://taotoken.net/api 一个就够了。
1. 卡在哪一步：401 不是网络问题，是身份和地址都没对上
1.1 报错长得像连接失败，其实是 Key 或 baseUrl 不对
先看最常见的现象：在向导里选完模型提供商，粘贴 API Key 后回车，终端不出 Onboarding complete，反而弹出一行 Connection failed，下面跟着 401 unauthorized。这行报错跟网络没有关系，401 的意思是“请求到了服务器，但服务器不认识你这把 Key”。换成生活场景，就是你拿 A 公司的工牌去刷 B 公司的闸机，闸机亮红灯是正常的，不代表闸机坏了。
另一种情况是 404 Not Found。请求也发出去了，但拼出来的路径不对，服务端找不到对应的接口。OpenClaw 在连接模型时，会按照你填的 Base URL 去拼接 openai-completions 风格的路径；只要 Base URL 尾部多写一个 /v1，或者漏写某一段，路由就对不上，于是抛出 404。这两种报错在 onboard 向导里出现的频率最高，而它们的共同根源都在第 3 步“模型提供商”和“API Key”这两栏的填写方式上。
1.2 向导下拉框里的选项是为各家官网准备的
onboard 向导里的模型提供商列表，列的是智谱、月之暗面、MiniMax 这些服务商的官方端点。每家的 Key 必须在各自官网注册才能拿到，而且各家 Key 不能互换。如果你只是在教程里看到“去某平台申请 Key”，实际却拿另一家的 Key 来填，或者压根没有那个平台的账号，粘贴进去的结果必然就是 401。
更麻烦的是，不同厂商的默认 Base URL 格式不统一，有的带 /v1，有的带 /v2，还有的带一段很长的项目路径。新人很难分清“这个地址是该填进浏览器访问的官网，还是该填进工具的接口地址”。TaoToken 的做法是把这些差异收拢成一套 OpenAI 兼容格式：你不需要在下拉框里挑选具体厂商，直接选 OpenAI-compatible 或 Custom Provider 这类自定义通道，然后在 Base URL 一栏填 https://taotoken.net/api ，Key 用 TaoToken 控制台签发的，模型 ID 以 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 模型广场当时列表为准。这样无论向导问什么，你回答的都是同一套内容。
2. 安装完成并不意外，onboard 才是第一道门槛
2.1 从 openclaw onboard 到快速开始模式
不管你是用 Windows 一键部署包，还是用官方脚本装完 OpenClaw，打开终端执行openclaw onboard，就会进入初始化配置向导。前面几步通常没有难度：向导会先问是否使用快速开始模式，一路回车默认即可。真正的关键步骤从“选择模型提供商”开始。
这里先把 onboard 向导的完整步骤列成一张表，方便你一边执行一边对照：
| 向导步骤 | 操作 | 说明 |
|---|---|---|
| 选择快速开始模式 | 一路回车 | 默认配置即可 |
| 选择模型提供商 | 选 OpenAI-compatible / Custom Provider | 不要选具体厂商，选通用自定义通道 |
| 输入 API Key | YOUR_API_KEY | 从 TaoToken 控制台创建 |
| Base URL（若向导支持填写） | https://taotoken.net/api | 末尾不要加 /v1 |
| 选择默认模型 | 以 TaoToken 模型广场为准 | 不要照抄旧攻略里的模型名 |
| 选择消息平台 | 先跳过 | 飞书、微信等后续再配置 |
| 按需安装 Skills | 空格勾选 | 文件管理、网页抓取等可以一次装好 |
2.2 默认模型为什么不要照抄网上旧配置
很多教程写配置时会带上具体模型 ID，比如 moonshot-v1-8k。问题在于，OpenClaw 本身不内置模型，模型 ID 必须和你的 API 通道提供方保持完全一致。TaoToken 模型广场上能看到当前可用的模型列表，同一个模型名在不同通道下可能写法不同；与其记忆网上那些旧 ID，不如在向导那一步直接打开模型广场对照着选。选中之后，OpenClaw 会把 provider 和 model 的对应关系写进配置文件，后续你不需要再手动拼模型路径。
有一点要提前知道：部分 onboard 版本的下拉框里没有 OpenAI-compatible 这个选项。遇到这种情况不要卡在向导里，直接退出并跳到第 4 节，用 openclaw.json 配置，效果完全一样。
3. 去 TaoToken 拿 Key：官网管账号，api 地址管通信
3.1 创建 Key 的操作路径
打开 TaoToken 注册并登录，进入控制台的 API Keys 页面，点击创建新密钥，复制出来的字符串就是你要填进 onboard 向导的 YOUR_API_KEY。官网落地页只负责注册、创建 Key、查看模型广场和用量，它和填进工具的接口地址是两回事，不要混用。
创建完 Key 之后，顺便在模型广场确认你想用的模型 ID。你可以在同一个页面看到模型列表和对应的计费说明，心里有数之后再回去配置 OpenClaw，能少走很多弯路。
3.2 Base URL 和官网落地页不是一回事
这是新手最容易弄混的一步。给人的链接和给工具的链接，长得像，用途完全不同：
| 场景 | 地址 |
|---|---|
| 注册、创建 Key、看模型广场与用量 | https://taotoken.net/?utm_source=taotoken_aicg_blog_end |
| 填进 openclaw.json 或 onboard 向导的 Base URL | https://taotoken.net/api |
请注意：https://taotoken.net/api 末尾没有 /v1。OpenClaw 的 api 字段如果用 openai-completions，它会在请求时自动拼好路径；你手动追加 /v1 反而会让路由错位，变成 404。这个地址也不要出现在浏览器里，它不是给人浏览的页面，是给工具连接的接口地址。
4. 把 TaoToken 写进 openclaw.json
4.1 如果 onboard 没有自定义选项，直接改配置
当 onboard 向导的模型提供商列表是固定下拉框、没有自定义通道时，最省事的做法是把模型配置直接写进 OpenClaw 的配置文件。文件位置是~/.openclaw/openclaw.json，Windows 系统在C:\Users\用户名\.openclaw\openclaw.json。这个文件同时保存渠道配置和默认模型选择，OpenClaw 启动时会读取它。
4.2 providers 配置代码
下面是一份可用的配置片段，把 provider 命名为 taotoken，指向 TaoToken 的接口地址：
{ "models": { "providers": { "taotoken": { "baseUrl": "https://taotoken.net/api", "apiKey": "YOUR_API_KEY", "api": "openai-completions", "models": [ { "id": "YOUR_MODEL_ID", "name": "TaoToken Model" } ] } }, "agents": { "defaults": { "model": { "primary": "taotoken/YOUR_MODEL_ID" } } } } }把 YOUR_API_KEY 替换成你在 TaoToken 控制台复制的真实 Key，把 YOUR_MODEL_ID 替换成模型广场上的实际模型 ID，然后保存文件。这里不要凭记忆填模型名，更不要沿用网上旧教程里的 ID，直接去 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 模型广场对照复制，能避免很多“配置看起来没问题但就是连不上”的尴尬。
4.3 用 gateway restart 让配置生效
配置文件保存后，重启 OpenClaw 网关让新配置生效：
openclaw gateway restart openclaw logs --follow日志里会输出 OpenClaw 与模型服务建立连接的记录。如果看到类似 provider connected 或请求成功的日志，说明 TaoToken 通道已经通了；如果日志里出现 401 或 404，继续看第 6 节的对照表。
5. 验证：Onboarding complete 和 18789 端口都要等到
5.1 走到最后一步看到什么
配置正确的话，onboard 向导会顺利走到最后一步，终端输出：
Onboarding complete Web UI: http://127.0.0.1:18789/?token=xxxx-xxxx-xxxx这串地址里的 token 是 OpenClaw 本地生成的临时令牌，作用相当于打开控制面板的钥匙。把整段地址复制进浏览器，你就能看到 OpenClaw 的可视化控制面板。这一步能出结果，说明模型通道已经没有问题，向导不会再卡住。
5.2 在 Web UI 里发一条指令
验证到这里还没结束。控制面板打开之后，在对话框里输入一条简单指令，比如“帮我整理当前文件夹”或“帮我搜索今日热点”，然后观察日志和回复。指令能正常返回内容，说明从 OpenClaw 到 TaoToken 再到模型的整条链路都是通的。如果指令一直在转圈、最后超时，优先回看第 6 节，大概率还是 Key 或模型 ID 的问题。
6. 常见报错对照：401、404 和没换掉的模型 ID
6.1 401 的第一排查项
401 出现时，先检查 API Key 是不是从 TaoToken 控制台创建的。如果你把 openclaw.json 里任何一处 baseUrl 改成了 https://taotoken.net/api ，但 apiKey 还留着旧平台申请的 Key，二者不匹配就会 401。另一个常见原因是复制 Key 时带上了空格或换行符，看起来一样，实际内容不同。建议重新到 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 控制台复制一次，粘贴时留意首尾不要多出空白。
6.2 404 的一半原因是手滑加了 /v1
如果你确认 Key 没问题，但请求还是报 404，回看配置里的 Base URL。TaoToken 的接口地址是 https://taotoken.net/api ，不是 https://taotoken.net/api/v1 ，更不是官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 。多写 /v1 会让 OpenClaw 拼接请求路径时出现双重版本段，服务端自然找不到对应的路由。把 baseUrl 改回 https://taotoken.net/api ，然后 openclaw gateway restart，问题通常就消失了。
6.3 重启后还是旧模型
偶尔有这种情况：配置已经改成 taotoken/YOUR_MODEL_ID，日志也显示连接成功，但对话回复的质量和速度都不对劲。这时候检查 agents.defaults.model.primary 字段，确认它指向的是 taotoken/ 开头；如果还写着旧 provider 的名字，说明你改了 providers 却没有改默认模型指向。模型 ID 建议直接打开模型广场复制，不要靠记忆输入，因为同一个模型的 ID 格式可能在不同时间段调整过。改完后再次 openclaw gateway restart，用一条简单指令重新验证。
7. 跑通之后去控制台对一下这次调用
向导跑通、Web UI 能正常回复之后，回到 TaoToken 模型对话 页面，用同一把 Key 发一条消息试试，确认模型本身能正常回话。这样做的意义是：如果 OpenClaw 这边有问题，你能快速判断是 OpenClaw 的配置问题，还是 Key 或模型的问题。长期用 OpenClaw 跑自动化任务的话，可以在 Coding Plan 里看看套餐是否够用；以后需要新建密钥，直接去 控制台 API Keys 创建。若是后面想把 Claude 模型也接进 Agent 工具，可以参考 Claude Code 接入文档，配置思路和 openclaw.json 里保持一致：Base URL 填 https://taotoken.net/api ，Key 填 YOUR_API_KEY ，模型 ID 以模型广场为准。记住这个固定组合，以后不管换什么 Agent 工具，都不会再卡在选模型这一步。
