Hermes Agent 用 Docker 部署时,重点不是“容器能启动”,而是配置目录、工作目录、文件挂载和环境变量要持久化。社区里很多 Docker 问题都卡在:容器里看不到宿主机文件,或者重启后 Telegram/session 配置丢了。
新手部署要点
- 给
~/.hermes或等价配置目录做 volume 持久化。 - 把要让 Hermes 读写的项目目录明确挂进容器。
- API key、Telegram token、allowed users 放进环境变量或 env 文件。
- 如果跑 gateway,确认容器重启策略和日志可查看。
什么时候不建议 Docker
如果你刚开始学习 Hermes Agent,只是想在本机 CLI 里试用,直接安装更简单。Docker 更适合 VPS、长驻 gateway、团队 bot 或需要隔离权限的场景。
一句话:Docker 部署 Hermes Agent,核心是 volume 和 env,不是只跑起镜像。
官方开源地址:https://github.com/NousResearch/hermes-agent;官方文档入口:https://hermes-agent.nousresearch.com/。