Hermes 常见问题

本页适用于 Hermes Agent。

先按报错判断

报错	优先处理
model_not_found / 当前服务暂不支持该模型	检查模型名称和分组
403 Forbidden	检查令牌的「模型可用列表」
找不到 hermes 命令	PATH 未刷新，重开终端

找不到 hermes 命令

hermes --version

关掉终端重新打开再试；仍不行就按系统重新加载 shell 配置：

source ~/.zshrc   # macOS / zsh
source ~/.bashrc  # Linux

再不行就重新执行安装脚本：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

hermes doctor 报依赖缺失

hermes doctor

按提示补齐依赖。如果用 pip 装的，可以跑一次：

hermes postinstall

配置没生效

Hermes 的模型配置由 hermes model 写入。重新运行：

hermes model

在 Select provider 中选择 **`custom (direct API)``，然后填 Base URL、API Key、模型名。

提示

菜单编号会随版本变化，请按选项名称选择。

返回 403：该令牌无权访问模型

创建令牌时填写的「模型可用列表」不包含当前模型。建议在 令牌管理 里留空。

404 / 找不到 chat/completions

Base URL 协议选错了：

协议	Base URL
OpenAI 兼容	https://187api.com/v1
Anthropic	https://187api.com（不带 /v1）

Hermes 默认走 OpenAI 兼容，选错协议 404 很常见。

工具调用失败

Hermes 会调用终端和本地工具。检查：

1. 客户端是否显示了工具调用确认
2. 当前工作目录是否允许写入
3. 流式响应里是否包含完整的 tool_calls —— 若缺失，保留请求记录联系客服

---

相关：Hermes Agent 配置 · 常见问题总览