OpenClaw 安装向导卡在 Model/auth provider：改用 Custom Provider 接 TaoToken
如果你正在按 OpenClaw QuickStart 一步步往下走，走到Model/auth provider这一步时大概率会停一下：列表里 Moonshot AI、OpenAI、Anthropic、OpenRouter 一字排开，选哪个都意味着要去对应平台注册、实名、建 Key、再回来粘贴。本文就针对这个卡点，把原来「选 Moonshot AI (Kimi K2.5) + 去 platform.moonshot.cn 建 Key」的流程，改成「打开 https://taotoken.net/ 建一个 TaoToken Key，回到列表选 Custom Provider，填 Base URL 和 Key」。这样 OpenClaw 里统一走 TaoToken 的兼容通道，不用分别注册各家模型平台，同时仍可指定kimi-k2.5这类模型，安装向导能继续完成后面的 Skills / Hooks 配置。
一、原问题与场景：为什么这一步最容易劝退
OpenClaw（原 Clawdbot / Moltbot）的安装脚本本身很顺，curl -fsSL https://openclaw.ai/install.sh | bash跑完，Node.js、Git、npm 包都会自动装好，最后进入 onboarding。真正让人犹豫的是 QuickStart 里的Model/auth provider选择页——它把十几家模型平台平铺出来，每个选项背后都是一套独立的账号体系：
- 选 Moonshot AI (Kimi K2.5)，要去 platform.moonshot.cn 建 Key，还要区分
.cn和.ai两种 Key 类型； - 选 OpenAI / Anthropic，涉及海外账号和支付；
- 选 OpenRouter、Together AI 之类，又是另一套注册流程。
对只想先把 OpenClaw 跑起来、验证一下 agent 能力的人来说，这一步的摩擦成本明显偏高。更麻烦的是，一旦你后面想换模型，还得回到对应平台再建一次 Key、再改一次配置。安装向导里 Skills 和 Hooks 还没配，人已经先被 Key 管理劝退了。
所以更合理的做法是：在Model/auth provider这一步直接选Custom Provider，把模型接入统一收敛到一个兼容 OpenAI 协议的入口上。TaoToken 就是这样一个入口——一个 Key、一个 Base URL，后面想切kimi-k2.5还是别的模型，改模型 ID 就行，不用再动账号体系。
二、TaoToken 前置：先拿 Key，再回向导
在回到 OpenClaw 向导之前，先把两样东西准备好：
- TaoToken Key：打开 https://taotoken.net/ ，注册后在控制台创建 API Key。这个 Key 就是后面要填进 Custom Provider 的凭证。
- Base URL：TaoToken 的兼容接口地址是
https://taotoken.net/api，注意这个地址不带任何查询参数，直接原样填入即可。
如果你习惯用命令行管理，也可以装一下 CLI：
npm i -g @taotoken/taotoken taotoken cc -k YOUR_API_KEY -u https://taotoken.net/api -m MODEL_ID不过对 OpenClaw 的安装向导来说，你只需要 Key 和 Base URL 这两个值。拿到之后，回到那个停在Model/auth provider的终端窗口，把光标移到列表最下方的Custom Provider上回车。
三、可复制配置：Custom Provider 怎么填
选中 Custom Provider 后，向导会依次问你几个字段。按下面这样填：
Base URL
https://taotoken.net/apiAPI Key
YOUR_API_KEY把YOUR_API_KEY替换成你在 TaoToken 控制台创建的那串 Key。注意不要带多余空格，也不要加引号。
Model ID
这里填你想用的模型标识。比如要继续用 Kimi 系列，就填：
kimi-k2.5如果 TaoToken 控制台里该模型有带前缀的完整 ID，以控制台显示的为准。填完之后，向导会显示类似Default model set to custom/kimi-k2.5的确认信息，说明模型已经绑定成功。
这一步做完，OpenClaw 的模型接入就完成了。它不再依赖 Moonshot 官方账号，而是通过 TaoToken 的兼容通道转发请求。后面向导继续走 Skills 和 Hooks 配置时，不会再因为 Key 的问题中断。
四、验证请求与成功结果
配置写完后，最稳妥的验证方式是让 OpenClaw 实际发一次请求。安装向导结束后，如果你选了 Web UI，浏览器会打开一个聊天界面；如果选了 TUI，就在终端里直接对话。随便输入一句测试，比如「你好，介绍一下你自己」。
如果返回正常，说明 Custom Provider 的 Base URL 和 Key 都生效了。此时可以顺手检查一下配置文件，OpenClaw 的配置默认写在：
~/.openclaw/openclaw.json打开它，应该能看到类似这样的结构（字段名以实际版本为准）：
{ "model": { "provider": "custom", "baseUrl": "https://taotoken.net/api", "apiKey": "YOUR_API_KEY", "default": "kimi-k2.5" } }看到baseUrl指向 TaoToken、default是你指定的模型 ID，就说明配置落盘正确。之后无论重启 OpenClaw 还是新开终端，模型接入都会沿用这份配置。
另外，向导在写入配置时会自动备份一份openclaw.json.bak，如果后面改错了，可以直接从备份恢复。
五、本篇常见错排查
1. 填完 Custom Provider 后对话报 401 / 403
优先检查 Key 是否复制完整。TaoToken 的 Key 一般较长，终端粘贴时容易漏掉尾部字符。另外确认 Base URL 是https://taotoken.net/api，不要写成带/v1或其他路径的形式，除非控制台明确要求。
2. 模型 ID 填错导致 404
kimi-k2.5这类模型 ID 必须和 TaoToken 控制台里列出的完全一致。如果控制台显示的是带命名空间的 ID，就按控制台的来。填错模型 ID 时，请求会返回模型不存在的错误，而不是 Key 错误，两者要区分开。
3. 向导里找不到 Custom Provider
Custom Provider 通常在Model/auth provider列表的最底部，紧挨着Skip for now。如果终端窗口太小，列表可能被截断，把窗口拉大或滚动到底部就能看到。
4. 安装阶段 npm install 失败
这和模型配置无关，但很多人会一起遇到。典型报错是CMake 3.19 or higher is required，原因是系统里的 cmake 版本太低。解决办法是升级 cmake，或者改用：
env SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm --no-fund --no-audit install -g openclaw@latest装完后用npx openclaw --version确认版本号。
5. 配置改了但没生效
OpenClaw 启动时会读取~/.openclaw/openclaw.json。如果你是在向导之外手动改的配置，改完要重启 OpenClaw 进程。另外注意 PATH 问题：安装脚本可能提示PATH missing npm global bin dir，如果openclaw命令找不到，按提示把 npm 全局 bin 目录加进~/.zshrc或~/.bashrc。
六、接入文档与后续配置
Custom Provider 配好之后，OpenClaw 的安装向导会继续问 Skills 和 Hooks。Skills 建议新手先选 Skip，因为每次加载会消耗额外 token；Hooks 可以全选，作用是记录历史对话和内容，让 agent 形成记忆。这些都不影响模型接入。
如果你在填 Base URL、Key 或模型 ID 时遇到问题，可以直接对照 TaoToken 的接入文档排查：https://taotoken.net/doc 。需要新建或管理 Key，去控制台：https://taotoken.net/console 。想先验证某个模型能不能通，用模型对话页面发一条测试请求最直接：https://taotoken.net/model-chat 。
把模型接入统一到 TaoToken 之后，OpenClaw 的后续使用会省心很多：换模型只改一个 ID，不用再折腾各家平台的账号和 Key。安装向导也能一路走完，把 Skills 和 Hooks 配好，agent 才算真正跑起来。
