

## 引言：Hermes Agent —— 开源 AI 智能体的新纪元

在 2026 年的 AI 技术浪潮中，智能体（Agent）技术正以前所未有的速度演进。继 OpenClaw（小龙虾）掀起第一波热潮后，由 Nous Research 实验室推出的 **Hermes Agent** 迅速成为开源社区的新宠。截至 2026 年 4 月，其 GitHub 仓库已收获超过 **10 万颗星标**，被开发者誉为“真正会自我进化的数字员工”。

与传统聊天机器人或任务执行器不同，Hermes Agent 的核心价值在于其 **完整的自学习闭环**：
- **持久化记忆**：通过 FTS5 全文检索技术，跨会话记住用户偏好、项目上下文和环境信息。
- **技能沉淀**：能从复杂任务中自动提炼可复用的程序化技能（Skills），并在后续使用中不断优化。
- **多平台触达**：原生支持 CLI、Telegram、Discord、Slack、WhatsApp、飞书、钉钉等 **15+ 消息平台**。
- **灵活部署**：可在 $5 VPS、本地 Docker 容器、GPU 集群甚至无服务器（Serverless）环境中运行。

Docker 作为现代应用部署的事实标准，为 Hermes Agent 提供了理想的运行环境。它不仅实现了 **环境隔离** 和 **依赖解耦**，还通过 **数据卷映射** 确保持久化记忆和技能文件的安全存储，同时简化了 **版本升级** 与 **跨机器迁移** 的流程。

本指南将为您提供一份 **全面、深入、面向生产环境** 的 Hermes Agent Docker 部署手册。无论您是初次接触 AI 智能体的新手，还是寻求高可用、安全、可扩展部署方案的资深工程师，都能在此找到所需的一切。

---

## 第一章：Hermes Agent 核心架构与 Docker 化优势

### 1.1 Hermes Agent 架构解析

Hermes Agent 采用模块化设计，主要由以下核心组件构成：

1.  **核心引擎 (Core Engine)**：负责接收指令、规划任务、调用工具、管理会话状态和与大语言模型（LLM）交互。
2.  **记忆系统 (Memory System)**：基于 SQLite 的 FTS5 扩展实现，用于存储和检索长期记忆、用户画像及历史对话摘要。
3.  **技能系统 (Skills System)**：动态创建、管理和执行 Python 函数形式的技能，这些技能是 Agent 自我进化的核心载体。
4.  **工具集 (Toolsets)**：内置超过 40 种工具，涵盖文件操作、终端执行、网页搜索、浏览器自动化、邮件发送等。
5.  **网关 (Gateway)**：提供统一的消息入口，将来自不同平台（如 Telegram, Discord, 飞书）的消息路由至核心引擎，并将响应发回。
6.  **调度器 (Scheduler)**：内置 cron 风格的定时任务系统，支持周期性自动化操作。

这种架构使得 Hermes Agent 能够作为一个 **常驻型服务** 运行，持续学习并为用户提供价值。

### 1.2 为何选择 Docker 部署？

将 Hermes Agent 容器化部署具有多重显著优势：

- **环境一致性**：Docker 镜像封装了所有运行时依赖（Python 3.11+, Node.js 18+ 等），确保在开发、测试和生产环境中行为一致，彻底告别“在我机器上是好的”问题。
- **强隔离性**：容器将 Hermes Agent 与其宿主机环境及其他服务隔离开来。即使 Agent 执行了危险的终端命令，其影响也仅限于容器内部，极大提升了系统安全性。
- **数据持久化**：通过 Docker 数据卷（Volumes）或绑定挂载（Bind Mounts），可以将 `~/.hermes` 目录（包含配置、记忆数据库、技能文件）持久化到宿主机，保证容器重启或重建后数据不丢失。
- **简化运维**：使用 `docker-compose` 可以一键启动、停止和管理整个 Hermes Agent 服务栈，包括其依赖项（如 Ollama 本地模型服务）。
- **资源控制**：可以轻松限制容器的 CPU、内存和磁盘使用量，防止单个服务耗尽系统资源。
- **无缝迁移**：只需将 `docker-compose.yml` 文件和数据目录复制到新服务器，即可快速完成服务迁移。

---

## 第二章：部署前准备

