Telegram 里 /model 不生效？Hermes Gateway 远程切换模型失效排查Telegram 里 /model 不生效？Hermes Gateway 远程切换模型失效排查
Hermes Telegram Gateway 里 /model 看得到却不生效？本文解释 /model 被移除、CLI 切换不影响 Telegram session、Agent 幻觉式声称已切换，以及如何用日志和 provider 账单验证真实模型。
月度归档： 2026 年 5 月
Hermes 更新卡在 python-olm？macOS 上 CMake 4 与 Apple Clang 编译失败排查Hermes 更新卡在 python-olm？macOS 上 CMake 4 与 Apple Clang 编译失败排查
Hermes update 在 macOS 上卡在 python-olm==3.2.16？本文解释 CMake 4 policy、Apple Clang 21、vendored libolm、matrix-nio[e2e] 与可选依赖拆分的排查和绕过方法。
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 辅助任务报 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 子包。
Hermes Agent 报 UnicodeEncodeError？ASCII locale、API Key 和 reasoning_content 排错指南Hermes Agent 报 UnicodeEncodeError？ASCII locale、API Key 和 reasoning_content 排错指南
Hermes Agent 报 UnicodeEncodeError: ascii codec can't encode character？本文从 LANG=C、API Key 混入 Unicode 近似字符、OpenAI SDK Authorization header、tool schema、api_messages 和 reasoning_content 角度给出完整排错清单。