转载请注明出处：小锋学长生活大爆炸[xfxuezhagn.cn]

如果本文帮助到了你，欢迎[点赞、收藏、关注]哦~

如果这是你第一次运行 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