### 2.1 系统要求

- **操作系统**：Ubuntu 20.04 LTS / 22.04 LTS, Debian 11+, CentOS Stream 9+, macOS 12+ (Intel/Apple Silicon), Windows 11/10 (需通过 WSL2)。
- **硬件**：
  - **CPU**: x86_64 或 ARM64 架构。
  - **内存**: 最低 4GB，推荐 8GB 或以上（尤其当使用大型本地模型时）。
  - **磁盘**: 至少 5GB 可用空间（用于 Docker 镜像、模型缓存和数据存储）。
- **网络**: 稳定的互联网连接（用于拉取镜像、访问 LLM API 或下载本地模型）。

> **重要提示**：Hermes Agent **不支持** Windows 原生环境。Windows 用户必须先安装并配置 **WSL2 (Windows Subsystem for Linux 2)**。

### 2.2 安装 Docker 与 Docker Compose

#### 在 Ubuntu/Debian 上安装
```bash
# 1. 更新包索引并安装必要依赖
sudo apt update
sudo apt install -y ca-certificates curl gnupg lsb-release

# 2. 添加 Docker 官方 GPG 密钥
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 3. 设置稳定版仓库
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 4. 安装 Docker Engine 和 Compose Plugin
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 5. 将当前用户加入 docker 组，避免每次使用 sudo
sudo usermod -aG docker $USER
newgrp docker # 刷新组权限，或注销后重新登录
```

#### 在 CentOS/RHEL 上安装
```bash
# 1. 卸载旧版本（如有）
sudo yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine

# 2. 安装必要依赖
sudo yum install -y yum-utils

# 3. 添加 Docker CE 仓库
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

# 4. 安装 Docker Engine 和 Compose
sudo yum install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 5. 启动 Docker 服务并设置开机自启
sudo systemctl start docker
sudo systemctl enable docker

# 6. 将当前用户加入 docker 组
sudo usermod -aG docker $USER
newgrp docker
```

#### 验证安装
```bash
docker --version
docker compose version
```
应能看到类似 `Docker version 24.0.x` 和 `Docker Compose version v2.x.x` 的输出。

### 2.3 配置国内镜像加速器（可选但强烈推荐）

由于网络原因，直接从 Docker Hub 拉取镜像可能非常缓慢。建议配置国内镜像加速器。

编辑 `/etc/docker/daemon.json` 文件（若不存在则创建）：
```json
{
  "builder": {
    "gc": {
      "defaultKeepStorage": "20GB",
      "enabled": true
    }
  },
  "experimental": false,
  "registry-mirrors": [
    "https://docker.xuanyuan.me",
    "https://docker.1ms.run",
    "https://docker.m.daocloud.io"
  ]
}
```


重启 Docker 服务使配置生效：
```bash
sudo systemctl daemon-reload
sudo systemctl restart docker
```

---

## 第三章：基础 Docker 部署

### 3.1 创建项目目录与数据卷

首先，为 Hermes Agent 创建一个专用目录，并初始化数据存储位置。
```bash
mkdir -p ~/hermes-agent/{data,logs}
cd ~/hermes-agent
```
- `data/` 目录将用于持久化存储 Hermes 的所有数据（配置、记忆、技能）。
- `logs/` 目录用于集中存放日志文件，便于排查问题。

### 3.2 编写 `docker-compose.yml` 文件

在 `~/hermes-agent` 目录下创建 `docker-compose.yml` 文件，内容如下：

```yaml
version: '3.8'

services:
  hermes:
    image: nousresearch/hermes-agent:latest
    container_name: hermes-agent
    restart: unless-stopped
    environment:
      # === LLM 配置 ===
      # 选择模型提供商 (provider)
      - HERMES_MODEL_PROVIDER=openai
      # 选择具体模型名称
      - HERMES_MODEL_NAME=gpt-4o-mini
      # 填入您的 API Key
      - OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

      # === 其他可选环境变量 ===
      # 设置主目录 (默认为 /root/.hermes)
      - HERMES_HOME=/app/data/.hermes
      # 启用调试日志 (可选)
      # - HERMES_LOG_LEVEL=DEBUG
    volumes:
      # 将宿主机的 data 目录挂载到容器内，用于持久化所有数据
      - ./data:/app/data
      # 将宿主机的 logs 目录挂载到容器内，用于日志输出
      - ./logs:/app/logs
    ports:
      # 如果您计划使用 Web UI 或需要暴露某些端口，请在此配置
      # Hermes 默认主要通过 CLI 和 Gateway 工作，通常不需要暴露端口
      # - "8080:8080"
    # 如果您需要 GPU 支持，请取消下面的注释（需先安装 nvidia-docker）
    # deploy:
    #   resources:
    #     reservations:
    #       devices:
    #         - driver: nvidia
    #           count: all
    #           capabilities: [gpu]
```

