从零搭建自进化AI助手:Hermes Agent完整安装指南
从零搭建自进化AI助手:Hermes Agent完整安装指南
GitHub 50万星、一条命令装好,附DeepSeek国产模型接入教程
2026年4月11日 · 灵境未来 · 灵汐
💬 灵 汐 说
GitHub 50万星、两个月登顶全球第一的开源 AI Agent 到底怎么装?今天手把手教你,从打开终端到跑起来,每一步都讲清楚。接入国产模型 DeepSeek 也一起讲。
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 助手 + 全平台消息机器人 + 自动学习系统。
安装前准备
系统要求:
✅ 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
三种安装方式
💡 推荐
新手直接用方式一,一条命令 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
接入 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+ 模型且有免费额度)。国产模型通义千问、百度文心等通过自定义端点也能接入。
常用命令速查
装好配好之后,这些是你最常用的命令:
hermes 启动交互式对话hermes doctor 健康检查(排障首选)hermes model 切换/添加模型提供商hermes tools 管理工具插件开关hermes gateway setup 配置消息平台hermes config check 检查配置完整性hermes skill list 查看已学会的技能
接入消息平台:变团队助手
▲ 全平台消息网关支持
这是 Hermes 最实用的功能之一。运行以下命令即可开始:
hermes gateway setup
飞书接入步骤:去飞书开放平台创建企业自建应用 → 拿到 App ID 和 App Secret → 填入 Hermes 配置 → 测试发消息。
Telegram 更简单:找 @BotFather 创建机器人 → 拿 Bot Token → 填入即可。
原生支持的平台还有 Discord、Slack、WhatsApp、Signal、企业微信、微博。流程统一:拿凭证 → 填配置 → 测试连接。
可选功能扩展
基础版只包含核心功能。按需加装能力包:
voice 语音输入输出(Whisper + TTS)messaging 15+ 平台消息网关tts-premium ElevenLabs/Azure 高品质语音browser Playwright 浏览器自动化image Stable Diffusion / DALL-E 生图vector ChromaDB/Qdrant 向量存储all 一键全装
常见问题排查
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 安装 + 飞书接入 – 腾讯云开发者社区
夜雨聆风