hermes agent NAS部署教程

Hermes Agent 是由 Nous Research 开发的开源自主 AI 智能体框架，以其‘自进化’学习闭环在 2026 年迅速走红，GitHub 星标在两个月内突破 4.7 万。它的核心价值在于：内置的‘执行-学习-改进’闭环，能从每一次任务中自动提炼技能、持久记忆用户偏好，真正做到‘越用越懂你’。把它部署在 NAS 上，等于给你的家庭数据中心配了一位 7×24 小时在线、低功耗 of AI 管家——无需专门购置云服务器，利用 NAS 本就全天候运行的优势，即可拥有一个随叫随到的数字助手。

本文大纲

• 💡 一、部署前必读：为什么选 Docker？需要什么配置？
• 🛠️ 二、群晖 NAS 部署教程（Docker Compose 方案）
• 🛠️ 三、威联通 NAS 部署教程（Docker Compose + Ubuntu 双方案）
• 🛠️ 四、极空间 NAS 部署教程（Compose 一键部署）
• 🔧 五、通用步骤：初始化配置与飞书接入
• 📦 六、数据持久化：记忆和技能不能丢
• 🚨 七、常见问题与排障
• 📋 总结

图源：AI生成示意图

一、部署前必读：为什么选 Docker？需要什么配置？

在 NAS 上部署 Hermes Agent，Docker 容器化部署是首选方案。推荐 Docker 的原因很简单：环境隔离、权限可控、资源占用低，最重要的是部署简单，维护方便。而且 Hermes Agent 比 OpenClaw 更好管理，配置基于 YAML 文件，容错性更强。

硬件配置建议：

💡 如果你的 NAS 内存只有 2GB，也能跑通基础功能，但并发处理能力受限。日常轻度使用 4GB 足够，重度使用或多人共享建议升级到 8GB。

部署前请确认：NAS 已安装 Docker / Container Station（群晖为 Docker，威联通为 Container Station，极空间为 Docker 应用），且具备稳定的互联网连接用于拉取镜像和下载依赖。

二、群晖 NAS 部署教程（Docker Compose 方案）

第一步：创建数据目录。SSH 登录群晖 NAS，或通过‘控制面板 → 终端机和 SNMP’开启 SSH 后远程连接。执行以下命令创建持久化数据目录：

mkdir -p /volume1/docker/hermes 
cd /volume1/docker/hermes 
mkdir -p data config skills logs

第二步：编写 docker-compose.yaml。在 /volume1/docker/hermes/ 目录下创建 docker-compose.yaml 文件：

version: '3.8' 
services: 
  hermes: 
    image: nousresearch/hermes-agent:latest 
    container_name: hermes 
    restart: unless-stopped 
    command: gateway run 
    ports: 
      - '8642:8642' 
    volumes: 
      - ./data:/opt/data 
    deploy: 
      resources: 
        limits: 
          memory: 4G 
          cpus: '2.0'

如果希望同时部署 Web 仪表盘（可选），在文件末尾追加：

  dashboard: 
    image: nousresearch/hermes-agent:latest 
    container_name: hermes-dashboard 
    restart: unless-stopped 
    command: dashboard --host 0.0.0.0 
    ports: 
      - '9119:9119' 
    volumes: 
      - ./data:/opt/data 
    environment: 
      - GATEWAY_HEALTH_URL=http://hermes:8642 
    depends_on: 
      - hermes 
    deploy: 
      resources: 
        limits: 
          memory: 512M 
          cpus: '0.5'

第三步：启动容器：

docker compose up -d

第四步：验证运行状态：

docker compose ps 
docker compose logs hermes

看到 gateway started 即表示启动成功。

三、威联通 NAS 部署教程（Docker Compose + Ubuntu 双方案）

威联通 NAS 提供两种部署路径，Docker Compose 是更推荐的主流方案。

方案 A：Docker Compose 部署（推荐）

第一步：创建项目目录。通过 SSH 登录威联通 NAS，或打开 File Station 手动创建：

mkdir -p /share/Container/hermes 
cd /share/Container/hermes 
mkdir -p data

第二步：编写 docker-compose.yaml。在 /share/Container/hermes/ 目录下创建 docker-compose.yaml，内容与群晖版本完全一致（见上文）。

第三步：启动容器。打开威联通 Container Station，选择‘应用程序 → 创建 → 从 Compose YAML 创建’，粘贴 YAML 内容后点击创建。或通过 SSH 执行：

docker compose up -d

方案 B：Ubuntu Linux 工作站（备选）

如果你的威联通 NAS 型号支持‘Ubuntu Linux 工作站’应用，也可以通过该方案部署。先在 App Center 应用商店下载并安装 Ubuntu Linux 工作站，选择‘24.04’版本安装，系统会自动完成全程无人值守安装。

安装完成后点击‘启用远程桌面’，密码为威联通 NAS 登录密码。建议开启 Ubuntu 系统的远程桌面，记下用户名和密码。在‘启用网络连接’后获取 IP 地址。然后通过 Windows 远程桌面连接输入该 IP，打开终端。

进入终端后执行官方一键安装脚本：

c​url -fsSL https://raw.githubusercontent​.com/NousResearch/hermes-agent/main/scripts/install.sh | b​ash 
source ~/.b​ashrc

💡 推荐理由：Docker 部署更简单、权限更可控、资源占用更低。除非你的 NAS 型号不支持 Docker 或你有特殊需求，否则 Docker Compose 是首选。

四、极空间 NAS 部署教程（Compose 一键部署）

极空间 NAS 的 Docker 应用对 Compose 支持非常友好，可实现‘零配置’启动。

第一步：打开 Docker Compose。在极空间 Docker 应用中选择 Compose，填入以下代码：

services: 
  hermes: 
    image: nousresearch/hermes-agent:latest 
    volumes: 
      - ./.env:/opt/data/.env 
      - ./data:/opt/data 
    command: gateway run 
    restart: unless-stopped 
    stdin_open: true 
    tty: true 
    deploy: 
      resources: 
        limits: 
          memory: 4G 
          cpus: '2.0'

第二步：配置 .env 文件。在下方的‘添加 .env’选项中导入你的环境变量文件，务必填入你的模型 API Key（如阿里云百炼、OpenRouter 等）。

第三步：启动容器。点击‘创建’启动项目，在容器标签页找到 hermes 项目，点击‘远程访问’进入配置页面。

💡 如果后续想编辑 .env，在个人空间左下角设置里打开‘隐藏文件显示’即可找到。

五、通用步骤：初始化配置与飞书接入

无论你使用哪种 NAS，容器启动后都需要完成以下配置。

第一步：初始化模型配置。首次运行需要进入交互式配置向导：

# 进入容器执行设置向导 
docker e​xec -it hermes hermes setup

根据提示选择大模型提供商（国内用户推荐阿里云百炼、OpenRouter 或 MiniMax），输入 API Key 并选择默认模型。注意：MiniMax 用户务必选择国内端点，否则无法连接。

第二步：接入飞书机器人。飞书是目前国内最适配 Hermes 的 IM 渠道，支持工具链输出和敏感操作确认。

在 ./data/.env 文件中添加飞书配置：

FEISHU_APP_ID=cli_xxx 
FEISHU_APP_SECRET=secret_xxx 
FEISHU_DOMAIN=feishu 
FEISHU_CONNECTION_MODE=websocket

保存后重启容器：

docker compose resta