飞牛NAS安装Hermes-Agent详细教程

Hermes Agent 是一个开源的 AI 助手，能记住对话、学习习惯，还能接入微信、飞书、钉钉等聊天平台。完全免费，部署在你自己的设备上，数据你说了算。

这篇写给飞牛NAS用户，教你把 Hermes Agent 跑起来。全程图形界面操作，不用敲代码。

一、准备工作

1. 确认飞牛NAS版本

飞牛OS 基于 Debian 12，天然支持 Docker。在「设置 → 关于」里看版本号，建议 0.8.0 以上。

2. 准备 AI 模型的 API Key

Hermes Agent 本身只是个「壳」，需要连接 AI 模型才能干活。至少准备一个：

模型提供商	获取方式	费用
OpenRouter	openrouter.ai 注册获取 Key	按量付费，支持很多模型
OpenAI	platform.openai.com 获取 Key	按量付费
Anthropic	console.anthropic.com 获取 Key	按量付费
硅基流动	siliconflow.cn 获取 Key	国内可用，按量付费
DeepSeek	platform.deepseek.com 获取 Key	国内可用，按量付费

国内用户推荐用硅基流动或 DeepSeek，访问稳定，价格也便宜。

3. 开启 Docker

打开飞牛NAS桌面，找到「Docker」图标。如果显示「未开启」，点一下开启。首次开启会让你选数据存储位置，找个空间够的路径。

二、部署 Hermes Agent

飞牛NAS 有两种部署方式：容器方式和 Compose 方式。两种都是图形界面操作，选你顺手的。

方式一：容器方式部署

步骤 1：创建数据文件夹

打开「文件管理」
进到 Docker 数据目录（比如 /我的文件/docker/）
新建文件夹，命名为 hermes
创建好以后，要点击一下地址栏，查看到真实地址比如：/vol1/1000/Docker/hermes 这个文件夹后面要用。

步骤 2：拉取镜像

打开「Docker」
点左侧「本地镜像」
点右上角「添加镜像」
输入：nousresearch/hermes-agent:latest
确定等下载
拉不动的话，去飞牛论坛搜「Docker 镜像加速」，配个国内源。常用的有：

https://docker.1ms.run
https://docker.1panel.live

步骤 3：创建容器

这里有两种方式，选一种就行：

方式 A：先创建临时容器配置，再创建正式容器（官方推荐，步骤清晰）

在「容器」界面点击右上角「添加容器」
在「添加容器」界面，镜像名称选择刚才拉取的 nousresearch/hermes-agent

容器名称默认就好，也可以自己填，比如：hermes-setup（临时的）

不要勾选「开机自启」
点「下一步」
高级设置：

存储位置：

点「存储位置」
主机路径：选刚才建的 /vol1/1000/docker/hermes
容器路径：填 /opt/data
权限：读写

点「下一步」→「创建容器」。

容器创建后：

在「容器」列表找 hermes-setup
点右侧三个点 →「终端」→「/bin/bash」
在终端里输入：hermes setup
回车，按提示配置 API Key
配置完成后，停止并删除这个临时容器
然后重新创建正式容器：
在「本地镜像」找到 nousresearch/hermes-agent
点右侧「启动」
容器名称填：hermes
勾选「开机自启」 →「这是和上一步最大的区别」
存储位置同上（/vol1/1000/docker/hermes → /opt/data）
端口：主机端口 8642（被占用就改别的），容器端口 8642
命令填：gateway run
点「下一步」→「完成」

方式 B：直接创建正式容器，进终端配置（步骤少，适合懒人）

在「本地镜像」找到 nousresearch/hermes-agent
点右侧「启动」
容器名称填：hermes
勾选「开机自启」
点「下一步」

高级设置：

存储位置：

点「添加路径」
主机路径：选刚才建的 /vol1/1000/docker/hermes
容器路径：填 /opt/data
权限：读写

端口设置：

点「添加端口」
主机端口：8642（如果这个端口被占用了，改成其他没被用的端口，比如 18642）
容器端口：8642（这个不要改）

