Hermes Agent 在 Docker 里浏览器工具失败，重点看 Node.js 版本、浏览器依赖、容器权限和显示环境。聊天能用不代表浏览器自动化可用，因为浏览器链路需要额外系统依赖。
先确认基础依赖
官方安装文档提到 Hermes 依赖 Node.js v22、ripgrep、ffmpeg 等组件。浏览器自动化和 WhatsApp 桥接尤其依赖 Node 生态。如果你的镜像里还是旧 Node，可能会出现深层依赖报错，而不是一句清楚的“版本不对”。
容器里常见原因
- 镜像缺少浏览器运行库，导致 Playwright/Chromium 无法启动。
- 容器安全策略限制 sandbox，需要按镜像说明配置权限。
- 没有正确挂载工作目录，浏览器下载文件或保存状态失败。
- 网络代理只配置在宿主机，容器内部访问网页失败。
推荐排查法
先进入容器执行最小浏览器测试，而不是直接让 Hermes 跑复杂网页任务。确认 Node、浏览器、网络都正常后，再回到 Hermes 任务。日志里如果看到 browser、chromium、sandbox、shared library 相关错误，基本就是容器环境问题。
生产环境建议把浏览器能力和普通聊天能力分开验收：聊天通、工具通、浏览器通、文件挂载通，每一层单独测过，后面的 Agent 任务才不会半路卡死。
