Mattermost 里点不了按钮就只能超时？Hermes clarify 多选题文字兜底为什么没接住回复Mattermost 里点不了按钮就只能超时？Hermes clarify 多选题文字兜底为什么没接住回复
Hermes clarify 多选题在 Telegram 按钮正常，但 Mattermost 只能显示编号文本列表时，用户回复 2 却仍然 10 分钟超时？本文复盘 #25567：awaiting_text 与 choices 绑定导致文本兜底永远接不到回复。
分类： Hermes Agent 教程
Hermes Agent 接入 DeepAI、OpenAI Compatible API、自定义模型端点、部署和排错教程。
Discord 免 @ 频道变成 thread 工厂：Hermes free-response 为什么每条消息都新开线程Discord 免 @ 频道变成 thread 工厂：Hermes free-response 为什么每条消息都新开线程
Hermes Discord free-response channel 本应免 @ 并 inline reply，但旧代码只跳过 mention 检查，没有把 is_free_channel 传给 auto-thread gate，导致每条消息都新开 thread。本文复盘 #25310。
Feishu 配好了，Hermes Gateway 却一启动就崩：RedactingFormatter 没导入造成的假象Feishu 配好了，Hermes Gateway 却一启动就崩：RedactingFormatter 没导入造成的假象
Feishu/Lark 配置看起来没问题，但 Hermes Gateway 启动后反复崩溃？本文复盘 #8173：gateway/run.py 使用 RedactingFormatter 却没有导入，导致启动阶段 NameError，消息根本还没进入平台 adapter。
hermes doctor 说 DashScope key 无效，但接口明明 200：一次区域端点误判复盘hermes doctor 说 DashScope key 无效，但接口明明 200：一次区域端点误判复盘
hermes doctor 报 Alibaba/DashScope invalid API key，但同一个 DASHSCOPE_API_KEY 访问中国区 DashScope endpoint 返回 HTTP 200？本文复盘 #18904：健康检查默认 endpoint 与实际区域不一致时，为什么会把 region mismatch 误判成密钥无效。
Hermes 命令一跑就卡死：install.sh 重跑后为什么把 CLI 入口改成了自我调用Hermes 命令一跑就卡死：install.sh 重跑后为什么把 CLI 入口改成了自我调用
重跑 Hermes install.sh 后，hermes doctor 没报错也没输出，只是一直卡住？本文复盘 #21454：旧版 ~/.local/bin/hermes symlink 被新版 cat > wrapper 穿透覆盖，导致 venv/bin/hermes 变成自我 exec 的无限循环。
Docker 重新 build 突然 invalid file request：Hermes 的 runtime data 为什么混进了构建上下文Docker 重新 build 突然 invalid file request：Hermes 的 runtime data 为什么混进了构建上下文
Hermes Docker compose 第一次 build 成功，容器运行后下一次却报 invalid file request？根因可能是 bind-mounted ./data 作为 /opt/data 写入 runtime symlink，而 .dockerignore 没排除 data/。本文复盘 #13925。
自动安装最怕半路要密码：Hermes 在 Playwright 步骤卡住 sudo 的半成品安装坑自动安装最怕半路要密码：Hermes 在 Playwright 步骤卡住 sudo 的半成品安装坑
Hermes 安装器在非 sudo 服务用户下运行 Playwright Chromium --with-deps 时会卡在 sudo 密码提示，且发生在 setup_path 之前，导致 hermes 命令和 hermes doctor 都没创建。本文复盘 #25816：为什么可选浏览器步骤不应阻断核心安装。
安全过滤器把注释也当命令了：Hermes 终端误杀 setsid / nohup 的坑安全过滤器把注释也当命令了：Hermes 终端误杀 setsid / nohup 的坑
Hermes terminal safety filter 曾用简单正则扫描 nohup/disown/setsid，导致 git commit message、PR body、Python -c 代码和 echo 文本里的关键词也被当作真实后台命令拦截。本文复盘 #20064：为什么安全过滤不能只靠关键词扫描。
只有思考没有正文，Hermes 流式输出也会崩：Gemini reasoning-only delta 的 .content 空洞只有思考没有正文，Hermes 流式输出也会崩：Gemini reasoning-only delta 的 .content 空洞
Gemini Code Assist streaming 中 reasoning-only delta 先于正文到达，Hermes 旧版 _make_stream_chunk 没有补 content=None，导致 downstream 访问 delta.content 时报 AttributeError。本文复盘 #24974：为什么流式 chunk schema 必须稳定。
模型需要 max_completion_tokens，Hermes 却按网址猜参数：自定义 OpenAI 兼容端点的 400 坑模型需要 max_completion_tokens，Hermes 却按网址猜参数：自定义 OpenAI 兼容端点的 400 坑
Hermes 在自定义 OpenAI-compatible endpoint 上只按 URL host 判断 max_tokens / max_completion_tokens，导致 gpt-4o、gpt-4.1、gpt-5、o-series 模型返回 unsupported_parameter 400。本文复盘 #13901，并说明 DeepAI API 中转站场景该如何排查。