Hermes Agent 接入 DeepAI、OpenAI Compatible API、自定义模型端点、部署和排错教程。
Hermes Copilot /model 选择器只查 COPILOT_GITHUB_TOKEN / GH_TOKEN / GITHUB_TOKEN，没 fallback 到 auth.json 里的 OAuth access_token，导致 claude-opus-4.7、gpt-5.5 等模型能直接输入使用，却不出现在菜单里。本文复盘 #16708。
Hermes 把 API key 放在 ~/.hermes/.env 里却仍报 No API key found？本文复盘 #15932：credential_pool._seed_from_env 只看 os.environ，auth 解析也没有 fallback 到 credential pool，导致 OpenAI-compatible provider 的认证链路断掉。
Hermes Gateway 中 agent.max_turns 写成 9000，却在长任务心跳里显示 iteration X/90。本文复盘 #19158：为什么旧 .env 里的 HERMES_MAX_ITERATIONS=90 会通过 dotenv reload 覆盖 config.yaml，以及如何排查配置优先级。
Hermes 的 terminal.docker_env 写在 config.yaml 里却没有进入 Docker 容器，根因是 env_mappings 缺少 docker_env 到 TERMINAL_DOCKER_ENV 的映射。本文复盘 #20537：为什么配置看似存在，运行时却只拿到默认空 dict。
Hermes delegate_task 在工具 schema 中把 claude 和 Claude Code 写成显眼示例，可能诱导 Agent 在未安装 Claude 的环境里尝试 Claude ACP。本文复盘 #22013：为什么工具说明本身也是 prompt surface，以及如何用环境检测和 schema gating 降低误调用。
Hermes Honcho memory tools 在单工具调用时返回 Unknown tool，但多工具并发路径有时正常。本文复盘 #15118：schema 已注入不代表执行层会路由成功，sequential dispatch 漏掉 MemoryManager.has_tool() 才是真正根因。
Hermes copilot-acp 使用 claude-opus-4.7 时出现 SimpleNamespace object is not iterable，不是模型或 API Key 问题，而是 ACP adapter 把对象当成 stream iterable 处理。本文复盘 #16271，解释 acp://copilot 的 response 形态为什么不能靠猜。
Hermes 长任务遇到 incomplete chunked read 时，context compression 可能插入 static fallback marker 并移除中间 turns，却没有生成真实摘要。本文复盘 #18458：为什么压缩摘要失败比普通中断更危险，以及 retry/fallback 应该如何设计。
Hermes issue #8338 暴露了一个配置优先级反转：display.streaming 本应只控制 CLI 终端显示，却错误覆盖了 Gateway 的 streaming.enabled: false，让 Discord、Telegram 等消息平台开始流式编辑。本文解释根因、影响和修复思路。
Hermes Copilot provider 的问题不只是 context window 写错：静态模型目录、原始 GitHub token、OAuth client ID、企业 endpoint 是同一条能力发现链。本文复盘 #7731 与 #15114，解释为什么 Copilot 不能当普通 OpenAI-compatible 接口处理。
Hermes 默认 1M context window 看似更强，但 Claude Pro 账号实际常见限制是 200K，GPT 与本地 Ollama 也可能被错误报大。本文复盘 #3577：为什么上下文窗口不是越大越好，而是越准确越好。