跳到主要内容

Hermes Agent 快速入门指南

应用简介​

Hermes Agent 是 Nous Research 推出的开源自学习 AI Agent，支持本地或服务器长期运行，可处理文件、执行任务、管理会话与记忆，通过浏览器控制台或消息平台与用户交互。

  1. 安全提示：本应用具备文件访问和命令执行能力，请勿将敏感文件放入其工作目录。官方提供安全模型、命令审批、容器隔离和用户授权等机制。

  2. 系统要求：最低可用内存 1 GB，推荐 2 至 4 GB；启用浏览器自动化建议至少 2 GB。安装约需 10 分钟，具体受网络和镜像拉取影响。

  3. 默认登陆账号：admin

应用安装步骤​

  1. 在应用中心“全部”中找到 Hermes Agent，点击“安装”。

  2. 选择安装位置后点击“下一步”。

image.png

  1. 填写核心配置参数：

● 应用数据路径：AI 编写代码、生成文件及存放临时数据的专属目录，请分配一个专属空文件夹。

● 文件访问路径：授权 AI 读取/修改 NAS 文件的目录。点击“添加”可配置多个目录。

● 登录密码：设置访问 Web 端管理界面时所需的验证密码。

image.png

注意：

● 请勿挂载包含隐私或高度敏感数据的文件夹。

● “文件访问路径”与“应用数据路径”不可使用同一个目录，且不能存在上下级子目录关系。

● 在外部删除、修改或移动这些已挂载的文件夹，将导致功能异常。

访问 Hermes Agent 应用​

你可以通过以下方法访问 Hermes Agent 应用：

方法一：通过应用中心访问​

在局域网内，管理员点击 Hermes Agent 应用图标，系统将跳转至登录界面。

方法二：通过局域网访问​

在局域网内使用http://NAS_IP:``9119访问。例如 NAS 的 IP 是192.168.10.146，在浏览器中输入http://192.168.10.146:``9119进行访问。

注意：

● 你可以在**“系统设置”**中，找到【网络设置】，点击【网口】，查看 NAS 设备的 IP 地址。

image.png

Web 管理界面​

访问应用​

点击桌面快捷方式跳转至浏览器，输入默认用户名：admin以及安装时设定的密码登录。

image.png

登陆成功后，页面显示如下图

image.png

切换语言​

点击左边导航栏的“**EN **”，选择“**简体中文”**可切换为中文界面。

image.png

大语言模型 API Key 配置​

Hermes Agent 必须依赖外部的大语言模型（LLM）提供算力。本文以配置 DeepSeek 为例，演示具体接入流程。

第一步 ：创建 API Key​

先去 DeepSeek 官网的开发者后台创建一个 API Key——注意只展示一次，记得复制保存好。

image.png

第二步：配置 DeepSeek API 密钥​

在左侧菜单找到“密钥”，在LLM提供商中展开 DeepSeek，设置DEEPSEEK_BASE_URL和DEEPSEEK_API_KEY，然后点击“保存”。

注意：

**● **DEEPSEEK_BASE_URL填写：https://api\.deepseek\.com **● **DEEPSEEK_API_KEY填写第一步获取到的API Key

image.png

第三步：选择 AI 模型​

在侧边栏找到“模型”，点击“CHANGE”，修改模型

image.png

在 MAIN MODEL 弹窗中搜索 deep，选择 deepseek-v4-flash，点击“Switch”确认。

image.png

第四步：跟 AI 对话测试​

在侧边栏点击“对话”开始跟 AI 聊天，确认模型响应正常。

image.png

配置微信机器人​

**重点说明：**Hermes 默认有通道配置页面，但微信配置需要手动填写 WeChatFerry 的 Account ID、Token、Base URL 等参数，门槛较高。本教程采用另一种方式——直接跟 AI 说需求，让它自动配置。

第一步：让 AI 帮你配微信通道​

在对话窗口输入：

"我需要连接微信和你对话，你帮我配置通道，我可以使用二维码扫描"

AI 理解需求后立刻开始行动——查阅文档、搜索文件、执行代码。期间会弹出审批框询问是否允许执行脚本：

image.png

第二步：确认配置计划​

AI 会列出完整的配置计划，包括安装依赖、生成二维码、配置环境变量、启用网关等。然后问你是否准备好：

image.png

输入「可以开始」确认。

第三步：授权 AI 安装 CLI 和依赖​

安装tmux需要管理员root密码，铁牛暂不提供给用户。我们可以随便输入密码，AI会自动识别没有root权限，改成PTY后台模式去安装。

image.png

第四步：启动微信通道，扫码连接​

按提示回到桌面，点击【文件管理】找到应用安装时设置的【应用数据路径】下的二维码图片，使用微信“扫一扫”，完成二维码认证**。**

image.png

第五步：微信发送消息，完成配对​

扫码后微信网关连接成功，终端会显示 「微信通道已经配置成功并正在运行！🎉」：

image.png

这时在微信给机器人发「你好」——注意第一次会返回一个配对码。

img_v3_0214i_761d6433-1507-4bf9-be5f-0876668b6bbg.jpg

把这个配对情况告诉 AI，让它执行审批命令 hermes pairing approve weixin TUTHNEPU。审批通过后就可以正常对话了。

image.png

第六部：聊天测试​

完成后在微信对话框发送消息就可以正常对话了

image.png