Hermes Agent 远程服务器部署（Docker/Cloud）全攻略【云端运行】-人工智能-PHP中文网

推荐使用腾讯云lighthouse一键部署：选择hermes agent专属应用镜像，自动完成环境配置与初始化；或docker compose方式部署，配置api密钥、消息平台bot token及持久化存储，确保7×24稳定运行。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

hermes agent 远程服务器部署（docker/cloud）全攻略【云端运行】

你想让 Hermes Agent 在远程服务器上 7×24 小时稳定运行，不受本地电脑关机、休眠或网络中断影响，同时能通过手机 Telegram 或飞书随时发指令调用它执行文件整理、日志分析、定时报告等任务。

准备云服务器并安装 Docker

租用一台最低配置为 1 核 1GB 内存的云服务器（腾讯云轻量应用服务器 Lighthouse 推荐，新用户首年低至 ¥38）→ 登录服务器后执行 sudo apt update && sudo apt install -y docker.io docker-compose → 验证安装：运行 docker --version 和 docker-compose --version，二者均需输出版本号。

国内用户务必改用轩辕镜像源加速拉取，否则可能卡在镜像下载环节。执行：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 文件，写入：HERMES_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx → 执行 docker-compose up -d 启动。

【HERMES_API_KEY 必须填入真实 Kimi API 密钥，且不能带空格或换行；若填错，容器会反复重启无法进入 setup 流程】

进入容器完成初始化配置

第一步：进入容器终端
docker exec -it hermes-agent bash

Docker Compose Linter

检查 docker-compose.yml 文件的安全问题、最佳实践和端口冲突

下载

第二步：运行交互式配置向导
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 会初始化错误路径，导致记忆和技能无法持久化。