日期: 2026年5月14日

Telegram 一直提示 Interrupting current task?Hermes Gateway busy lock 卡死排查Telegram 一直提示 Interrupting current task?Hermes Gateway busy lock 卡死排查

Hermes Telegram 反复提示 Interrupting current task,但 /stop 又说 No active task to stop?这通常是 Gateway adapter._active_sessions 与 runner._running_agents 状态分裂导致的 stale busy lock。本文解释症状、/restart 临时恢复和 #14513 修复方向。

Telegram 里 /model 不生效?Hermes Gateway 远程切换模型失效排查Telegram 里 /model 不生效?Hermes Gateway 远程切换模型失效排查

Hermes Telegram Gateway 里 /model 看得到却不生效?本文解释 /model 被移除、CLI 切换不影响 Telegram session、Agent 幻觉式声称已切换,以及如何用日志和 provider 账单验证真实模型。

OpenRouter / NVIDIA 模型一接入就 400?Hermes Agent reasoning 参数误发排错指南OpenRouter / NVIDIA 模型一接入就 400?Hermes Agent reasoning 参数误发排错指南

Hermes 接入 OpenRouter、MiniMax 或 NVIDIA 模型时一发请求就 BadRequestError 400?问题可能不是 API Key,而是 reasoning extra_body 被发给了不支持 reasoning 扩展的模型。本文教你读 request_dump 并分层排查。

Hermes 输入 @ 就报 NameError: self is not defined?fuzzy file completions 排错指南Hermes 输入 @ 就报 NameError: self is not defined?fuzzy file completions 排错指南

Hermes CLI 输入 @ 触发文件补全时抛出 NameError: self is not defined?本文解释 _context_completions、@staticmethod、fuzzy file completions 的根因、临时绕过和升级修复路径。

Hermes Docker 里读不到 GITHUB_TOKEN?~/.hermes/.env 环境变量转发排错指南Hermes Docker 里读不到 GITHUB_TOKEN?~/.hermes/.env 环境变量转发排错指南

Hermes config set GITHUB_TOKEN 后,Docker terminal 里仍读不到环境变量?这可能是 Docker exec 只转发当前 shell env,却没加载 ~/.hermes/.env。本文解释 GITHUB_TOKEN、docker_forward_env、~/.gitconfig 挂载和容器内 printenv 排查方法。

Hermes Agent 启动报 Invalid key: c-S-c?prompt_toolkit 快捷键崩溃排错指南Hermes Agent 启动报 Invalid key: c-S-c?prompt_toolkit 快捷键崩溃排错指南

Hermes Agent 运行 hermes 或 hermes chat 刚显示 banner 就崩溃,报 Error: Invalid key: c-S-c?这通常不是 API Key 或模型问题,而是 prompt_toolkit 不支持 Ctrl+Shift+C 的 c-S-c keybinding。本文解释原因、判断方法、临时 workaround 和升级建议。

Hermes Agent provider:auto 选错辅助模型?title_generation 走 fallback provider 报 404 排错指南Hermes Agent provider:auto 选错辅助模型?title_generation 走 fallback provider 报 404 排错指南

Hermes Agent 主模型正常,但 title_generation 报 HTTP 404?可能是 auxiliary provider:auto 没跟随主 provider,而是选到 fallback provider(如 minimax),导致 SDK、api_mode 或 endpoint path 不匹配。本文解释 provider:auto、fallback_model、WeChat 错误泄露和显式配置 workaround。

Hermes Agent auxiliary 报 HTTP 404?anthropic_messages、base_url 与 /v1 路径改写排错指南Hermes Agent auxiliary 报 HTTP 404?anthropic_messages、base_url 与 /v1 路径改写排错指南

Hermes Agent auxiliary title_generation 报 HTTP 404、Cannot POST /v1/chat/completions?如果你配置的是 api_mode: anthropic_messages 和 /anthropic/ endpoint,可能是 custom auxiliary client 把 URL 改写成 OpenAI /v1 路径。本文解释根因、修复 commit 4e296dcdd 和排查方法。

Hermes Agent 辅助任务报 401?provider:auto、base_url 与空 api_key 排错指南Hermes Agent 辅助任务报 401?provider:auto、base_url 与空 api_key 排错指南

Hermes Agent 主模型能用,但 auxiliary title_generation 报 401 Missing Authentication header?可能是 provider:auto/openrouter 搭配 base_url 和空 api_key 被误判成 custom provider,跳过 OPENROUTER_API_KEY 环境变量读取。本文给出配置排查、workaround 和修复方向。

Hermes Agent 技能不触发?skill description 60 字截断与路由排错指南Hermes Agent 技能不触发?skill description 60 字截断与路由排错指南

Hermes Agent 自定义 Skill 明明存在却不触发?可能是系统提示词里的 available_skills 只展示 description 前 60 字,关键触发词被截断。本文解释 .skills_prompt_snapshot.json、skills_list 1024 字差异和 60 字内 description 写法。

Hermes Agent 报 No module named agent.transports?pip / Nix 源码安装缺包排错指南Hermes Agent 报 No module named agent.transports?pip / Nix 源码安装缺包排错指南

Hermes Agent 源码安装后报 ModuleNotFoundError: No module named agent.transports?这通常不是 Anthropic API Key 或模型名问题,而是 setuptools include 缺少 agent.*,导致 pip / Nix 安装产物漏掉 agent/transports 子包。