Hermes Agent 远程服务器 Docker 云部署全攻略

想要让你部署的 Hermes Agent 在远程服务器上 24 小时不间断运行，不受本地电脑关机、休眠或网络中断的影响，同时还能随时通过手机上的 Telegram 或飞书给它发指令，让它帮你整理文件、分析日志、生成定时报告——这其实是可以做到的。

准备云服务器并安装 Docker

首先，租一台最低配置 1 核 1GB 内存的云服务器。登录服务器后，执行 sudo apt update && sudo apt install -y docker.io docker-compose，然后运行 docker --version 和 docker-compose --version，确保两个命令都能正常输出版本号。

这里有个关键提醒：国内用户在拉取 Docker 镜像时，如果不换个镜像源，很可能会卡在下载环节。建议执行以下命令配置轩辕镜像源：

sudo mkdir -p /etc/docker && echo '{"registry-mirrors": ["https://docker.xuanyuan.run"]}' | sudo tee /etc/docker/daemon.json > /dev/null

配置完成后，别忘了重启 Docker：sudo systemctl restart docker。

拉取并运行 Hermes Agent 容器

两种方式可选，看你的使用场景。

方法一：单命令快速启动
适合先跑起来验证一下效果。直接执行：

docker run -d --name hermes-agent -p 3000:3000 -v hermes-data:/root/.hermes -e HERMES_MODEL_PROVIDER=kimi -e HERMES_API_KEY="your_kimi_api_key_here" -e TZ=Asia/Shanghai --restart unless-stopped docker.xuanyuan.run/nousresearch/hermes-agent:latest

方法二：Docker Compose 管理
生产环境推荐这样做，方便维护。先创建一个 docker-compose.yml 文件，内容如下：

version: "3.8"
services:
  hermes-agent:
    image: docker.xuanyuan.run/nousresearch/hermes-agent:latest
    container_name: hermes-agent
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - hermes-data:/root/.hermes
    environment:
      - HERMES_MODEL_PROVIDER=kimi
      - HERMES_API_KEY=${HERMES_API_KEY}
      - TZ=Asia/Shanghai
volumes:
  hermes-data:

同时创建同目录下的 .env 文件，写入你的 Kimi API 密钥：HERMES_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx。最后执行 docker-compose up -d 启动即可。

需要特别留意：API 密钥必须填写真实有效的 Kimi 密钥，而且不能有多余的空格或换行。如果填错了，容器会反复重启，根本无法进入后续的配置流程。

进入容器完成初始化配置

容器启动后，需要进入容器内部进行一些关键配置。

第一步：进入容器终端

docker exec -it hermes-agent bash

第二步：运行交互式配置向导

hermes setup

按照提示依次选择：大模型提供商选 kimi，API Key 那里可以直接回车跳过（因为已经通过环境变量注入了），消息平台选 telegram 或 feishu，执行后端选 local。

第三步：配置消息平台 Bot Token

以 Telegram 为例。先去 @BotFather 创建新 Bot 并获取 Token，然后回到容器内执行：

hermes gateway telegram set-token your_bot_token_here
hermes gateway telegram enable

飞书的配置逻辑类似，只不过需要在飞书开放平台先创建自建 Bot 并获取 app_id 和 app_secret。

这里有一个最容易踩的坑：所有的配置操作都必须在容器内部完成。如果直接在宿主机上运行 hermes setup，会导致路径不对，记忆和技能模块无法正常持久化，服务一重启数据就丢了。

验证云端服务是否就绪

配置完成后，用 hermes status 命令检查一下状态。如果输出中显示 status: running 且 gateway: enabled，说明核心服务和消息网关都已经激活了。

接下来，给你的 Telegram Bot（或飞书 Bot）发一条消息试试，比如发一句“你好”。如果在 5 秒内能收到回复，且不是报错信息，那就说明整个消息链路已经打通。

如果遇到问题，可以用 docker logs hermes-agent --tail 20 查看最近 20 行日志，重点检查有没有出现 Connection refused 或 Invalid API key 这样的错误信息。这些通常是配置出错最直接的风向标。

你是一名 AI 行业编辑，请围绕下面这条热点输出一份资讯解读：
热点：Hermes Agent 远程服务器 Docker 云部署全攻略要求：
1. 先用一句话解释这条热点在讲什么
2. 再总结它为什么重要
3. 说明会影响哪些 AI 产品或内容方向
4. 最后给出 3 个适合资讯站使用的标题