命令设置： 在「高级设置」里找到「终端」→「/bin/bash」，填：gateway run

点「下一步」→「完成」。

容器创建后会自动启动，但还需要配置 API Key：

在「容器」列表找 hermes
点右侧三个点 →「终端」→「/bin/bash」
在终端里输入：hermes setup
回车

会看到：

1
2
3
4
5
6
Welcome to Hermes Agent Setup!? Select your model provider:  ❯ OpenRouter    OpenAI    Anthropic    Custom endpoint

方向键选你的模型提供商，回车。然后按提示输入 API Key。

配置完成后提示「Setup complete！」。

退出终端，在容器列表里点右侧三个点 →「重启」，让配置生效。

两种方式选哪种？

方式 A 步骤多但清晰，配置和运行分开
方式 B 步骤少，但需要在运行的容器里操作

都能达到同样效果，看你顺手。

方式二：Compose 方式部署

飞牛NAS 有可视化的 Compose 部署界面，不用敲命令。

步骤 1：创建项目文件夹

打开「文件管理」
进到 Docker 数据目录（比如 /vol1/1000/docker/）
新建文件夹，命名为 hermes

步骤 2：创建 Compose 项目

打开「Docker」
点左侧「Compose」
点右上角「新增项目」
填写：

项目名称：hermes
路径：选刚才创建的 hermes 文件夹
来源：选「创建 docker-compose.yml」

在下面的文本框里粘贴：

1
2
3
4
5
6
7
8
9
10
services:  hermes:    image: nousresearch/hermes-agent:latest    container_name: hermes    restart: unless-stopped    command: gateway run    ports:      - "8642:8642"    volumes:      - ./data:/opt/data

如果 8642 端口被占用，把前面的 8642 改成其他端口，比如 "18642:8642"。

勾选「创建项目后立即启动」
点「确定」

等镜像下载完成，容器就会自动启动。

步骤 3：配置 Hermes

同容器方式的步骤 4，在终端里运行 hermes setup 配置 API Key。

三、接入聊天平台

Hermes 支持很多聊天平台，国内用户推荐接入微信或飞书。

接入微信

Hermes 通过腾讯的 iLink Bot API 连接个人微信，扫码就能登录。

在容器终端里输入：hermes gateway setup
选择「Weixin」
终端会显示一个二维码，用微信扫码登录（如果没有显示二维码，会显示一个网址，将网址复制到浏览器的地址栏打开就会显示二维码。）
登录成功后，重启容器

之后你就可以在微信里和 Hermes 对话了。（初次对话，会生成一个配对码，按对话要求执行命令进行配对就可以了。）

接入飞书

在飞书开放平台创建一个企业自建应用
获取 App ID 和 App Secret
在容器终端里输入：hermes gateway setup
选择「Feishu」
输入 App ID 和 App Secret
重启容器具体配置可以参考 Hermes 官方文档的「Feishu/Lark」章节。

接入企业微信、钉钉

流程类似，都是先在对应平台创建应用，获取凭证，然后通过 hermes gateway setup 配置。

四、常见问题

Q1：镜像拉不下来

国内访问 Docker Hub 慢。方案：

配镜像加速器（阿里云、腾讯云都有免费）
用代理
飞牛论坛搜「Docker 镜像加速」

Q2：容器启动就停

看日志：

点容器「运行日志」
常见原因：数据目录权限、端口被占、配置错

Q3：要多少内存？

官方说：

最低 1GB
推荐 2-4GB

开浏览器自动化的话至少 2GB。

Q4：数据在哪？

都在挂载的目录里（/vol1/1000/docker/hermes/data）：

.env - API 密钥
config.yaml - 配置
sessions/ - 对话历史
memories/ - 记忆

升级镜像不会丢数据，目录不变就行。

Q5：怎么升级？

容器方式：

停止并删除旧容器
在「镜像仓库」重新拉取最新镜像
重新创建容器（存储路径不变）

Compose 方式：

在 Compose 项目里点「编辑」
勾选「总是拉取最新镜像」
保存，项目会自动重建

有问题直接留言，看到会回。