Mercury 的 OpenClaw Gateway 模型路由,改到 TaoToken 通道再测 DeepSeek-V3 行不行?
2026/9/21 20:21:10 网站建设 项目流程

1. Mercury 的模型路由为什么卡在 OpenClaw Gateway 这一层

Mercury 这个项目最近在 GitHub 上热度不低,Slogan 打的是「OpenClaw + Hermes 完美合体」。我花了几天把它从安装到深度使用完整跑了一遍,最大的感受是:它的图形界面确实把新手门槛压得很低,扫码登录、点技能市场、一键部署,五分钟能跑起来。但只要你动了「换模型供应商」或者「换底层模型」的念头,就会发现 Mercury 的界面里根本没有入口。

原因在于 Mercury 的三层架构。底层是 OpenClaw Gateway,负责会话管理、工具调用、模型路由和插件系统;中间层是 Hermes 协议,管消息传递、设备配对、多端同步;上层才是 Mercury 自己的封装,也就是你看到的那个深色圆角界面。Mercury 没有改 OpenClaw Gateway 的核心,模型路由这件事完全由 Gateway 决定。界面隐藏了 Gateway 的详细参数,想换供应商或换模型,只能去翻配置文件。

这就对应了原文里提到的痛点:灵活性差、深度定制不容易。我实测下来,Mercury 空闲时内存占用 450MB,原生 OpenClaw 只有 300MB,多出来的部分主要是 UI 渲染和缓存。资源占用高是一方面,更麻烦的是模型通道被锁死。你如果想用 DeepSeek-V3 这类模型,又不想动 Mercury 自身的功能,正确的做法是在 OpenClaw Gateway 的模型路由/供应商配置那一步做文章,而不是去改 Mercury 的界面层。

这篇就按接入配置的视角,把 Mercury 底层 Gateway 的模型路由改到 TaoToken 通道,再测 DeepSeek-V3 能不能正常返回。全程不改 Mercury 自身功能,只动 Gateway 的供应商配置。

2. 前置准备:TaoToken 通道与 Key 的来源

TaoToken 在这里解决的事情很单一:模型通道与 Key 来源。Mercury 上层界面照常扫码登录、点技能市场,底层 Gateway 发出的请求走 TaoToken 兼容通道。你不需要把 TaoToken 理解成什么复杂的东西,它就是一个兼容 OpenAI 接口规范的模型通道,Base URL 填对、Key 填对,Gateway 就能把请求发出去。

注册和创建 Key 的入口在官网,打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end 注册账号,然后在控制台里创建一把 API Key。这里有个细节要注意:Base URL 填https://taotoken.net/api,不带/v1,也不加任何 UTM 参数。很多人习惯性在末尾补/v1,结果 Gateway 拼接路径时变成/v1/v1/chat/completions,直接 404。

Key 就用刚创建的那把,复制出来先放一边。如果你后面想长期跑编码类任务或者 Agent 场景,可以顺带看一下 Coding Plan 的入口;如果只是想验证模型能不能通,用普通 API Key 就够了。接入文档在 https://taotoken.net/doc 可以查到具体的接口规范,模型对话的调试入口在 https://taotoken.net/chat ,API Keys 管理在 https://taotoken.net/api-keys 。

前置准备清单:

项目说明
Base URLhttps://taotoken.net/api不带 /v1,不加 UTM
API Key控制台创建复制后填入 Gateway
目标模型DeepSeek-V3测试用
改动位置OpenClaw Gateway 供应商配置不动 Mercury 界面

3. 可复制配置:把 OpenClaw Gateway 的模型路由指向 TaoToken

Mercury 的配置文件位置取决于你的安装方式。一键安装版通常在用户目录下的隐藏文件夹里,Docker 版在挂载的 volume 里,原生安装版在项目根目录的 config 下。我这边用的是一键安装版,配置文件路径类似~/.mercury/gateway/config.yaml或者~/.openclaw/gateway.yaml,具体以你机器上的实际路径为准。你可以先在 Mercury 界面里点开设置,找到「高级」或「关于」里的配置目录提示。

找到 Gateway 的配置文件后,重点改的是providersmodel_routing这一段。不同版本的 OpenClaw Gateway 字段名略有差异,但核心结构一致:一个 provider 名称、一个 base_url、一个 api_key、一个 models 列表。下面是我实测能跑通的配置片段,你可以直接对照着改。

# OpenClaw Gateway 供应商配置片段 providers: taotoken: type: openai-compatible base_url: "https://taotoken.net/api" api_key: "sk-你的TaoToken密钥" models: - deepseek-v3 - deepseek-chat timeout: 60 max_retries: 2 model_routing: default_provider: taotoken default_model: deepseek-v3 fallback_provider: taotoken fallback_model: deepseek-chat

几个关键点说明一下。typeopenai-compatible,因为 TaoToken 走的是兼容 OpenAI 的接口规范。base_url严格填https://taotoken.net/api,不要自作主张加/v1api_key填你刚创建的那把,注意不要带多余空格。models列表里写你要用的模型名,DeepSeek-V3 对应的标识按接入文档里的写法填,通常是deepseek-v3deepseek-chat,以文档为准。

如果你用的是 Docker 版,改完配置后需要重启容器让配置生效:

docker restart mercury-gateway

原生安装版则直接重启 Gateway 进程:

# 找到 Gateway 进程 ps aux | grep openclaw-gateway # 重启 kill -HUP <pid>

改完配置后,Mercury 界面本身不需要做任何改动。你照常扫码登录、点技能市场,上层感知不到底层换了通道。这就是在 Gateway 层做路由的好处:上层功能不受影响,底层通道可以自由切换。

