在 WSL2 里装完 Hermes Agent跑 hermes doctor 大概率会看到 API key not configured。原文很贴心地标注了这属于正常现象因为 Hermes 装完并不默认绑定模型服务商。今天这篇就把这一步走完去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建 API Key再改 ~/.hermes/.env 里的 CUSTOM_BASE_URL 指向 TaoToken让诊断从 not configured 变成确认通过。我见过不少人看到这行红字就直接放弃或者在 GitHub Issues 里搜了半天最后发现不是装坏了只是配置没走完。这篇就把原文里「配置 Hermes Agent」那一节展开把自定义端点这部分讲透拿 Key 去哪里拿、Base URL 填什么、填完怎么验证、验证不过怎么查。1. 先别急着装 Web UIhermes doctor 的 API key not configured 是什么意思WSL2 里跑完 Hermes 官方安装脚本很多人会直接去装 hermes-web-ui结果 Web UI 打开后一直报连接错误。回头看终端hermes doctor 明明白白写着 API key not configured。这个提示很容易被误判成「装坏了」但其实 Hermes 的 doctor 只是把所有检查项列出来模型提供商没配置时就用红字标出来。1.1 这个报错在原文里本来就是预期状态原文在「配置 Hermes Agent」一节前专门标注看到 API key not configured 或 OpenRouter API (not configured) 都属于正常现象下一步就是通过 hermes setup 或直接编辑 ~/.hermes/.env 来完成配置。所以正确的处理顺序是装完 Hermes → 跑 hermes doctor → 看到 not configured 当作提示 → 配置 Key 和端点 → 再跑一次 hermes doctor 确认通过。跳过第 4 步直接装 Web UI就会出现网关连不上、对话无响应等连锁反应因为底层根本没有可用的模型通道。Hermes 的检查机制也不复杂它读取 .env 里的自定义端点字段如果 CUSTOM_API_KEY 为空或者 CUSTOM_BASE_URL 没有指向有效地址就在 doctor 的结果里标记为 not configured。注意这里的关键词是「自定义端点」也就是说你不一定非要选 OpenRouter 或官方 OpenAI 那一项直接把 TaoToken 的 Base URL 填进去走自定义端点这条路完全可行。1.2 官方渠道卡人的地方TaoToken 这样处理如果你已经配过 Anthropic 或 OpenAI 的官方 Key可能会发现几个麻烦官方账号下不同模型要分别充值单 Key 额度很快见底换模型还得回到控制台重新创建 Key有时候只是想让 Hermes 尝鲜不想每个平台都注册一遍。TaoToken 把这一类问题收敛成「一个 Key、一个 Base URL」的接入方式打开落地页完成注册后可以直接创建 API Key不需要在多个服务商的控制台之间来回切换。这里先不展开配置细节下一节讲具体的拿 Key 流程。2. 拿 Key 的实操TaoToken 控制台三件事2.1 注册并创建 API KeyTaoToken 的落地页只承担一件事账号、API Key 和模型广场。注册流程和普通开发者平台一样邮箱验证后进入控制台。在控制台里找到 API Key 管理点创建得到一串以 sk- 开头的密钥复制时注意别带上换行或空格。这一步对应原文里「输入 API Key若使用付费服务」的位置只不过原文留给用户的占位符是 your_key本文统一用 YOUR_API_KEY 表示你在 .env 里要替换成实际复制到的值。2.2 在模型广场记下模型 IDTaoToken 的模型广场会列出当前支持的模型 ID以及每个模型的上下文长度、定价信息。Hermes 配置自定义端点时需要一个明确的模型 ID所以这里建议直接打开控制台里的模型广场选一个你需要的模型把 ID 记下来。不同时期模型列表会有变化以广场当前展示的为准不要照搬别人文章里分享的旧 ID 或你记忆中的命名。记下 ID 之后后面配置 .env 和 hermes model 时都用它省得再回头翻。2.3 落地页和 API 地址是两个东西这一步容易搞混注册、创建 Key、看用量、挑模型这些发生在落地页但是填进 Hermes 配置文件里的 Base URL 是 https://taotoken.net/api末尾不要加 /v1。落地页打开是给人操作的页面API 地址是给程序访问的端点两者用途完全不同。如果你把落地页地址填进 Base URL或者给 API 地址拼接 UTM 参数Hermes 发起请求时会得到非预期响应排查起来比配置 Key 麻烦得多。3. 改 ~/.hermes/.env把 CUSTOM_BASE_URL 指到 TaoToken原文给了两种配置路径交互式 hermes setup 和直接编辑 .env。排障场景下直接编辑 .env 更快因为你能精确控制每个字段不会被 hermes setup 的交互式问答带偏。3.1 先确认 .env 文件在哪WSL2 的 Ubuntu 终端里Hermes 的用户目录固定在 ~/.hermes。执行以下命令查看 .env 是否存在ls -la ~/.hermes/.env如果文件不存在说明安装脚本还没有生成初始配置你可以手动创建同名文件。如果文件存在直接打开编辑。改 .env 时以追加或替换的方式写入关键字段不要动其他已有的配置行因为 hermes setup 生成的文件里还会包含其他辅助字段删掉可能导致 doctor 检查时又多出别的警告。3.2 核心配置CUSTOM_API_KEY 与 CUSTOM_BASE_URL把以下内容填进 ~/.hermes/.envCUSTOM_API_KEYYOUR_API_KEY CUSTOM_BASE_URLhttps://taotoken.net/api第一行是 API KeyYOUR_API_KEY 需要替换为上面 2.1 节里复制到的真实 Key。第二行是 Base URL注意它没有 /v1 后缀。Hermes 在请求模型时会自动拼接完整的聊天地址不需要你手动补全。TaoToken 作为兼容通道这一行地址直接对接到它背后的模型路由。这里还要提醒一个容易犯的错有人习惯性认为 OpenAI 格式的接口地址都长成 https://api.example.com/v1于是手动把 Base URL 改成 https://taotoken.net/api/v1。它的 API 地址设计上就是 https://taotoken.net/api多出来的 /v1 反而会拼出一个不存在的路径。配置时以这一行地址为准。3.3 用 hermes model 选定模型 ID.env 填完并不代表 Hermes 已经知道要用哪个模型。回到终端执行hermes model在模型列表里选择自定义模型对应的 ID。这个 ID 必须是你在 2.2 节从模型广场记下的那个。如果你当时没记现在重新打开控制台里的模型广场看一眼再回来选。注意这里选模型和 OpenAI 官方控制台里选模型部署是两回事Hermes 的模型选择器会读取 .env 里的自定义端点信息然后把模型 ID 作为请求参数传给后端。3.4 为什么不推荐配置完再跑 hermes setup我试过在配置完成后又跑了一次 hermes setup结果它把 .env 重新生成自定义端点被清掉hermes doctor 回到 not configured 状态。所以流程最好是先跑一次 hermes setup 确定基础结构或者直接手写 .env然后后续不要重复执行 setup。如果你想换模型用 hermes model想换 Key编辑 .env 里的 CUSTOM_API_KEY 那一行。需要调整端点时才回去改 CUSTOM_BASE_URL。4. 验证hermes doctor 从 not configured 变成确认通过4.1 期望看到的输出变化保存 .env 后执行source ~/.bashrc hermes doctor配置前模型提供商那一行显示的是 API key not configured配置后这一行应该变成确认通过的状态原文里对应的是 API key or custom endpoint configured 打勾。只要看到这个变化就说明 CUSTOM_BASE_URL 已经生效Hermes 和 TaoToken 的通道建立成功。4.2 从报错到通过的判定逻辑Hermes 检查自定义端点时会同时看两个条件CUSTOM_API_KEY 是否非空CUSTOM_BASE_URL 是否能连。TaoToken 的 Base URL 不需要带 /v1因为它的路由层会自动处理后续路径。你只管把 https://taotoken.net/api 整段填进去Hermes 发起请求时自然会拼接模型路径。有些版本还会有缓存改完 .env 后在同一个终端里直接再跑 doctor结果可能还是旧的关掉终端重开一个再验证更可靠。4.3 Web UI 的联动验证如果后面要装 hermes-web-ui网关服务同样读取 ~/.hermes/.env。安装方式npm install -g hermes-web-ui hermes-web-ui start如果页面提示连接错误另开一个终端执行 hermes gateway run 保持前台运行再刷新 http://localhost:8648。此时浏览器里能不能正常对话仍然取决于 .env 里的 Key 和 Base URL也就是说hermes doctor 通过是 Web UI 可用的前置条件。5. 排障改了 .env 之后还是 not configured5.1 检查是否填错了生效字段Hermes 的 doctor 输出里会列出多个检查项API key not configured 可能来自 OpenRouter API 或 OpenAI API 这两个占位字段而不是你填的 CUSTOM_API_KEY。如果你只改了自定义端点但 OpenRouter 那一栏还空着doctor 仍然会标红。这时不用慌确认 CUSTOM_API_KEY 和 CUSTOM_BASE_URL 是对应的并且 CUSTOM 那一栏显示通过即可。如果你想让输出更干净也可以打开 .env 把其他空的 Key 字段注释掉。5.2 检查 Base URL 是否带了 /v1在 3.2 里已经强调过这里再从排障角度看一眼如果你填的是 https://taotoken.net/api/v1Hermes 会在请求时拼成 /api/v1/chat/completions而 TaoToken 的 API 路由设计上接受的是 https://taotoken.net/api。多出的 /v1 会让请求落在一个不存在的路径上表现为 doctor 里自定义端点检查失败或超时。把 Base URL 重新改成 https://taotoken.net/api 再试一次。5.3 检查网络能否通到 API 端点用一条命令验证 WSL2 到 TaoToken 的网络curl -sS -o /dev/null -w %{http_code}\n https://taotoken.net/api正常情况下会返回 200、401 或 404 这类 HTTP 状态码区别只在于后端对未带 Key 的请求如何处理。如果返回 000说明 DNS 解析或网络出问题需要先解决 WSL2 的 hosts 配置和网络连通性否则后面所有配置都白搭。这一步做完再把注意力放回 .env不要一上来就怀疑 Key 填错。5.4 模型 ID 不在列表中怎么办如果 hermes model 列表里没有你要用的 ID先别急着去 .env 里手写模型名。打开控制台里的模型广场重新确认这个模型是否还在当前列表里TaoToken 的模型列表会动态调整某些旧 ID 可能已经下架你记忆中的名称也许早就不适用。另一点是格式模型 ID 的大小写、连字符、点号都要与广场展示完全一致不要手动缩写。如果确实找不到合适的模型换一个同类型可用模型再回到 hermes model 里重新选择即可。6. 收尾用一次真实对话确认 Token 消耗6.1 进入 Hermes 交互界面配置通过只是第一步。跑一下hermes进入命令行交互问一个必须调用模型才能回答的问题比如让 Hermes 解释一下 CUSTOM_BASE_URL 和 Base URL 的关系。如果 Hermes 正常返回内容说明这次调用的 Token 已经走到 TaoToken 上。这里要注意你在终端里看到的是模型返回的结果真正的消耗记录要到落地页去核对。6.2 回到落地页核对用量打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end进入控制台的用量页面刷新刚才那轮对话的消耗会出现在记录里。看到记录那一刻hermes doctor 报 API key not configured 这件事才算真正收尾。以后要换模型只需把模型广场的新模型 ID 填进 Hermes 的模型选择里.env 里的 Key 和 Base URL 不用再动要换 Key也只改 CUSTOM_API_KEY 一行。等你把整个接入链路跑顺了再回头读原文那句「属于正常现象」会发现它不只是安慰而是在告诉你配置路径走完警告自然会消失。