> **关键配置说明**：
> - **`HERMES_MODEL_PROVIDER`**: 支持 `openai`, `anthropic`, `ollama`, `google`, `minimax`, `openrouter` 等。
> - **`HERMES_MODEL_NAME`**: 必须与所选 provider 兼容。例如，Ollama 用户应填写 `qwen3:32b`。
> - **`HERMES_HOME`**: 此环境变量告诉 Hermes 将其工作目录（`.hermes`）放在 `/app/data` 下，该路径已被挂载到宿主机的 `./data` 目录，从而实现数据持久化。
> - **API Keys**: 敏感信息如 `OPENAI_API_KEY` 应妥善保管。在生产环境中，更推荐使用 Docker secrets 或外部密钥管理服务。

### 3.3 初始化配置

首次启动前，我们需要运行 Hermes 的配置向导来生成初始配置文件。

```bash
# 使用 docker compose run 启动一个临时容器来运行 setup 命令
docker compose run --rm hermes setup
```

此命令会启动一个交互式会话，引导您完成以下步骤：
1.  **选择 LLM Provider**: 输入 `openai`、`ollama` 等。
2.  **输入 API Key**: 对于 Ollama，通常留空。
3.  **选择默认模型**: 从列表中选择或手动输入。
4.  **配置终端后端**: 选择 `local`（在容器内执行）、`docker`（在隔离的子容器中执行）或 `ssh`。
5.  **配置消息网关**: 可选择跳过，稍后再单独配置。

完成向导后，`./data/.hermes/config.yaml` 文件将被创建。

### 3.4 启动服务

现在，我们可以正式启动 Hermes Agent 服务。

```bash
# 在后台启动服务
docker compose up -d

# 查看服务状态
docker compose ps

# 查看实时日志
docker compose logs -f hermes
```

如果一切正常，您应该能在日志中看到类似 `Hermes Agent is ready` 的信息。

### 3.5 CLI 交互体验

进入正在运行的容器，通过 CLI 与 Hermes 交互。

```bash
# 进入容器的 shell
docker exec -it hermes-agent /bin/bash

# 启动 CLI 会话
hermes chat -c

# 退出 CLI 和容器
exit
```

在 CLI 中，您可以直接向 Hermes 发送指令，例如：“列出当前目录下的所有文件”，“帮我写一个 Python 脚本来计算斐波那契数列”。

---

## 第四章：高级部署场景

### 4.1 集成 Ollama 本地模型

为了降低成本并保障隐私，许多用户选择使用 Ollama 在本地运行开源大模型。

#### 4.1.1 部署 Ollama 服务

首先，在宿主机上安装并运行 Ollama。
```bash
# 下载并安装 Ollama
curl -fsSL https://ollama.com/install.sh | sh

# 拉取一个模型，例如 Qwen3 32B
ollama pull qwen3:32b

# 启动 Ollama 服务（通常安装后会自动启动）
ollama serve
```

#### 4.1.2 修改 Hermes 配置

更新 `docker-compose.yml` 文件中的环境变量部分：

```yaml
environment:
  - HERMES_MODEL_PROVIDER=ollama
  - HERMES_MODEL_NAME=qwen3:32b
  # Ollama 通常不需要 API Key
  # - OLLAMA_API_KEY=
  # 关键：让容器内的 Hermes 能访问宿主机的 Ollama 服务
  - OLLAMA_HOST=http://host.docker.internal:11434
```

> **注意**：`host.docker.internal` 是 Docker Desktop (Mac/Windows) 的特殊 DNS 名称。在 **Linux** 上，您需要使用宿主机的实际 IP 地址，或者在 `docker-compose.yml` 中添加 `extra_hosts` 配置：
> ```yaml
> extra_hosts:
>   - "host.docker.internal:host-gateway"
> ```

