如何在Docker中部署Hermes Agent
如果这是你第一次运行 Hermes Agent,请在主机上创建一个数据目录,并以交互方式启动容器以运行设置向导:
mkdir -p ~/.hermes docker run -it --rm \ -v ~/.hermes:/opt/data \ nousresearch/hermes-agent setup
/opt/data 卷是 Hermes 所有状态的唯一数据源。它映射到主机上的 ~/.hermes/ 目录,并包含:
| Path | 内容 |
|---|---|
| .env | API 密钥和密钥 |
| config.yaml | 所有Hermes的配置 |
| SOUL.md | Agent个性/身份 |
| sessions/ | 对话历史 |
| memories/ | 持久内存存储 |
| skills/ | 已安装技能 |
| cron/ | 计划作业定义 |
| hooks/ | 事件钩子 |
| logs/ | 运行时日志 |
| skins/ | 自定义 CLI skins |
切勿同时对同一数据目录运行两个 Hermes 网关容器——会话文件和内存存储并非设计用于并发写入访问。与网关并行运行仪表盘容器是安全的,因为仪表盘仅读取数据。
这将引导你进入设置向导,该向导会提示你输入 API 密钥并将其写入 ~/.hermes/.env 文件。你只需执行此操作一次。强烈建议你此时为网关设置一个聊天系统。







配置完成后,将容器作为持久网关在后台运行。
创建 hermes目录,并在里面创建 docker-compose.yaml:
mkdir -p ~/hermes cd ~/hermes vim docker-compose.yaml
写入以下内容:
services:
hermes:
image: nousresearch/hermes-agent:latest
container_name: hermes
restart: unless-stopped
command: gateway run
ports:
- "8642:8642"
volumes:
- ~/.hermes:/opt/data
networks:
- hermes-net
deploy:
resources:
limits:
memory: 4G
cpus: "2.0"
dashboard:
image: nousresearch/hermes-agent:latest
container_name: hermes-dashboard
restart: unless-stopped
command: dashboard --host 0.0.0.0
ports:
- "9119:9119"
volumes:
- ~/.hermes:/opt/data
environment:
- GATEWAY_HEALTH_URL=http://hermes:8642
networks:
- hermes-net
depends_on:
- hermes
deploy:
resources:
limits:
memory: 512M
cpus: "0.5"
networks:
hermes-net:
driver: bridge- 如果不需要dashboard (比如只是Channel访问),可以把上面dashboard那部分给删了。
- 端口 8642 暴露了网关的OpenAI 兼容 API 服务器和健康检查端点。如果你仅使用聊天平台(例如 Telegram、Discord 等),则此端口为可选;但如果你希望仪表盘或外部工具能够访问网关,则此端口为必需。在面向互联网的计算机上打开任何端口都存在安全风险。除非你了解这些风险,否则不应这样做。
| Environment variable | Description | Default |
|---|---|---|
GATEWAY_HEALTH_URL | 网关 API 服务器的基本 URL,例如 http://gateway:8642 | (未设置 — 仅进行本地 PID 检查) |
GATEWAY_HEALTH_TIMEOUT | 健康探测超时时间(秒) | 3 |
- 如果没有
GATEWAY_HEALTH_URL,仪表板将回退到本地进程检测——这仅在网关在同一容器或同一主机上运行时才有效
然后构建镜像:
docker compose down docker compose up -d
可以监控启动日志:
docker compose logs -f


要针对正在运行的数据目录打开交互式聊天会话:
docker run -it --rm \ -v ~/.hermes:/opt/data \ nousresearch/hermes-agent
到此这篇关于在Docker中部署Hermes Agent的文章就介绍到这了,更多相关Docker部署Hermes Agent内容请搜索脚本之家以前的文章或继续浏览下面的相关文章,希望大家以后多多支持脚本之家!
相关文章

Hermes Agent Windows Docker 部署完全指南如何从零开始搭建你的自我进
HermesAgent是NousResearch开发的开源自我进化型AI智能体,支持多模型、多平台网关和持久化记忆,文章详细介绍了环境准备、Docker镜像拉取、初始化配置、接入LLM模型、启动运2026-05-13
Docker 部署 Hermes Agent 完整实战指南(Windows / Linux 通用)
本文将详细介绍如何通过 Docker 快速部署 Hermes Agent,部署前先为大家提供 Docker 一键安装与镜像加速方案,适配绝大多数场景,新手也能轻松上手,感兴趣的朋友跟随小编一2026-04-24
基于Docker部署Hermes Agent并接入飞书机器人的完整指南
本文将围绕开源项目 Hermes Agent,手把手带你完成从部署到接入飞书机器人的完整流程,相比零散教程,本文不仅提供详细步骤,还会补充关键原理说明与实践建议,帮助你真正掌2026-04-17





最新评论