乐于分享
好东西不私藏

从零搭建自进化AI助手:Hermes Agent完整安装指南

从零搭建自进化AI助手:Hermes Agent完整安装指南

AI AGENT 教程

从零搭建自进化AI助手:Hermes Agent完整安装指南

GitHub 50万星、一条命令装好,附DeepSeek国产模型接入教程

2026年4月11日 · 灵境未来 · 灵汐

💬 灵 汐 说

GitHub 50万星、两个月登顶全球第一的开源 AI Agent 到底怎么装?今天手把手教你,从打开终端到跑起来,每一步都讲清楚。接入国产模型 DeepSeek 也一起讲。

01

Hermes Agent 是什么?

Hermes Agent 是 Nous Research(做 Hermes 系列开源大模型的团队)2026年2月发布的开源 AI Agent 框架,MIT 许可证,完全免费。

它的核心卖点就一个词:自进化。跟 OpenClaw 走”多智能体协同”路线不同,Hermes 走的是单体自进化路线——用得越多越聪明:解决难题后自动生成技能文件(SKILL.md),四层记忆系统跨会话保留上下文,不需要手动调教。

截止 2026 年 4 月 10 日,GitHub Star 数已达 50.1k,是全球增长最快的 AI Agent 开源项目。

▲ Hermes Agent 核心能力一览

它能同时接入 Discord、Slack、WhatsApp、飞书、企业微信等 15+ 消息平台,兼容 200+ AI 模型(OpenAI、Anthropic、Google、DeepSeek、通义千问……),内置自动技能创建系统,还支持语音对话和浏览器自动化扩展。一句话总结:装一个 Hermes = 全能 AI 助手 + 全平台消息机器人 + 自动学习系统。

02

安装前准备

系统要求:

✅ Linux(推荐 Ubuntu 22.04)✅ macOS Intel/Apple Silicon✅ WSL2 Windows 子系统❌ Windows 原生(不支持)

     Windows 用户需要另外安装 WSL2,Windows Subsystem for Linux,简称 WSL

前置依赖:好消息——你只需要手动准备 Git。其余所有依赖(Python、Node.js、ripgrep、ffmpeg)都由一键脚本自动处理。

Ubuntu / Debian

sudo apt install git -y

macOS

brew install git

03

三种安装方式

💡 推荐

新手直接用方式一,一条命令 2 分钟搞定。想了解细节或排障用方式二。服务器部署用方式三 Docker。

方式一:一键安装(推荐 ⭐)

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

这条命令自动完成 7 件事:安装 Python 3.11 + uv → Node.js v22 → ripgrep + ffmpeg → 克隆代码仓库 → 创建虚拟环境 → 设置全局 hermes 命令 → 启动配置向导。

⚠️ 安装后必须刷新 Shell 环境:

source ~/.zshrc   # zsh 用户(macOS 默认)source ~/.bashrc   # bash 用户

验证安装:

hermes doctor

全部绿色 ✅ = 成功;红色 ❌ = 它会告诉你缺什么以及怎么修。

▲ 三种安装方式对比流程

方式二:手动安装(适合了解细节的人)

第1步克隆仓库(注意 –recurse-submodules 不能少)git clone –recurse-submodules https://github.com/NousResearch/hermes-agent.git && cd hermes-agent

第2步创建虚拟环境uv venv .venv –python 3.11 && source .venv/bin/activate

第3步安装依赖pip install -e .

第4步建配置目录mkdir -p ~/.hermes/{skills,memory,personas,logs} && touch ~/.hermes/.env

第5步复制模板 + 设置全局命令cp config.example.yaml ~/.hermes/config.yamlsudo ln -sf “$(pwd)/.venv/bin/hermes” /usr/local/bin/hermes

第6步初始化 + 验证hermes setup && hermes doctor

方式三:Docker 部署(适合服务器环境)

docker pull nousresearch/hermes-agent:latestdocker run -it -v ~/.hermes:/root/.hermes \  -e OPENAI_API_KEY=your_key \  nousresearch/hermes-agent:latest

04

接入 API Key:给 Hermes 接上大脑

装好之后还是个空壳,得接上 AI 模型才能思考。三种配置方法:

方法一:交互式(新手推荐)

hermes model

方法二:编辑配置文件(开发者推荐)

vim ~/.hermes/config.yaml

方法三:环境变量(最灵活)

vim ~/.hermes/.env

▲ 支持的模型提供商及特点

🔑 DeepSeek 接入(国产性价比首选)

运行 hermes model → 选「More providers」→「Custom endpoint」→ 填入:• Base URL:https://api.deepseek.com/v1• Model:deepseek-chat• API Key 去 platform.deepseek.com 注册获取

其他主流提供商一览:OpenAI(GPT-4o/o3 综合强)、Anthropic(Claude 长文本推理好)、Google(Gemini 多模态)、OpenRouter(一个 key 访问 200+ 模型且有免费额度)。国产模型通义千问、百度文心等通过自定义端点也能接入。

05

常用命令速查

装好配好之后,这些是你最常用的命令:

hermes    启动交互式对话hermes doctor  健康检查(排障首选)hermes model  切换/添加模型提供商hermes tools  管理工具插件开关hermes gateway setup  配置消息平台hermes config check  检查配置完整性hermes skill list  查看已学会的技能

06

接入消息平台:变团队助手

▲ 全平台消息网关支持

这是 Hermes 最实用的功能之一。运行以下命令即可开始:

hermes gateway setup

飞书接入步骤:去飞书开放平台创建企业自建应用 → 拿到 App ID 和 App Secret → 填入 Hermes 配置 → 测试发消息。

Telegram 更简单:找 @BotFather 创建机器人 → 拿 Bot Token → 填入即可。

原生支持的平台还有 Discord、Slack、WhatsApp、Signal、企业微信、微博。流程统一:拿凭证 → 填配置 → 测试连接。

07

可选功能扩展

基础版只包含核心功能。按需加装能力包:

voice  语音输入输出(Whisper + TTS)messaging  15+ 平台消息网关tts-premium  ElevenLabs/Azure 高品质语音browser  Playwright 浏览器自动化image  Stable Diffusion / DALL-E 生图vector  ChromaDB/Qdrant 向量存储all  一键全装

08

常见问题排查

Q:hermes: command not found?

source ~/.zshrc 或 source ~/.bashrc

还不行就重新跑一遍安装脚本。

Q:Python 版本不对?

uv python install 3.11uv venv .venv –python 3.11source .venv/bin/activate

Q:子模块缺失?

cd hermes-agent && git submodule update –init –recursive

Q:遇到未知问题?

hermes doctor   ← 终极诊断命令,自带”体检报告”

— END —

Hermes Agent 的安装本身不复杂,一条命令就能搞定。真正有价值的是装好之后——选对模型、接入平台、让它在实际工作中不断学习和积累技能。第一次接触 AI Agent 的话,建议先用 OpenRouter 免费模型跑起来体验,确认适合自己的场景后再考虑部署到服务器长期使用。

灵境未来

✦ 点击关注,一起探索 AI 无界

AI 赋能内容,灵境创造未来

AI短剧 × 智能体 × 数字人IP

📚 参考资料

· Hermes Agent GitHub 官方仓库· Hermes Agent 中文文档·安装篇· Hermes Agent 安装保姆级教程 – Kelen· Hermes Agent 完整安装指南 – PHP中文网· Windows 安装 + 飞书接入 – 腾讯云开发者社区