企业官网建设流程全解析

如果你照着 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 创建的 Key，Base URL 填https://taotoken.net/api。准备动作就一件事：打开 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content= 注册并创建 API Key，后面所有YOUR_API_KEY都从这里来。

1. Hermes 一条龙安装卡在 DeepSeek Key 这一步

1.1 原文流程复现：PowerShell 装完、setup 选 17、gateway 选 14

Hermes 的安装流程之所以叫“一条龙”，是因为它把安装、模型设置、消息连接拆成了几个很明确的命令行步骤。第一步是 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/api，Key 也从 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_source=taotoken_aicg_blog_end&utm_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_source=taotoken_aicg_blog_end&utm_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_source=taotoken_aicg_blog_end&utm_content= 模型广场当时列表为准，看到对应的 DeepSeek 模型 ID 再填。

如果你在 setup 里没有看到模型 ID 输入项，就先把提供商和 Key 配好，等 Hermes 启动后用一条测试消息验证。后面想换模型，再去 TaoToken 控制台调整或重新创建 Key 绑定。不要为了“看起来更完整”编一个不存在的模型名，Hermes 在启动阶段可能不报错，真正发消息时才失败，排查反而麻烦。

模型广场的列表会随可用模型变化，所以本文不写死某个 ID。你只需要记住：提供商选17，Base URL 用https://taotoken.net/api，模型 ID 以模型广场为准。

2.3 准备 Base URL：https://taotoken.net/api 末尾不要 /v1

Base URL 是这次切换里最容易填错的一项。正确写法是https://taotoken.net/api，不要写成https://taotoken.net/api/v1。Hermes 的 DeepSeek 提供商适配层通常会在内部拼接路径，你多写一个/v1，请求就可能走到不存在的地址上，表现为连接失败、404 或模型不回消息。

另外，Base URL 不要带 UTM 参数。?utm_source=taotoken_aicg_blog_end是官网落地页用于注册、创建 Key、看模型广场、看用量的，不要把它加到 API 地址里。配置到工具里的地址保持干净：https://taotoken.net/api。

可以先把这两项写在记事本里：Key 用YOUR_API_KEY，Base 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 指向 TaoToken

4.1 选择 1 快速安装，只配模型提供商和消息连接

安装确认完成后，在 PowerShell 里执行：

hermes setup

进入设置菜单后，按原文选择1：quick setup，快速安装。这个入口只进行模型提供商和消息连接设置，适合已经装好 Hermes、只想把模型 Key 换掉的情况。你不需要重新跑完整安装，也不需要删掉之前的 QQ 网关配置。

如果你之前已经配过 QQ 机器人，快速安装里仍然可能让你重新选择消息连接。按原文继续走即可，模型部分重点改 Key 和 Base URL，消息部分如果已经扫码成功，可以保留原设置或重新扫码验证。

4.2 选择 17 DeepSeek，api-key 填 YOUR_API_KEY

在模型提供商菜单里仍然选择17，也就是 DeepSeek。接下来出现 api-key 输入时，填从 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_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_source=taotoken_aicg_blog_end&utm_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 选 14：QQ 机器人扫码连接照常走

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，直接输入：

hermes

Hermes 会启动并加载之前的配置。启动过程中留意终端有没有报鉴权错误、连接错误或模型不存在。如果没有明显报错，说明配置至少被读进去了。

如果启动时立刻提示 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_source=taotoken_aicg_blog_end&utm_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对应的真实 Key，Base 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_KEY，Base URL 填https://taotoken.net/api。下次换模型时，直接从这里补一把新 Key 就行。