然后，重新构建并启动服务：
```bash
docker compose down
docker compose up -d
```

### 4.2 配置 Docker 沙箱执行后端

为了进一步提升安全性，可以将 Hermes 的终端命令执行限制在一个独立的、资源受限的 Docker 容器中。

#### 4.2.1 修改 `config.yaml`

进入容器或直接编辑宿主机上的 `./data/.hermes/config.yaml` 文件，找到 `terminal` 部分：

```yaml
terminal:
  backend: docker
  docker_image: python:3.11-slim # 使用轻量级基础镜像
  container_cpu: 1 # 限制 CPU 核心数
  container_memory: 5120 # 限制内存为 5120 MB (5GB)
  container_disk: 51200 # 限制磁盘为 51200 MB (50GB)
  container_persistent: true # 启用跨会话持久化（谨慎使用）
```

#### 4.2.2 重启服务

```bash
docker compose restart hermes
```

现在，当 Hermes 需要执行 `pip install` 或 `git clone` 等命令时，会在一个全新的、受限的 Docker 容器中进行，极大地降低了安全风险。

### 4.3 多消息平台网关部署

Hermes 的强大之处在于其多平台接入能力。我们可以通过修改配置文件来同时启用多个网关。

#### 4.3.1 获取各平台凭证

- **Telegram**: 在 [@BotFather](https://t.me/BotFather) 创建机器人，获取 `BOT_TOKEN`。
- **Discord**: 在 [Discord Developer Portal](https://discord.com/developers/applications) 创建应用，获取 `BOT_TOKEN`。
- **飞书**: 在 [飞书开放平台](https://open.feishu.cn/) 创建企业自建应用，获取 `APP_ID` 和 `APP_SECRET`。

#### 4.3.2 配置 `config.yaml`

在 `./data/.hermes/config.yaml` 中，找到或添加 `gateways` 部分：

```yaml
gateways:
  telegram:
    enabled: true
    bot_token: "YOUR_TELEGRAM_BOT_TOKEN"
  discord:
    enabled: true
    bot_token: "YOUR_DISCORD_BOT_TOKEN"
  feishu:
    enabled: true
    app_id: "YOUR_FEISHU_APP_ID"
    app_secret: "YOUR_FEISHU_APP_SECRET"
```

同样，将敏感的 Token 和 Secret 存储在环境变量中是更佳实践。可以在 `docker-compose.yml` 中通过 `env_file` 引用一个 `.env` 文件。

创建 `.env` 文件：
```env
TELEGRAM_BOT_TOKEN=your_telegram_token_here
DISCORD_BOT_TOKEN=your_discord_token_here
FEISHU_APP_ID=your_feishu_app_id
FEISHU_APP_SECRET=your_feishu_app_secret
```

然后在 `docker-compose.yml` 中引用：
```yaml
environment:
  - HERMES_MODEL_PROVIDER=openai
  - HERMES_MODEL_NAME=gpt-4o-mini
  - OPENAI_API_KEY=${OPENAI_API_KEY}
  # ... 其他环境变量
env_file:
  - .env
```

最后，重启服务以应用新的网关配置。

---

## 第五章：生产环境最佳实践

### 5.1 安全加固

- **最小权限原则**：确保运行 Docker 容器的用户权限尽可能低。
- **定期更新**：定期拉取最新的 `nousresearch/hermes-agent` 镜像，以获取安全补丁和新功能。
  ```bash
  docker compose pull
  docker compose up -d
  ```
- **网络隔离**：如果不需要从外部访问 Hermes，不要在 `ports` 中暴露任何端口。网关通信通常是出站的。
- **敏感信息管理**：绝对不要将 API Keys 硬编码在 `docker-compose.yml` 中。使用 `.env` 文件（并将其加入 `.gitignore`）或 Docker secrets。

### 5.2 数据备份与恢复

Hermes 的所有状态都存储在 `./data/.hermes` 目录下。定期备份此目录即可实现完整备份。

```bash
# 备份
tar -czvf hermes-backup-$(date +%Y%m%d).tar.gz ./data/.hermes

# 恢复（先停止服务）
docker compose down
rm -rf ./data/.hermes
tar -xzvf hermes-backup-20260428.tar.gz -C ./data
docker compose up -d
```

### 5.3 日志监控

将日志目录 `./logs` 接入集中式日志系统（如 ELK Stack, Loki+Grafana）可以方便地进行监控和告警。

### 5.4 性能优化

- **模型选择**：对于简单任务，使用更快、更便宜的小模型（如 `gpt-4o-mini` 或 `qwen3:8b`）。
- **资源限制**：根据服务器规格，在 `docker-compose.yml` 中合理设置 `deploy.resources.limits`。
- **本地模型缓存**：确保 Ollama 模型已完全下载到本地，避免每次推理都从网络加载。

---

## 第六章：故障排查与常见问题

### 6.1 容器无法启动

- **检查日志**: `docker compose logs hermes`
- **常见原因**:
  - 环境变量（特别是 API Key）格式错误。
  - 挂载的 `data` 目录权限不足。确保当前用户对 `~/hermes-agent` 目录有读写权限。
  - 镜像拉取失败。检查网络和镜像加速器配置。

### 6.2 网关无法接收消息

- **检查网关日志**: `cat ./logs/gateway.log`
- **常见原因**:
  - Bot Token 或 App Secret 错误。
  - 飞书/钉钉等平台的应用未正确发布或未添加到目标群聊。
  - 防火墙或安全组阻止了入站连接（对于需要回调 URL 的平台）。

### 6.3 记忆功能失效

- **确认配置**: 检查 `config.yaml` 中 `memory` 相关配置是否启用。
- **检查数据库**: 进入容器，查看 `/app/data/.hermes/memory.db` 文件是否存在且可读写。

### 6.4 本地模型（Ollama）连接失败

- **验证 Ollama**: 在宿主机上运行 `ollama list` 和 `ollama run qwen3:32b` 确认服务正常。
- **网络连通性**: 在 Hermes 容器内执行 `curl http://host.docker.internal:11434/api/tags` 测试能否访问 Ollama API。

---

## 结语

通过本指南，您已经掌握了从零开始到生产级部署 Hermes Agent 的全套技能。Docker 不仅为 Hermes 提供了一个干净、隔离、可移植的运行环境，还通过其强大的生态系统简化了复杂的运维任务。

Hermes Agent 的真正魅力在于其 **越用越聪明** 的特性。随着您与它的互动增多，它将不断积累关于您的知识，沉淀高效的技能，最终成为一个真正懂您、值得信赖的数字伙伴。

现在，启动您的容器，开始与这个自进化的 AI 智能体共同成长吧！

在 2026 年的 AI 技术浪潮中，智能体（Agent）技术正以前所未有的速度演进。继 OpenClaw（小龙虾）掀起第一波热潮后，由 Nous Research 实验室推出的 Hermes Agent 迅速成为开源社区的新宠。截至 2026 年 4 月，其 GitHub 仓库已收获超过 10 万颗星标，被开发者誉为“真正会自我进化的数字员工”。

Hermes Agent Docker 完整部署安装教程或指南 + 飞书+Discord+Telegram+本地模型（Ollama）接入，全程避坑

大数据

HermesAgent是2026年开源自进化AI智能体，支持15+消息平台，具备持久化记忆和技能沉淀能力。本指南详解Docker部署方案，涵盖基础配置、Ollama本地模型集成、多平台网关设置及生产环境优化，帮助开发者快速搭建高效安全的AI助手。

聊天机器人

数据存储

安全补丁

日志文件

数据备份

数据库

服务器

防火墙

Windows

GitHub

Python

路由

SQLite

Docker

容器

Linux

tencentdb-catalog

对象存储COS新用户低至1元！


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Hermes Agent Docker 完整部署安装教程或指南 + 飞书+Discord+Telegram+本地模型（Ollama）接入，全程避坑-腾讯云开发者社区-腾讯云

Hermes Agent Docker 完整部署安装教程或指南 + 飞书+Discord+Telegram+本地模型（Ollama）接入，全程避坑

Hermes Agent Docker 完整部署安装教程或指南 + 飞书+Discord+Telegram+本地模型（Ollama）接入，全程避坑

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