4. 验证请求:确认 DeepSeek-V3 能返回、调用记录可见

配置改完,接下来要验证两件事:一是 Gateway 能不能把请求发到 TaoToken 并拿到 DeepSeek-V3 的返回,二是调用记录能不能在 TaoToken 控制台看到。

最直接的验证方式是在 Mercury 里发一条消息。打开 Mercury,随便找个对话窗口,输入一句简单的话,比如「用一句话解释什么是模型路由」。如果配置正确,你应该能在几秒内收到 DeepSeek-V3 的回复。如果界面一直转圈或者报错,先别急着改 Mercury,问题大概率在 Gateway 的配置上。

更可控的方式是直接跑一条 Gateway 请求,绕过 Mercury 界面,单独测通道。OpenClaw Gateway 一般会暴露一个本地 HTTP 接口,默认端口可能是 8080 或 3000,具体看你的配置。用 curl 直接打:

curl -X POST http://127.0.0.1:8080/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-你的TaoToken密钥" \ -d '{ "model": "deepseek-v3", "messages": [ {"role": "user", "content": "回复两个字:通了"} ], "stream": false }'

如果返回的 JSON 里有choices字段,且content是「通了」,说明 Gateway 到 TaoToken 的链路是通的。如果返回 401,检查 Key 有没有填错;如果返回 404,检查 Base URL 是不是多加了/v1;如果返回超时,检查网络和timeout配置。

调用记录可见这一项,去 TaoToken 控制台的用量或日志页面看。每发一次请求,那里应该会多一条记录,包含模型名、时间、token 消耗。我实测下来,从 Mercury 界面发消息和从 curl 直接打,两种方式都会在控制台留下记录。这一步能确认请求确实走了 TaoToken 通道,而不是被 Gateway 缓存或者走了别的供应商。

验证通过后,你可以在 Mercury 里多试几个不同的问题,确认 DeepSeek-V3 的回复质量符合预期。如果想把 Mercury 的模型路由接到统一通道,后续所有模型调用都会走 TaoToken,换模型只需要改 Gateway 配置里的default_model,不用动 Mercury 界面。

5. 本篇常见错排查

接入过程中踩过的坑主要集中在几个地方,我按出现频率排一下。

第一个是 Base URL 多加了/v1。这是最常见的错误,表现是 Gateway 返回 404 或者model not found。TaoToken 的 Base URL 就是https://taotoken.net/api,路径拼接由 Gateway 自己处理,你不需要补/v1。改配置的时候把这一行单独拎出来核对一遍。

第二个是 Key 复制带了空格或换行。从控制台复制 Key 的时候,有时候会带上首尾空白字符,填进 YAML 后解析出错,表现是 401 未授权。建议复制后先在文本编辑器里过一遍,确认是干净的一行字符串。

第三个是配置文件路径找错。Mercury 一键安装版和 Docker 版的配置路径不一样,改错了文件等于没改。判断方法很简单:改完配置重启 Gateway,如果 Mercury 里的模型行为没变化,大概率是改错了文件。你可以用find命令搜一下:

find ~ -name "*.yaml" -path "*gateway*" 2>/dev/null find ~ -name "*.yaml" -path "*openclaw*" 2>/dev/null

第四个是模型名写错。DeepSeek-V3 在不同通道里的标识可能不一样,有的写deepseek-v3,有的写deepseek-chat。以 TaoToken 接入文档里的模型列表为准,不要凭记忆填。填错了表现是 Gateway 返回model not found或者直接 400。

第五个是 Gateway 没重启。改完配置文件后,Gateway 不会自动热加载,必须重启进程或容器。很多人改完配置直接在 Mercury 里发消息,发现没生效,以为配置错了,其实是没重启。

第六个是网络超时。如果 Gateway 到 TaoToken 的请求经常超时,把timeout调大一点,比如 120 秒,同时把max_retries设为 2 或 3。DeepSeek-V3 在长文本场景下响应会慢一些,超时设置太短容易误判为失败。

排障的时候,建议按「先 curl 直连 Gateway,再 Mercury 界面发消息」的顺序来。curl 能通说明 Gateway 配置没问题,问题在 Mercury 上层;curl 不通说明 Gateway 到 TaoToken 的链路有问题,重点查 Base URL、Key 和模型名。

6. 把 Mercury 的模型路由接到统一通道

Mercury 的界面封装确实好用,但它的模型路由被锁在 OpenClaw Gateway 里,想换供应商就得翻配置文件。这个设计对新手友好,对想深度定制的人不友好。把 Gateway 的模型路由改到 TaoToken 通道,本质上是在保留 Mercury 上层体验的同时,把底层模型通道的灵活性拿回来。

操作路径很清晰:从 https://taotoken.net/api-keys 创建 Key,把 Base URL 填https://taotoken.net/api,写进 OpenClaw Gateway 的供应商配置,重启 Gateway,然后在 Mercury 里发消息验证 DeepSeek-V3 能返回、调用记录可见。全程不改 Mercury 自身功能,扫码登录、技能市场、多端同步都照常。

如果你后面想跑长期编码任务或者 Agent 场景,可以看一下 Coding Plan 的入口,统一通道的好处是换模型只改一行配置。接入过程中遇到接口规范的问题,接入文档里有详细的字段说明。模型对话的调试可以直接在 https://taotoken.net/chat 里试,不用每次都开 Mercury。

工具是为人服务的,Mercury 的界面省事,TaoToken 的通道给灵活性,两者不冲突。配完之后,你可以在 Gateway 配置里随时切换default_model,Mercury 那边无感。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询