服务器 Docker 安装 Hermes Agent 完整教程

什么是 Hermes Agent？

Hermes Agent 是 Nous Research 推出的开源 AI 智能体框架，能在终端、Telegram、Discord、Slack 等十几个平台上自主运行。它支持几乎所有主流 LLM 提供商（OpenRouter、Anthropic、OpenAI、DeepSeek 等 20+），具备持久记忆、技能学习、定时任务、多平台网关等强大能力。

简单来说，它就是你的 24 小时在线 AI 助手，而且完全开源。Hermes Agent 在 Docker 容器中运行，数据通过 Volume 持久化到宿主机 ~/.hermes/ 目录，删容器不丢数据。

环境要求

• 一台 Linux 服务器（x86_64 或 ARM64 均可）
• 已安装 Docker 和 Docker Compose
• 至少 2GB 可用内存
• 一个 LLM API Key（推荐 OpenRouter 或 DeepSeek，性价比高）

方案一：Docker Compose 安装（推荐）

第一步：创建配置目录

mkdir -p ~/.hermes

第二步：配置 API Key

创建 ~/.hermes/.env 文件：

# 使用 OpenRouter
OPENROUTER_API_KEY=sk-or-v1-你的密钥

# 或用 DeepSeek
DEEPSEEK_API_KEY=sk-你的密钥

# Telegram Bot Token（接入 Telegram 用）
TELEGRAM_BOT_TOKEN=你的机器人Token

第三步：编写 docker-compose.yml

services:
  gateway:
    image: ghcr.io/nousresearch/hermes-agent:latest
    container_name: hermes
    restart: unless-stopped
    network_mode: host
    volumes:
      - ~/.hermes:/opt/data
    environment:
      - HERMES_UID=${HERMES_UID:-1000}
      - HERMES_GID=${HERMES_GID:-1000}
    command: ["gateway", "run"]

  dashboard:
    image: ghcr.io/nousresearch/hermes-agent:latest
    container_name: hermes-dashboard
    restart: unless-stopped
    network_mode: host
    depends_on:
      - gateway
    volumes:
      - ~/.hermes:/opt/data
    environment:
      - HERMES_UID=${HERMES_UID:-1000}
      - HERMES_GID=${HERMES_GID:-1000}
    command: ["dashboard", "--host", "127.0.0.1", "--no-open"]

第四步：启动容器

HERMES_UID=$(id -u) HERMES_GID=$(id -g) docker compose up -d

方案二：docker run 单命令

docker run -d \
  --name hermes \
  --restart unless-stopped \
  --network host \
  -v ~/.hermes:/opt/data \
  -e HERMES_UID=$(id -u) \
  -e HERMES_GID=$(id -g) \
  ghcr.io/nousresearch/hermes-agent:latest \
  gateway run

配置模型

容器启动后，进入容器选择模型：

docker exec -it hermes hermes model

按提示选择你的提供商和模型即可。推荐：DeepSeek V3（便宜且强）、Claude Sonnet 4（代码能力顶级）、GPT-4o（综合能力强）。

接入大模型后，Hermes 就能在你的 Telegram、Discord 等平台上提供 24 小时智能对话服务。

接入 Telegram 机器人

第一步：创建 Bot

在 Telegram 找 @BotFather，发送 /newbot，按提示操作拿到 Token。

第二步：填入配置

把 Token 写入 ~/.hermes/.env：

TELEGRAM_BOT_TOKEN=你的Bot Token

第三步：配置网关

docker exec -it hermes hermes gateway setup

选择 Telegram，按提示完成配置。

第四步：重启并验证

docker compose restart

给 Bot 发消息，它应该秒回了！发送 /help 查看所有命令。

Hermes 通过 Telegram Bot API 无缝接入聊天界面，支持文本、语音、文件等全部交互方式。

常用管理命令

功能	命令
查看状态	docker compose ps
查看日志	docker compose logs -f gateway
进入容器	docker exec -it hermes bash
CLI 对话	docker exec -it hermes hermes chat -q "你好"
切换模型	docker exec -it hermes hermes model
安装技能	docker exec -it hermes hermes skills install 技能名
健康检查	docker exec -it hermes hermes doctor

推荐安装的技能

# GitHub 工作流（Issue、PR、Code Review）
docker exec -it hermes hermes skills install github-pr-workflow

# 代码审查
docker exec -it hermes hermes skills install github-code-review

# 系统化调试
docker exec -it hermes hermes skills install systematic-debugging

# TDD 测试驱动开发
docker exec -it hermes hermes skills install test-driven-development

# YouTube 内容处理
docker exec -it hermes hermes skills install youtube-content

多平台接入

Hermes 支持 15+ 平台，在 .env 中配置对应环境变量，然后运行 hermes gateway setup 即可：

• Discord — DISCORD_BOT_TOKEN
• Slack — SLACK_BOT_TOKEN + SLACK_APP_TOKEN
• WhatsApp — 通过 Baileys 扫码登录
• Signal — SIGNAL_CLI_PATH
• 邮件 — 配置 IMAP/SMTP

进阶：定时任务

Hermes 内置 Cron 调度器：

# 每天早上 9 点发送天气简报
docker exec -it hermes hermes cron create "0 9 * * *" -q "查询上海今天天气并总结"

# 每小时检查一次 GitHub 通知
docker exec -it hermes hermes cron create "every 1h" -q "检查 GitHub 通知并总结"

更新与升级

docker compose pull
docker compose up -d

所有数据（配置、会话记录、技能、记忆）都保存在 ~/.hermes/ 目录并挂载到宿主机，删容器不丢数据。

常见问题

Q：容器启动后没反应？
查看日志：docker compose logs gateway。常见原因是 .env 没配好或 API Key 无效。

Q：ARM64 服务器能用吗？
可以，官方镜像原生支持 ARM64。

Q：内存不够怎么办？
Hermes 本身不占多少内存，主要消耗来自 LLM API 调用的上下文。如果服务器内存紧张，可用 DeepSeek 等 token 便宜的模型，或降低上下文窗口。

---

现在你就在 Telegram 上拥有一个 24 小时在线的 AI 助手了！部署中遇到问题可以去 GitHub Issues 提问。