★ FEATURED ARTICLE Hermes Agent 是由 Nous Research 推出的开源自主 AI 智能体框架具备持久记忆、自动技能创建和多平台通信等核心能力能从任务中自动提炼技能并跨会话持久记忆用户偏好真正实现“越用越强”。截至 2026 年 4 月该项目在 GitHub 上已获得超过 5.2 万 Stars。Hermes Agent 原生支持 Docker 部署而绿联 UGOS Pro 系统对 Docker Compose 有着良好的原生支持非常适合作为其运行平台。本教程将手把手带你在绿联 NAS 上完成 Hermes Agent 的完整部署与配置。一、前期准备在开始部署前请确认以下条件NAS 设备绿联 x86 架构 NAS 设备INTEL / AMD CPU 平台UGOS Pro 系统。目前绿联 DXP 全系列NAS 均支持 Docker Compose。Docker 环境UGOS Pro 系统默认未开启 Docker需先在应用中心安装 Docker 应用。LLM API 密钥至少需要一个 LLM 提供商的 API Key。推荐国内用户使用 OpenRouter聚合 200模型一个密钥通吃也可使用 OpenAI、Anthropic 或接入本地 Ollama。可选如需接入消息平台需提前准备飞书应用凭证或 Telegram Bot Token 等。资源建议内存建议 4GB 以上Hermes Agent 本身不运行大模型而是通过 API调用对本地资源占用较小但若需接入微信或运行浏览器自动化等工具建议分配更多内存。二、使用 Docker Compose 创建项目推荐使用 Docker Compose 方式部署容器这种方法简化了容器的部署与管理工作具体操作步骤打开绿联 NAS 桌面上的 Docker 应用。点击左侧菜单栏的 项目。点击 创建 按钮启动项目创建向导。在 项目名称 栏中填写 hermes-agent只能使用小写字母。存放路径可以留空系统会自动在 Docker 目录下生成与项目同名的文件夹。将以下 Docker Compose 配置代码粘贴到 Compose 配置区域services:hermes:image:nousresearch/hermes-agent:latestcontainer_name:hermesrestart:unless-stoppednetwork_mode:hostuser:0:0entrypoint:[sh,-c]command:-|chmod -R 777 /opt/data 2/dev/null || true exec hermes gateway runvolumes:-./data:/opt/dataenvironment:-PATH/opt/hermes/.venv/bin:/usr/local/bin:/usr/bin:/bin-HERMES_EXTRA_PIP_PACKAGESaiohttp httpx python-dotenv-TZAsia/Shanghaideploy:resources:limits:memory:4Gcpus:2.0代码说明network_mode: host使用宿主机网络模式便于后续连接本地 Ollama 等服务。user: 0:0以 root 身份运行解决绿联挂载目录的写入权限问题。entrypoint与command段中的chmod -R 777 /opt/data确保数据目录具有正确的读写权限。deploy.resources.limits限制容器资源使用上限可根据 NAS 实际配置适当调整。Hermes Agent 不涉及端口映射主要通过命令行和消息平台交互目前无内置 Web UI。7. 确认配置无误后点击 立即部署。系统将自动拉取 nousresearch/hermes-agent:latest 镜像并启动容器三、配置大模型LLM部署完成后需要进入容器终端配置聊天渠道与大语言模型这里以 minimax 大语言模型为例。在Docker左侧栏点击“容器”找到刚刚创建的 hermes 容器并点击进入详情页。在终端命令行中输入 hermes setup 并回车。向导会依次引导你完成以下配置选择 LLM Provider模型提供商——国内用户推荐选择 OpenRouter聚合服务或 Custom endpoint接入国内模型聚合平台。输入 API Key——粘贴你的 API 密钥输入时不会显示字符直接粘贴后回车即可。密钥会被保存到 /opt/data/.env 中。选择默认模型——从可用模型列表中选择一个作为默认使用模型。配置消息网关可选——如需接入飞书、Telegram 等平台可在此步骤配置。配置完成后输入 exit 退出容器终端。示例选择Quick setup— provider, model messaging选择 More providers…选择 MiniMax China (domestic direct API)MINIMAX_CN_API_KEY:粘贴您准备好的 API 密钥如无可先去MiniMax官网上注册一个。粘贴模型的 URL 地址。Select default model选择您需要调用的模型版本。选择 Skip — set up later with ‘hermes setup gateway’当系统显示 Ready to go 准备就绪时输入Y并回车即可开启命令行对话。四、接入消息平台可选Hermes Agent 支持接入飞书、Telegram、Discord、Slack、微信等多个平台。以下以接入国内常用的飞书为例。创建飞书应用登录飞书开放平台https://open.feishu.cn进入开发者后台。创建企业自建应用填写应用名称和应用描述。在“凭证与基础信息”中获取 App ID 和 App SecretSecret 只会显示一次务必保存。添加机器人能力左侧菜单 → 添加能力 → 机器人 → 添加。启用机器人设置消息模式为“私聊 群聊”。发布应用版本管理与发布 → 创建版本 → 保存 → 发布。在 Hermes Agent 中配置飞书网关有两种配置方式可选方式一使用向导配置推荐在终端对话界面中按 CtrlC 可退出对话状态在容器终端中运行hermes gateway setup在交互向导中平台列表选择 feishu国内飞书。依次粘贴 App ID 和 App Secret。Domain 直接回车默认 feishu。Connection mode 直接回车默认 websocket最稳定。选择推荐的认证方式选择群消息处理方式Allowed user IDs:保持为空直接回车按提示完成后续配置最后选择 Done 保存。方式二手动配置如果偏好手动配置可依次执行以下命令hermes configsetfeishu_app_id cli_xxxxxx hermes configsetfeishu_app_secret your_secret配置完成后重启容器dockerrestart hermes五、运行验证与基础使用验证网关状态重启后进入容器终端运行以下命令检查网关是否正常运行hermes gateway status若状态显示为 running表示网关已就绪飞书或其他消息平台中的机器人即可开始接收消息。基本使用飞书/微信对话在消息平台中向机器人发送消息Hermes Agent 会自动响应。第一次时根据提示到终端进行验证识别认证识别后即可正常使用终端交互在容器终端中直接运行 hermes进入交互式对话界面。查看配置hermes config 可查看当前所有配置项。切换模型hermes model 可在已配置的 Provider 和模型之间快速切换。查看管理面板hermes dashboard 可打开官方管理面板查看对话记录、Token 统计和技能配置等。六、安全建议Hermes Agent 可以访问本地文件、执行命令并持有 API 密钥等敏感凭据因此部署时请务必注意以下几点不要直接暴露到公网Hermes Agent 应运行在内网环境如需远程访问请通过 VPN 或绿联 NAS 的远程访问功能如UGlink。API 密钥安全密钥保存在 data/.env 中切勿分享或上传到公开位置。资源隔离教程中的配置已限制内存和 CPU 上限可根据需要进一步调整。权限控制在消息网关侧配置允许使用的用户白名单避免被未经授权的用户调用。七、常见问题Q1镜像拉取失败或速度很慢国内网络环境下可在绿联 Docker 设置中配置镜像加速器或设置 HTTP/HTTPS 代理来辅助下载。Q2容器启动后状态反复重启检查数据目录权限是否正确。可进入容器终端查看日志docker logs hermes。Q3hermes setup 向导提示找不到命令确保已正确进入容器终端docker exec -it hermes /bin/bash。如果仍然报错可能是镜像拉取不完整尝试删除容器后重新部署。Q4飞书机器人不回复消息检查网关状态hermes gateway status确认飞书 App ID 和 Secret 配置正确且应用已在飞书侧成功发布。另外确保飞书机器人的消息模式已开启“接收消息”权限。
阅读完成 · 觉得有帮助？
