Hermes‑Agent 完整搭建保姆级教程
Hermes‑Agent 是 NousResearch 开源、自带长期记忆、技能工作流、多平台网关的 AI 智能体，支持 Windows / Linux / MacOS / Docker / 云服务器部署，下面分系统安装、初始化配置、模型接入、网关对接、本地 Ollama、手动源码部署、常见报错全套流程。
一、前置须知
本质只是智能体框架，必须配置大模型 API‑Key（DeepSeek、OpenRouter、通义千问、Ollama 本地模型均可）
最低硬件：内存 ≥2G，推荐 4G 以上
环境依赖：脚本会自动安装 uv、Python3.11、Node22、ffmpeg、ripgrep，无需手动预装
二、一键安装（推荐）
1）Linux /macOS/ WSL2（Ubuntu 子系统）
打开终端执行一键脚本（国内镜像源）
curl-fsSLhttps://res1.hermesagent.org.cn/install.sh|bash官方原版海外命令：
curl-fsSLhttps://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh|bash安装完成后重启终端，输入下面命令检测是否安装成功
hermes--version2）Windows 原生 PowerShell 安装（无需 WSL）
右键开始菜单，打开PowerShell (管理员)
执行安装脚本
irmhttps://res1.hermesagent.org.cn/install.ps1|iex- 安装结束关闭旧窗口，新开 PowerShell 校验
hermes--version安装目录：
%LOCALAPPDATA%\hermes\hermes‑agent
3）Docker 容器部署（服务器首选）
- 先装好 Docker+Docker‑Compose
curl-fsSLhttps://get.docker.com|shsudousermod-aGdocker$USERnewgrpdocker- 创建部署文件夹、编写
docker‑compose.yml
mkdir~/hermes-agent&&cd~/hermes-agentnanodocker-compose.ymlversion:'3.8'services:hermes-agent:image:hermesagent/hermes:latestcontainer_name:hermes-agentrestart:unless-stoppedports:-"8080:8080"environment:-LLM_PROVIDER=openrouter-LLM_API_KEY=你的APIKEYvolumes:-./data:/root/.hermes- 启动容器
dockercompose up-d三、初始化配置核心流程
1、启动交互式配置向导
hermes setup三种初始化模式：
Quick Setup：登录 Nous 官方门户Blank Slate空白模式（最推荐，自定义第三方模型）Full setup完整逐项配置所有工具、插件
2、配置大模型接口
- 执行模型配置命令
hermes model选择模型服务商：OpenRouter / DeepSeek / 通义千问 / 自定义接口 / Ollama 本地
填入 API‑Key、接口地址、模型名称
👉 接入本地 Ollama 模型
- 本机装好 Ollama，拉取模型（示例 qwen3）
ollama pull qwen3- hermes‑agent 模型列表选择
Custom endpoint
接口地址填写：http://127.0.0.1:11434/v1
模型名：ollama/qwen3
3、启动交互式 CLI 对话
hermes现在即可开启带长期记忆、工具调用的 AI 智能体对话。
四、配置消息网关（对接 TG / 飞书 / 微信 / Discord 机器人）
网关可以让你在聊天软件远程操控 Hermes‑Agent
示例 Telegram‑Bot 部署
- Telegram 找到
@BotFather
发送
/newbot设置机器人名称、用户名（必须
_bot结尾）获取机器人 Token；
/setprivacy→ Disable 关闭隐私，允许读取群聊消息
- 终端运行网关配置
hermes gateway setup平台选择
Telegram，粘贴 Bot‑Token，设置允许访问的用户 ID启动网关后台服务
# 前台运行hermes gateway# 安装系统后台服务（Linux）hermes gatewayinstall# 启动服务systemctl start hermes-gateway五、源码手动编译安装（开发者模式）
# 克隆仓库gitclone --recurse-submodules https://github.com/NousResearch/hermes-agent.gitcdhermes-agent# 安装uv包管理器curl-LsSfhttps://astral.sh/uv/install.sh|sh# 创建虚拟环境、安装依赖uv venv .venvsource.venv/bin/activate uv pipinstall-e.六、常用基础命令汇总
hermes setup# 初始化配置向导hermes model# 切换/配置大模型hermes# 进入交互式终端对话hermes gateway setup# 聊天机器人网关配置hermes update# 一键升级最新版本hermes reset# 重置所有配置、记忆数据七、常见报错 & 解决方案
- hermes 命令找不到
安装结束后重启终端；Windows 检查环境变量是否刷新
- WSL 网络无法拉取安装脚本
使用国内镜像安装脚本；WSL2 配置代理
- 调用模型报错 401
API‑Key 错误、余额不足、接口地址填写错误
- Windows 缺少 ffmpeg、ripgrep
新版安装脚本会自动下载；旧版手动下载工具放到程序目录
- 服务器部署内存溢出
关闭其他进程，保证 ≥2G 空闲内存
八、进阶功能
记忆系统：自动保存对话记忆、长期偏好，跨会话读取
Skill 技能：重复执行的复杂任务可保存成自定义工作流
支持工具调用：Shell 命令、文件读写、浏览器自动化、定时任务、API 请求
那么，我们如何学习AI大模型呢？
这份精心整理的AI大模型学习资料，我整理好了，免费分享！只希望它能用在正道上，帮助真正想提升自己的朋友。让我们一起用技术做点酷事！
ps:微信扫描即可获取
加上后我将逐一发送资料
与志同道合者共勉
真诚无偿分享！！！
适学人群
我们的课程体系专为以下三类人群精心设计：
- AI领域起航的应届毕业生：提供系统化的学习路径与丰富的实战项目，助你从零开始，牢牢掌握大模型核心技术，为职业生涯奠定坚实基础。
- 跨界转型的零基础人群：聚焦于AI应用场景，通过低代码工具让你轻松实现“AI+行业”的融合创新，无需深奥的编程基础也能拥抱AI时代。
- 寻求突破瓶颈的传统开发者（如Java/前端等）：将带你深入Transformer架构与LangChain框架，助你成功转型为备受市场青睐的AI全栈工程师，实现职业价值的跃升。
※大模型全套学习资料展示
通过与MoPaaS魔泊云的强强联合，我们的课程实现了质的飞跃。我们持续优化课程架构，并新增了多项贴合产业需求的前沿技术实践，确保你能获得更系统、更实战、更落地的大模型工程化能力，从容应对真实业务挑战。资料内容涵盖了从入门到进阶的各类视频教程和实战项目，无论你是小白还是有些技术基础的技术人员，这份资料都绝对能帮助你提升薪资待遇，转行大模型岗位。
01 大模型系统化学习路线
作为学习AI大模型技术的新手，方向至关重要。 正确的学习路线可以为你节省时间，少走弯路；方向不对，努力白费。希望这份最科学最系统的学习成长路线图和学习规划，带你从零基础入门到精通！
👇微信扫描下方二维码即可~
本教程比较珍贵，仅限大家自行学习，不要传播！更严禁商用！
02 大模型学习书籍&文档
新手必备的权威大模型学习PDF书单来了！全是一系列由领域内的顶尖专家撰写的大模型技术的书籍和学习文档（电子版），从基础理论到实战应用，硬核到不行！
※（真免费，真有用，错过这次拍大腿！）
03 AI大模型最新行业报告
2025最新行业报告，针对不同行业的现状、趋势、问题、机会等进行系统地调研和评估，以了解哪些行业更适合引入大模型的技术和应用，以及在哪些方面可以发挥大模型的优势。
04 大模型项目实战&配套源码
学以致用，在项目实战中检验和巩固你所学到的知识，同时为你找工作就业和职业发展打下坚实的基础。
05 大模型大厂面试真题
面试不仅是技术的较量，更需要充分的准备。在你已经掌握了大模型技术之后，就需要开始准备面试，我精心整理了一份大模型面试题库，涵盖当前面试中可能遇到的各种技术问题，让你在面试中游刃有余。
06 全套AI大模型应用开发视频教程
（包含提示工程、RAG、LangChain、Agent、模型微调与部署、DeepSeek等技术点）
由于篇幅有限
只展示部分资料
并且还在持续更新中…
ps:微信扫描即可获取
加上后我将逐一发送资料
与志同道合者共勉
真诚无偿分享！！！
最后，祝大家学习顺利，抓住机遇，共创美好未来！
