1. 为什么要把 OpenClaw 的模型通道从 Ollama/混元换掉
OpenClaw 是一个跑在 Windows + WSL 里的本地 AI 助手网关,装好之后你能通过浏览器 Dashboard 跟它对话,也能把它接到飞书之类的工具上。它本身不产出模型能力,只负责把请求转发给某个大模型 provider。问题就出在这个 provider 上:默认安装脚本给的 config.env 里,模型通道是二选一的——要么USE_LOCAL_MODEL=true走本地 Ollama,要么USE_TENCENT_HUNYUAN=true走腾讯混元。
这两条路各有各的别扭。走 Ollama 意味着你得先在 Windows 上装好 Ollama、拉好模型,本地显存和内存直接被吃掉一块,ministral-3:3b 这种小模型跑起来还行,想换个更强的模型就得重新下载、重新配环境。走混元则等于把模型选择锁死在一家,想试试别的模型就得改代码或者等官方支持。我试过在 WSL 里同时维护两套配置,切换一次要改 config.env、重启 Gateway、再验证一遍,很啰嗦。
真正想要的是:OpenClaw 的模型调用走一个兼容 OpenAI 协议的通道,Key 和 Base URL 填进去就能用,想换模型在控制台点一下就行,不用动 OpenClaw 本身的安装。这篇就是按这个思路,把 3.2 里填混元 API Key 的那一步,改成填 TaoToken 的 Key 和 Base URL。TaoToken 在这里只提供两样东西:一把 API Key,一个兼容 Base URL。WSL 安装、Gateway 服务、Dashboard 这些还是 OpenClaw 自己的事,跟 TaoToken 无关。
适合谁看:已经按前一篇把 Windows + WSL 环境准备好、OpenClaw 安装包也下载了,卡在 3.2 配置模型通道这一步的人。如果你还没装 WSL,先去把wsl --install -d Ubuntu-24.04跑完再回来。
2. 动手前先把 TaoToken 的 Key 和 Base URL 拿到
这一步替代原文 3.2 里「方案 B:腾讯混元」的填 Key 操作。打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 注册账号,进控制台创建一把 API Key。创建完先复制出来存好,后面要填进 config.env。
然后记住两个地址,别搞混:
| 用途 | 地址 | 说明 |
|---|---|---|
| 注册 / 创建 Key | https://taotoken.net/?utm_source=taotoken_aicg_blog_end | 带 UTM,从这篇点过去 |
| 兼容 Base URL | https://taotoken.net/api | 填进 config.env,不要加 /v1,不要带 UTM |
这里有个容易踩的坑:很多人看到 OpenAI 兼容接口习惯性写成https://taotoken.net/api/v1,结果请求 404。OpenClaw 的 provider 配置里 Base URL 就填到/api为止,路径拼接由 OpenClaw 自己处理。另外 UTM 参数是给官网统计用的,填进配置里会导致请求地址变成带 query 的怪路径,一样会失败。
Key 拿到后,你可以在控制台里看到当前支持的模型列表。同一把 Key 可以在这些模型之间切换,换模型不用重新申请 Key,这是走兼容通道比绑死单家模型方便的地方。具体支持哪些模型以控制台实际展示为准,这里不编造清单。
注意:TaoToken 只负责 Key 和 Base URL 这两件事。WSL 装没装好、Gateway 服务起没起来、Dashboard 打不打得开,这些都不在它的职责范围内,遇到这类问题要回到 OpenClaw 自己的排障流程。
3. 改 config.env:把模型 provider 指向 TaoToken 兼容通道
回到原文 3.2 的目录,config.env 就在安装openclaw文件夹里。用记事本或 VS Code 打开:
notepad config.env原来的模型选择是二选一,现在把混元那两行注释掉,换成 TaoToken 的配置。改完大概长这样:
# 基础配置 GATEWAY_PORT=18789 GATEWAY_TOKEN=your-secure-token-here WSL_DISTRO=Ubuntu-24.04 WSL_USER=your-wsl-username # 大模型选择:走 TaoToken 兼容通道 USE_LOCAL_MODEL=false USE_TENCENT_HUNYUAN=false # TaoToken 兼容 provider MODEL_PROVIDER=openai-compatible MODEL_BASE_URL=https://taotoken.net/api MODEL_API_KEY=sk-你从TaoToken控制台复制的Key MODEL_NAME=你选定的模型名 # 飞书集成(可选,初学者建议跳过) ENABLE_FEISHU=false几个字段说明一下。USE_LOCAL_MODEL和USE_TENCENT_HUNYUAN都设成 false,避免安装脚本还去走老通道。MODEL_PROVIDER填openai-compatible,因为 TaoToken 提供的是 OpenAI 兼容协议。MODEL_BASE_URL就是上一步记的https://taotoken.net/api,一个字符都别多加。MODEL_API_KEY填你复制的那把 Key。MODEL_NAME填你在控制台选定的模型标识。
如果你手上的 OpenClaw 版本 config.env 字段名跟这里不完全一样,以安装包里 config-template.env 的注释为准,核心是找到 provider 的 base URL 和 apiKey 两个字段,把值换成 TaoToken 的。改完保存,别用 Word 之类的富文本编辑器,会引入不可见字符。
4. 跑安装脚本并验证模型是否真的通了
配置改好后,按原文 3.3 以管理员身份打开 PowerShell,进到安装目录执行:
cd 安装openclaw .\auto-install.bat脚本会依次做 WSL NAT 配置、端口转发、装系统依赖、装 Node.js 24、npm 全局装 OpenClaw、跑 onboard、按 config.env 配模型、起 Gateway。整个过程 5 到 10 分钟,其中「配置模型」那一步会读取你刚填的 TaoToken 配置。如果这一步报错,多半是 Base URL 或 Key 填错了,先回上一步检查。
装完脚本会输出访问地址,类似:
访问地址: http://localhost:18789/?token=your-token-here浏览器打开这个地址进 Dashboard。首次访问可能需要在 WSL 里批准设备:
wsl -d Ubuntu-24.04 -e openclaw devices approve --all然后按原文 4.1,在 Web 对话框输入「你好,请介绍一下自己」,等回复。如果模型通道配对了,几秒内就会有正常回复,说明 OpenClaw 已经通过 TaoToken 兼容通道调到了模型。想确认 Gateway 状态可以跑:
wsl -d Ubuntu-24.04 -e systemctl --user status openclaw-gateway想实时看日志:
wsl -d Ubuntu-24.04 -e journalctl --user -u openclaw-gateway -f日志里能看到请求发往https://taotoken.net/api以及返回状态码,这是判断通道是否生效最直接的证据。
5. 模型无回复时先查这两个字段
原文 5.3 提到模型无回复的排查,走 TaoToken 通道后,排查重点从「Ollama 进程在不在」变成「provider 的 apiKey 和 Base URL 对不对」。按顺序查:
先确认 config.env 里 provider 的 apiKey 字段确实是 TaoToken 的 Key,没有多余空格、没有引号、没有换行。可以用命令读出来核对:
wsl -d Ubuntu-24.04 -e openclaw config get models.providers.openai-compatible.apiKey再确认 Base URL 字段:
wsl -d Ubuntu-24.04 -e openclaw config get models.providers.openai-compatible.baseUrl期望输出就是https://taotoken.net/api。如果看到带/v1或带?utm_source=...,改回干净地址再重启 Gateway:
wsl -d Ubuntu-24.04 -e systemctl --user restart openclaw-gateway其他常见情况:Key 复制时漏了尾部字符、控制台里把 Key 删了或过期了、模型名填了控制台不支持的标识。这些都会表现为请求返回 401 或 404,日志里能看到。Dashboard 打不开属于端口转发问题,跟模型通道无关,按原文 5.2 的netsh interface portproxy流程处理。
提示:改完 config.env 一定要重启 Gateway,配置不会热加载。重启后再发一次「你好,请介绍一下自己」验证。
6. 同一把 Key 在控制台切换模型,OpenClaw 不用重装
通道打通之后,换模型这件事就变得很轻。你不需要改 OpenClaw 的安装,也不需要重跑 auto-install.bat,只要在 TaoToken 控制台里选另一个模型,把 config.env 里的MODEL_NAME改成对应标识,重启一次 Gateway 就生效。同一把 Key 覆盖控制台支持的模型,省掉了为每个模型单独申请凭证的麻烦。
如果你后面要长期跑编码类任务或者接 Agent 工作流,可以了解下 Coding Plan 这类按编码场景组织的方案;只是日常对话验证模型,用模型对话入口就够了。接入过程中遇到 Key 或 Base URL 的问题,对照接入文档排查最快。相关入口:
- 模型对话:https://taotoken.net/api?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite
- Coding Plan:https://taotoken.net/api?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite
- 控制台:https://taotoken.net/api?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite
- API Keys:https://taotoken.net/api?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite
- 接入文档:https://taotoken.net/api?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite
最后留一个实操细节:config.env 改完后,建议先wsl -d Ubuntu-24.04 -e openclaw config get把 provider 相关字段全部读一遍再重启,比直接重启后去 Dashboard 试错省时间。模型通道这类配置,读出来的值跟你以为填进去的值经常不是一回事。