如果你照着 Hermes 一条龙安装指南走PowerShell 里执行irm https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex然后hermes setup选 1 快速安装、选 17 DeepSeek、填 api-key最后hermes gateway setup选 14 扫码连 QQ整套流程看起来是通的。真正容易卡住的是模型 Key原来要单独去 DeepSeek 官方申请额度、计费、失效、换模型都多一个后台。把这一步改到 TaoToken 后安装命令不动、QQ 网关不动只在hermes setup里把模型提供商的凭据换成 TaoToken 创建的 KeyBase URL 填https://taotoken.net/api。准备动作就一件事打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 注册并创建 API Key后面所有YOUR_API_KEY都从这里来。1. Hermes 一条龙安装卡在 DeepSeek Key 这一步1.1 原文流程复现PowerShell 装完、setup 选 17、gateway 选 14Hermes 的安装流程之所以叫“一条龙”是因为它把安装、模型设置、消息连接拆成了几个很明确的命令行步骤。第一步是 PowerShell 安装脚本第二步是hermes setup第三步是hermes启动第四步是hermes gateway setup接 QQ。每一步都有交互菜单选数字就行不需要先研究一堆配置文件。原本文档里模型部分会让你在hermes setup里选1快速安装再选17DeepSeek然后把 DeepSeek 官方申请的 api-key 填进去。这个设计对第一次跑通 Agent 的人很友好但用一段时间后就会出现一个现实问题Hermes 本身能一条龙装完模型 Key 却还得回到 DeepSeek 官方后台单独管理。你要是同时还在用其他 AI 编程工具就会变成多个后台、多把 Key、多个账单入口。更麻烦的是QQ 机器人这种场景通常会长期挂着。Key 失效、额度到顶、想从 DeepSeek 换成另一个模型时如果 Key 绑死在 DeepSeek 官方你就得重新申请、重新填、重新启动网关。安装命令没变但维护成本被模型 Key 拉高了。1.2 真正要换的不是安装命令而是 hermes setup 里的模型凭据把 Hermes 的模型 Key 改到 TaoToken核心不是重装 Hermes也不是改掉hermes gateway setup。安装脚本继续用原来的 PowerShell 命令QQ 机器人继续选第 14 项扫码连接真正动的只有hermes setup里的模型供应商凭据。你可以把 Hermes 理解成一套已经装好的消息流水线QQ 消息进来Hermes 负责调度模型负责生成回复网关负责把回复送回去。流水线本身不需要拆只需要把“模型供应商”那一段从 DeepSeek 官方换成 TaoToken 的统一 API 通道。这样 Hermes 仍然以为自己在调用 DeepSeek 提供商但请求实际走https://taotoken.net/apiKey 也从 TaoToken 创建。这样改的好处很直接Hermes 安装照常QQ 扫码照常换模型不用翻回 DeepSeek 官方。后续要调整模型只在 TaoToken 控制台处理要新建 Key也只在一个地方创建。对已经跑通一条龙安装的人来说改动面小回归验证也简单。1.3 切到 TaoToken 后哪些步骤保留、哪些步骤只改一处保留的部分包括PowerShell 一键安装命令、hermes setup的1快速安装入口、17DeepSeek 这个提供商选项、hermes gateway setup的14QQ 机器人设置、扫码连接流程以及最后直接输入hermes启动。这些步骤在原文里已经验证过不需要另起一套。需要改的部分只有两处第一hermes setup里要求填 api-key 时不要再填 DeepSeek 官方 Key改填从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 创建的YOUR_API_KEY第二如果 setup 过程中出现 Base URL、Endpoint 或 API 地址输入项填https://taotoken.net/api末尾不要带/v1。模型提供商仍然选17DeepSeek是因为 Hermes 的菜单里把 DeepSeek 作为一个供应商类型。你只是把它的实际接入地址和 Key 换成 TaoToken 提供的兼容通道。这样既不用改 Hermes 源码也不用在 QQ 网关里动模型参数。2. 到 TaoToken 创建 Hermes 要用的 API Key 与模型入口2.1 打开官网完成注册和 API Key 创建准备材料里最重要的一项就是 API Key。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 完成注册登录然后进入控制台创建 API Key。创建出来的字符串先复制到安全位置本文统一写成YOUR_API_KEY你在hermes setup里填真实 Key 时不要带引号也不要多复制空格。如果你之前已经有一把 Key但不确定还在不在重新建一把专用 Key 更稳。Hermes 这类长期在线的 Agent 建议单独一把 Key方便后面在控制台看调用记录也方便失效时直接替换。创建入口在 TaoToken 的 API Keys 页面Key 只显示一次复制后自己保存好。不要把 Key 写进公开的脚本、截图或聊天记录。本文所有示例都用YOUR_API_KEY占位你实际配置时只在本机终端输入。这样既符合 Hermes 的交互式 setup 习惯也避免 Key 泄露后还要重新建。2.2 在模型广场确认 DeepSeek 模型 ID不要猜Hermes 的hermes setup选17之后可能会让你选择具体模型也可能使用默认模型。具体模型 ID 不要凭记忆填更不要随便加日期后缀。以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 模型广场当时列表为准看到对应的 DeepSeek 模型 ID 再填。如果你在 setup 里没有看到模型 ID 输入项就先把提供商和 Key 配好等 Hermes 启动后用一条测试消息验证。后面想换模型再去 TaoToken 控制台调整或重新创建 Key 绑定。不要为了“看起来更完整”编一个不存在的模型名Hermes 在启动阶段可能不报错真正发消息时才失败排查反而麻烦。模型广场的列表会随可用模型变化所以本文不写死某个 ID。你只需要记住提供商选17Base URL 用https://taotoken.net/api模型 ID 以模型广场为准。2.3 准备 Base URLhttps://taotoken.net/api 末尾不要 /v1Base URL 是这次切换里最容易填错的一项。正确写法是https://taotoken.net/api不要写成https://taotoken.net/api/v1。Hermes 的 DeepSeek 提供商适配层通常会在内部拼接路径你多写一个/v1请求就可能走到不存在的地址上表现为连接失败、404 或模型不回消息。另外Base URL 不要带 UTM 参数。?utm_sourcetaotoken_aicg_blog_end是官网落地页用于注册、创建 Key、看模型广场、看用量的不要把它加到 API 地址里。配置到工具里的地址保持干净https://taotoken.net/api。可以先把这两项写在记事本里Key 用YOUR_API_KEYBase URL 用https://taotoken.net/api。等hermes setup走到对应输入项时直接粘贴减少手打出错。3. PowerShell 一键装 Hermes安装命令与原文保持一致3.1 PowerShell 执行 irm 安装脚本安装阶段不需要因为换 Key 而改命令。打开 PowerShell执行原文里的一键安装脚本irm https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex这条命令会下载并执行 Hermes 的安装脚本。执行过程中如果遇到权限提示按正常 PowerShell 脚本运行方式处理。安装完成后关闭当前终端再重新打开一个让新加入的环境变量和命令路径生效。安装脚本本身不负责你的模型 Key所以这里不用填 DeepSeek 官方 Key。把 Key 留到hermes setup阶段填 TaoToken 的YOUR_API_KEY流程会更清晰。3.2 安装后先确认 hermes 命令能跑安装结束后先确认hermes命令已经可用。可以在 PowerShell 里输入hermes --help如果能看到命令帮助说明安装成功。如果提示找不到命令先检查是不是没有重开终端或者安装脚本把可执行文件放到了当前会话未加载的路径。Windows 下这类问题多数重开一次 PowerShell 就能解决。这一步不要急着启动hermes聊天。原文的顺序是先hermes setup配模型和消息连接再启动。安装完成只代表程序就位模型 Key 和 QQ 网关还没配。3.3 安装阶段不要提前填 DeepSeek 官方 Key有些安装脚本或首次运行引导可能会顺带问你要不要配置模型。如果它问的是模型 Key你先跳过等进入hermes setup再统一填。因为这次的目标是把 Key 来源换成 TaoToken提前填了 DeepSeek 官方 Key后面还要改回来容易把两把 Key 搞混。另外不要把 DeepSeek 官方 Key 和 TaoToken Key 同时塞进同一个配置里。Hermes 的提供商选项虽然还是17DeepSeek但实际应该只使用 TaoToken 创建的那把YOUR_API_KEY。旧 Key 如果已经失效更不要留在环境变量或历史脚本里。4. hermes setup 选 1、选 17把 Base URL 指向 TaoToken4.1 选择 1 快速安装只配模型提供商和消息连接安装确认完成后在 PowerShell 里执行hermes setup进入设置菜单后按原文选择1quick setup快速安装。这个入口只进行模型提供商和消息连接设置适合已经装好 Hermes、只想把模型 Key 换掉的情况。你不需要重新跑完整安装也不需要删掉之前的 QQ 网关配置。如果你之前已经配过 QQ 机器人快速安装里仍然可能让你重新选择消息连接。按原文继续走即可模型部分重点改 Key 和 Base URL消息部分如果已经扫码成功可以保留原设置或重新扫码验证。4.2 选择 17 DeepSeekapi-key 填 YOUR_API_KEY在模型提供商菜单里仍然选择17也就是 DeepSeek。接下来出现 api-key 输入时填从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 创建的YOUR_API_KEY。不要填 DeepSeek 官方申请的那把 Key也不要填其他工具的 Key。输入 Key 时注意终端可能不回显字符这是正常现象。粘贴后按回车继续。如果 Key 前后带空格可能导致鉴权失败粘贴后可以先确认一下剪贴板内容或者手动删掉首尾空格。这一步完成后Hermes 会把这个提供商凭据保存到自己的配置里。你不需要在 QQ 网关里再填一次模型 Key网关只负责消息连接。4.3 Base URL 填 https://taotoken.net/api模型 ID 以模型广场为准如果hermes setup在选完17后询问 Base URL、Endpoint 或 API 地址填https://taotoken.net/api末尾不要加/v1也不要加任何查询参数。如果它询问模型 ID打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 模型广场按当时列表里的 DeepSeek 模型 ID 填写。列表里没有的 ID 不要填日期后缀也不要自己拼。如果 setup 没有让你填 Base URL只让你填了 api-key那也先继续。不同版本的 Hermes 交互项可能略有差异后续启动后通过实际发消息验证。只要 Key 来自 TaoToken模型提供商选17大多数情况下就能走兼容通道。4.4 setup 完成后检查关键项是否落盘hermes setup结束后不要立刻关掉终端。先看一遍输出摘要确认提供商是17、Key 尾号和你刚创建的一致、Base URL 没有多出/v1。如果你在 setup 里看到保存路径或配置文件位置可以记下来但不要手动把 Key 贴到公开位置。有些版本会在 setup 结束时提示运行hermes启动。你可以先不启动回到 PowerShell 检查一下hermes命令是否仍然正常。确认无误后再进入 QQ 网关设置。5. hermes gateway setup 选 14QQ 机器人扫码连接照常走5.1 启动 gateway setup 并选择第 14 项模型 Key 配好后消息连接仍然按原文走。在 PowerShell 里执行hermes gateway setup进入消息连接设置界面后选择第14项QQ 机器人设置。这一步和模型 Key 无关只是把 Hermes 的消息网关接到 QQ。你之前如果已经配过可以检查是否仍然保留如果没有就按菜单继续。选择 QQ 机器人后Hermes 通常会给出一个网址或一个二维码入口。按屏幕提示继续不要在这一步填模型 Key。5.2 扫码连接 QQ模型链路先单独验证进入扫码连接后终端会显示一个网址。把这个网址复制到浏览器打开页面上会出现二维码。用手机 QQ 扫码按提示完成连接。扫码成功后网关侧通常会显示连接状态或机器人信息。扫码成功只代表 QQ 消息通道通了不代表模型一定通。建议先不要在群里发复杂指令先用 Hermes 自己的测试入口或命令行发一条简单消息确认模型能回包。如果模型回包正常再去 QQ 里测试消息收发。5.3 网关设置与模型 Key 不要混在一起改QQ 网关设置里可能还会出现 token、回调地址、机器人 ID 之类的信息这些和模型 API Key 是两回事。不要把YOUR_API_KEY填到 QQ 机器人 token 里也不要把 QQ 的密钥填到模型 api-key 里。分清楚之后后面排障会简单很多。如果你在网关设置里需要填服务器地址或回调地址按 Hermes 和 QQ 机器人平台的提示填。本文只改模型 Key 和 Base URL不改变消息网关的接入方式。6. 启动 hermes 后验证 QQ 消息与模型回包6.1 直接输入 hermes 启动模型和网关都设置好后回到 PowerShell直接输入hermesHermes 会启动并加载之前的配置。启动过程中留意终端有没有报鉴权错误、连接错误或模型不存在。如果没有明显报错说明配置至少被读进去了。如果启动时立刻提示 Key 无效优先检查hermes setup里填的是不是 TaoToken 的YOUR_API_KEY以及 Base URL 有没有多写/v1。如果启动正常就可以进入下一步实际发消息。6.2 在 QQ 里发一条消息观察是否走 TaoToken打开手机 QQ给已经扫码连接的机器人发一条简单消息比如“你好测试一下”。观察 Hermes 终端是否收到请求以及 QQ 里是否收到模型回复。正常情况应该能在几秒到十几秒内看到回复具体取决于模型和当前网络。如果 QQ 里没有回复先看 Hermes 终端。如果终端显示模型请求失败问题在模型 Key 或 Base URL如果终端连消息请求都没收到问题在 QQ 网关连接。先分辨是哪一段再回去改对应设置。6.3 回控制台看这次调用是否记上模型链路通之后回到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 控制台看这次调用的记录和用量。能看到请求记录说明 Hermes 的请求确实走了 TaoToken而不是还在用旧的 DeepSeek 官方 Key。这个动作也能帮你确认 Key 是否绑定正确。如果控制台没有记录但 QQ 机器人却能回复说明你可能还在用旧的官方 Key 或本地缓存配置。回到hermes setup重新检查提供商17下的 Key 和 Base URL再启动一次hermes验证。7. Hermes 换 Key、换模型、连接报错怎么排查7.1 机器人不回消息先分辨 QQ 网关问题还是模型 Key 问题QQ 机器人不回消息时不要一上来就重装 Hermes。先看终端日志如果能看到来自 QQ 的消息进入 Hermes但模型请求报错那就是模型 Key、Base URL 或模型 ID 的问题如果终端完全没有消息进入记录那就是 QQ 网关没有连上重新执行hermes gateway setup选14扫码即可。模型 Key 问题常见表现是鉴权失败、额度不足、模型不存在。这时候回到hermes setup确认 api-key 是YOUR_API_KEY对应的真实 KeyBase URL 是https://taotoken.net/api。如果 Key 刚在控制台重建过旧 Key 会立即失效需要重新填一次。7.2 Base URL 多写 /v1 或 Key 用错的表现https://taotoken.net/api/v1是本次配置里最常见的错误写法。多出的/v1可能让 Hermes 在内部拼接后请求到错误路径表现为连接失败、404 或模型无响应。正确地址只保留https://taotoken.net/api末尾不要斜杠、不要/v1、不要 UTM 参数。另一种常见错误是 Key 用错把 DeepSeek 官方 Key 填进了hermes setup。如果你的 DeepSeek 官方 Key 还有额度机器人可能也能回但控制台看不到 TaoToken 的调用记录如果官方 Key 已失效就直接报鉴权错误。统一换成 TaoToken 创建的那把 Key才能让后续换模型、看用量都集中在一个地方。7.3 后续换模型只在 TaoToken 控制台换不用翻 DeepSeek 官方Hermes 跑通之后换模型不用重新走一遍安装。你可以在 TaoToken 控制台调整模型或重新创建 Key 绑定然后回到hermes setup检查模型 ID 是否要同步更新。具体模型 ID 仍然以模型广场当时列表为准不要凭记忆填。QQ 网关部分不需要因为换模型而重配。模型 Key 和消息连接是两层模型层换 Key、换模型网关层只负责 QQ 消息进出。分开理解之后后续维护会轻松很多。8. 下一步把 Hermes 的调用记录和套餐对一下8.1 用同一把 Key 在模型对话里发测试消息Hermes 和 QQ 机器人验证通过后可以拿同一把 Key 在 TaoToken 模型对话 里发一条测试消息。这样做的好处是把问题范围缩小如果模型对话能回说明 Key、Base URL 和模型 ID 都没问题QQ 不回就查网关如果模型对话也不回就回到 Key 和 Base URL 继续查。测试时不用发业务内容简单一句“测试连接”就够。注意不要在公开截图里暴露完整 Key也不要把聊天记录直接贴到公开地方。8.2 长期跑 Agent 看 Coding Plan如果 Hermes 只是偶尔用按量调用即可。如果是长期挂 QQ 机器人、经常跑 Agent 流程可以打开 Coding Plan 看一下套餐是否够用。这里不写具体价格和额度以页面当时展示为准。选套餐之前先回控制台看最近一段时间的调用量再决定要不要换。不要只看单次测试因为 QQ 机器人可能长期在线消息量比手动聊天高。8.3 新 Key 在控制台创建文档按需查以后需要新 Key直接在 控制台 API Keys 创建再回到hermes setup替换 api-key 即可。旧的 Key 如果确认不用了可以在控制台处理掉避免继续产生调用。Hermes 这条链路的关键点只有三个安装命令不变、QQ 网关选14不变、hermes setup里模型提供商仍选17但 api-key 填 TaoToken 创建的YOUR_API_KEYBase URL 填https://taotoken.net/api。下次换模型时直接从这里补一把新 Key 就行。 
长河君 · 2026/9/16 21:54:06 · 阅读 1.2k 把 Hermes 的模型 Key 改到 TaoToken，一条龙安装照常走通
如果你照着 Hermes 一条龙安装指南走PowerShell 里执行irm https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex然后hermes setup选 1 快速安装、选 17 DeepSeek、填 api-key最后hermes gateway setup选 14 扫码连 QQ整套流程看起来是通的。真正容易卡住的是模型 Key原来要单独去 DeepSeek 官方申请额度、计费、失效、换模型都多一个后台。把这一步改到 TaoToken 后安装命令不动、QQ 网关不动只在hermes setup里把模型提供商的凭据换成 TaoToken 创建的 KeyBase URL 填https://taotoken.net/api。准备动作就一件事打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 注册并创建 API Key后面所有YOUR_API_KEY都从这里来。1. Hermes 一条龙安装卡在 DeepSeek Key 这一步1.1 原文流程复现PowerShell 装完、setup 选 17、gateway 选 14Hermes 的安装流程之所以叫“一条龙”是因为它把安装、模型设置、消息连接拆成了几个很明确的命令行步骤。第一步是 PowerShell 安装脚本第二步是hermes setup第三步是hermes启动第四步是hermes gateway setup接 QQ。每一步都有交互菜单选数字就行不需要先研究一堆配置文件。原本文档里模型部分会让你在hermes setup里选1快速安装再选17DeepSeek然后把 DeepSeek 官方申请的 api-key 填进去。这个设计对第一次跑通 Agent 的人很友好但用一段时间后就会出现一个现实问题Hermes 本身能一条龙装完模型 Key 却还得回到 DeepSeek 官方后台单独管理。你要是同时还在用其他 AI 编程工具就会变成多个后台、多把 Key、多个账单入口。更麻烦的是QQ 机器人这种场景通常会长期挂着。Key 失效、额度到顶、想从 DeepSeek 换成另一个模型时如果 Key 绑死在 DeepSeek 官方你就得重新申请、重新填、重新启动网关。安装命令没变但维护成本被模型 Key 拉高了。1.2 真正要换的不是安装命令而是 hermes setup 里的模型凭据把 Hermes 的模型 Key 改到 TaoToken核心不是重装 Hermes也不是改掉hermes gateway setup。安装脚本继续用原来的 PowerShell 命令QQ 机器人继续选第 14 项扫码连接真正动的只有hermes setup里的模型供应商凭据。你可以把 Hermes 理解成一套已经装好的消息流水线QQ 消息进来Hermes 负责调度模型负责生成回复网关负责把回复送回去。流水线本身不需要拆只需要把“模型供应商”那一段从 DeepSeek 官方换成 TaoToken 的统一 API 通道。这样 Hermes 仍然以为自己在调用 DeepSeek 提供商但请求实际走https://taotoken.net/apiKey 也从 TaoToken 创建。这样改的好处很直接Hermes 安装照常QQ 扫码照常换模型不用翻回 DeepSeek 官方。后续要调整模型只在 TaoToken 控制台处理要新建 Key也只在一个地方创建。对已经跑通一条龙安装的人来说改动面小回归验证也简单。1.3 切到 TaoToken 后哪些步骤保留、哪些步骤只改一处保留的部分包括PowerShell 一键安装命令、hermes setup的1快速安装入口、17DeepSeek 这个提供商选项、hermes gateway setup的14QQ 机器人设置、扫码连接流程以及最后直接输入hermes启动。这些步骤在原文里已经验证过不需要另起一套。需要改的部分只有两处第一hermes setup里要求填 api-key 时不要再填 DeepSeek 官方 Key改填从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 创建的YOUR_API_KEY第二如果 setup 过程中出现 Base URL、Endpoint 或 API 地址输入项填https://taotoken.net/api末尾不要带/v1。模型提供商仍然选17DeepSeek是因为 Hermes 的菜单里把 DeepSeek 作为一个供应商类型。你只是把它的实际接入地址和 Key 换成 TaoToken 提供的兼容通道。这样既不用改 Hermes 源码也不用在 QQ 网关里动模型参数。2. 到 TaoToken 创建 Hermes 要用的 API Key 与模型入口2.1 打开官网完成注册和 API Key 创建准备材料里最重要的一项就是 API Key。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 完成注册登录然后进入控制台创建 API Key。创建出来的字符串先复制到安全位置本文统一写成YOUR_API_KEY你在hermes setup里填真实 Key 时不要带引号也不要多复制空格。如果你之前已经有一把 Key但不确定还在不在重新建一把专用 Key 更稳。Hermes 这类长期在线的 Agent 建议单独一把 Key方便后面在控制台看调用记录也方便失效时直接替换。创建入口在 TaoToken 的 API Keys 页面Key 只显示一次复制后自己保存好。不要把 Key 写进公开的脚本、截图或聊天记录。本文所有示例都用YOUR_API_KEY占位你实际配置时只在本机终端输入。这样既符合 Hermes 的交互式 setup 习惯也避免 Key 泄露后还要重新建。2.2 在模型广场确认 DeepSeek 模型 ID不要猜Hermes 的hermes setup选17之后可能会让你选择具体模型也可能使用默认模型。具体模型 ID 不要凭记忆填更不要随便加日期后缀。以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 模型广场当时列表为准看到对应的 DeepSeek 模型 ID 再填。如果你在 setup 里没有看到模型 ID 输入项就先把提供商和 Key 配好等 Hermes 启动后用一条测试消息验证。后面想换模型再去 TaoToken 控制台调整或重新创建 Key 绑定。不要为了“看起来更完整”编一个不存在的模型名Hermes 在启动阶段可能不报错真正发消息时才失败排查反而麻烦。模型广场的列表会随可用模型变化所以本文不写死某个 ID。你只需要记住提供商选17Base URL 用https://taotoken.net/api模型 ID 以模型广场为准。2.3 准备 Base URLhttps://taotoken.net/api 末尾不要 /v1Base URL 是这次切换里最容易填错的一项。正确写法是https://taotoken.net/api不要写成https://taotoken.net/api/v1。Hermes 的 DeepSeek 提供商适配层通常会在内部拼接路径你多写一个/v1请求就可能走到不存在的地址上表现为连接失败、404 或模型不回消息。另外Base URL 不要带 UTM 参数。?utm_sourcetaotoken_aicg_blog_end是官网落地页用于注册、创建 Key、看模型广场、看用量的不要把它加到 API 地址里。配置到工具里的地址保持干净https://taotoken.net/api。可以先把这两项写在记事本里Key 用YOUR_API_KEYBase URL 用https://taotoken.net/api。等hermes setup走到对应输入项时直接粘贴减少手打出错。3. PowerShell 一键装 Hermes安装命令与原文保持一致3.1 PowerShell 执行 irm 安装脚本安装阶段不需要因为换 Key 而改命令。打开 PowerShell执行原文里的一键安装脚本irm https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex这条命令会下载并执行 Hermes 的安装脚本。执行过程中如果遇到权限提示按正常 PowerShell 脚本运行方式处理。安装完成后关闭当前终端再重新打开一个让新加入的环境变量和命令路径生效。安装脚本本身不负责你的模型 Key所以这里不用填 DeepSeek 官方 Key。把 Key 留到hermes setup阶段填 TaoToken 的YOUR_API_KEY流程会更清晰。3.2 安装后先确认 hermes 命令能跑安装结束后先确认hermes命令已经可用。可以在 PowerShell 里输入hermes --help如果能看到命令帮助说明安装成功。如果提示找不到命令先检查是不是没有重开终端或者安装脚本把可执行文件放到了当前会话未加载的路径。Windows 下这类问题多数重开一次 PowerShell 就能解决。这一步不要急着启动hermes聊天。原文的顺序是先hermes setup配模型和消息连接再启动。安装完成只代表程序就位模型 Key 和 QQ 网关还没配。3.3 安装阶段不要提前填 DeepSeek 官方 Key有些安装脚本或首次运行引导可能会顺带问你要不要配置模型。如果它问的是模型 Key你先跳过等进入hermes setup再统一填。因为这次的目标是把 Key 来源换成 TaoToken提前填了 DeepSeek 官方 Key后面还要改回来容易把两把 Key 搞混。另外不要把 DeepSeek 官方 Key 和 TaoToken Key 同时塞进同一个配置里。Hermes 的提供商选项虽然还是17DeepSeek但实际应该只使用 TaoToken 创建的那把YOUR_API_KEY。旧 Key 如果已经失效更不要留在环境变量或历史脚本里。4. hermes setup 选 1、选 17把 Base URL 指向 TaoToken4.1 选择 1 快速安装只配模型提供商和消息连接安装确认完成后在 PowerShell 里执行hermes setup进入设置菜单后按原文选择1quick setup快速安装。这个入口只进行模型提供商和消息连接设置适合已经装好 Hermes、只想把模型 Key 换掉的情况。你不需要重新跑完整安装也不需要删掉之前的 QQ 网关配置。如果你之前已经配过 QQ 机器人快速安装里仍然可能让你重新选择消息连接。按原文继续走即可模型部分重点改 Key 和 Base URL消息部分如果已经扫码成功可以保留原设置或重新扫码验证。4.2 选择 17 DeepSeekapi-key 填 YOUR_API_KEY在模型提供商菜单里仍然选择17也就是 DeepSeek。接下来出现 api-key 输入时填从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 创建的YOUR_API_KEY。不要填 DeepSeek 官方申请的那把 Key也不要填其他工具的 Key。输入 Key 时注意终端可能不回显字符这是正常现象。粘贴后按回车继续。如果 Key 前后带空格可能导致鉴权失败粘贴后可以先确认一下剪贴板内容或者手动删掉首尾空格。这一步完成后Hermes 会把这个提供商凭据保存到自己的配置里。你不需要在 QQ 网关里再填一次模型 Key网关只负责消息连接。4.3 Base URL 填 https://taotoken.net/api模型 ID 以模型广场为准如果hermes setup在选完17后询问 Base URL、Endpoint 或 API 地址填https://taotoken.net/api末尾不要加/v1也不要加任何查询参数。如果它询问模型 ID打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 模型广场按当时列表里的 DeepSeek 模型 ID 填写。列表里没有的 ID 不要填日期后缀也不要自己拼。如果 setup 没有让你填 Base URL只让你填了 api-key那也先继续。不同版本的 Hermes 交互项可能略有差异后续启动后通过实际发消息验证。只要 Key 来自 TaoToken模型提供商选17大多数情况下就能走兼容通道。4.4 setup 完成后检查关键项是否落盘hermes setup结束后不要立刻关掉终端。先看一遍输出摘要确认提供商是17、Key 尾号和你刚创建的一致、Base URL 没有多出/v1。如果你在 setup 里看到保存路径或配置文件位置可以记下来但不要手动把 Key 贴到公开位置。有些版本会在 setup 结束时提示运行hermes启动。你可以先不启动回到 PowerShell 检查一下hermes命令是否仍然正常。确认无误后再进入 QQ 网关设置。5. hermes gateway setup 选 14QQ 机器人扫码连接照常走5.1 启动 gateway setup 并选择第 14 项模型 Key 配好后消息连接仍然按原文走。在 PowerShell 里执行hermes gateway setup进入消息连接设置界面后选择第14项QQ 机器人设置。这一步和模型 Key 无关只是把 Hermes 的消息网关接到 QQ。你之前如果已经配过可以检查是否仍然保留如果没有就按菜单继续。选择 QQ 机器人后Hermes 通常会给出一个网址或一个二维码入口。按屏幕提示继续不要在这一步填模型 Key。5.2 扫码连接 QQ模型链路先单独验证进入扫码连接后终端会显示一个网址。把这个网址复制到浏览器打开页面上会出现二维码。用手机 QQ 扫码按提示完成连接。扫码成功后网关侧通常会显示连接状态或机器人信息。扫码成功只代表 QQ 消息通道通了不代表模型一定通。建议先不要在群里发复杂指令先用 Hermes 自己的测试入口或命令行发一条简单消息确认模型能回包。如果模型回包正常再去 QQ 里测试消息收发。5.3 网关设置与模型 Key 不要混在一起改QQ 网关设置里可能还会出现 token、回调地址、机器人 ID 之类的信息这些和模型 API Key 是两回事。不要把YOUR_API_KEY填到 QQ 机器人 token 里也不要把 QQ 的密钥填到模型 api-key 里。分清楚之后后面排障会简单很多。如果你在网关设置里需要填服务器地址或回调地址按 Hermes 和 QQ 机器人平台的提示填。本文只改模型 Key 和 Base URL不改变消息网关的接入方式。6. 启动 hermes 后验证 QQ 消息与模型回包6.1 直接输入 hermes 启动模型和网关都设置好后回到 PowerShell直接输入hermesHermes 会启动并加载之前的配置。启动过程中留意终端有没有报鉴权错误、连接错误或模型不存在。如果没有明显报错说明配置至少被读进去了。如果启动时立刻提示 Key 无效优先检查hermes setup里填的是不是 TaoToken 的YOUR_API_KEY以及 Base URL 有没有多写/v1。如果启动正常就可以进入下一步实际发消息。6.2 在 QQ 里发一条消息观察是否走 TaoToken打开手机 QQ给已经扫码连接的机器人发一条简单消息比如“你好测试一下”。观察 Hermes 终端是否收到请求以及 QQ 里是否收到模型回复。正常情况应该能在几秒到十几秒内看到回复具体取决于模型和当前网络。如果 QQ 里没有回复先看 Hermes 终端。如果终端显示模型请求失败问题在模型 Key 或 Base URL如果终端连消息请求都没收到问题在 QQ 网关连接。先分辨是哪一段再回去改对应设置。6.3 回控制台看这次调用是否记上模型链路通之后回到 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_content 控制台看这次调用的记录和用量。能看到请求记录说明 Hermes 的请求确实走了 TaoToken而不是还在用旧的 DeepSeek 官方 Key。这个动作也能帮你确认 Key 是否绑定正确。如果控制台没有记录但 QQ 机器人却能回复说明你可能还在用旧的官方 Key 或本地缓存配置。回到hermes setup重新检查提供商17下的 Key 和 Base URL再启动一次hermes验证。7. Hermes 换 Key、换模型、连接报错怎么排查7.1 机器人不回消息先分辨 QQ 网关问题还是模型 Key 问题QQ 机器人不回消息时不要一上来就重装 Hermes。先看终端日志如果能看到来自 QQ 的消息进入 Hermes但模型请求报错那就是模型 Key、Base URL 或模型 ID 的问题如果终端完全没有消息进入记录那就是 QQ 网关没有连上重新执行hermes gateway setup选14扫码即可。模型 Key 问题常见表现是鉴权失败、额度不足、模型不存在。这时候回到hermes setup确认 api-key 是YOUR_API_KEY对应的真实 KeyBase URL 是https://taotoken.net/api。如果 Key 刚在控制台重建过旧 Key 会立即失效需要重新填一次。7.2 Base URL 多写 /v1 或 Key 用错的表现https://taotoken.net/api/v1是本次配置里最常见的错误写法。多出的/v1可能让 Hermes 在内部拼接后请求到错误路径表现为连接失败、404 或模型无响应。正确地址只保留https://taotoken.net/api末尾不要斜杠、不要/v1、不要 UTM 参数。另一种常见错误是 Key 用错把 DeepSeek 官方 Key 填进了hermes setup。如果你的 DeepSeek 官方 Key 还有额度机器人可能也能回但控制台看不到 TaoToken 的调用记录如果官方 Key 已失效就直接报鉴权错误。统一换成 TaoToken 创建的那把 Key才能让后续换模型、看用量都集中在一个地方。7.3 后续换模型只在 TaoToken 控制台换不用翻 DeepSeek 官方Hermes 跑通之后换模型不用重新走一遍安装。你可以在 TaoToken 控制台调整模型或重新创建 Key 绑定然后回到hermes setup检查模型 ID 是否要同步更新。具体模型 ID 仍然以模型广场当时列表为准不要凭记忆填。QQ 网关部分不需要因为换模型而重配。模型 Key 和消息连接是两层模型层换 Key、换模型网关层只负责 QQ 消息进出。分开理解之后后续维护会轻松很多。8. 下一步把 Hermes 的调用记录和套餐对一下8.1 用同一把 Key 在模型对话里发测试消息Hermes 和 QQ 机器人验证通过后可以拿同一把 Key 在 TaoToken 模型对话 里发一条测试消息。这样做的好处是把问题范围缩小如果模型对话能回说明 Key、Base URL 和模型 ID 都没问题QQ 不回就查网关如果模型对话也不回就回到 Key 和 Base URL 继续查。测试时不用发业务内容简单一句“测试连接”就够。注意不要在公开截图里暴露完整 Key也不要把聊天记录直接贴到公开地方。8.2 长期跑 Agent 看 Coding Plan如果 Hermes 只是偶尔用按量调用即可。如果是长期挂 QQ 机器人、经常跑 Agent 流程可以打开 Coding Plan 看一下套餐是否够用。这里不写具体价格和额度以页面当时展示为准。选套餐之前先回控制台看最近一段时间的调用量再决定要不要换。不要只看单次测试因为 QQ 机器人可能长期在线消息量比手动聊天高。8.3 新 Key 在控制台创建文档按需查以后需要新 Key直接在 控制台 API Keys 创建再回到hermes setup替换 api-key 即可。旧的 Key 如果确认不用了可以在控制台处理掉避免继续产生调用。Hermes 这条链路的关键点只有三个安装命令不变、QQ 网关选14不变、hermes setup里模型提供商仍选17但 api-key 填 TaoToken 创建的YOUR_API_KEYBase URL 填https://taotoken.net/api。下次换模型时直接从这里补一把新 Key 就行。