Hermes Agent 教程资源汇总
调研日期 : 2026-06-28数据来源 : 多搜索引擎(Google、Bing、DuckDuckGo、百度、搜狗)、GitHub API、官方文档、社区博客GitHub 数据 : 204,515 Stars / 36,829 Forks / MIT License / Python / 创建于 2025-07-22
一、Hermes Agent 概述 Hermes Agent 是 Nous Research 开发的开源自主 AI Agent 框架,核心理念是”一个会随着使用不断成长的 Agent”。
与普通 AI 聊天工具的核心区别 :
维度
普通 AI 聊天 (如 ChatGPT)
Hermes Agent
记忆
每次对话从零开始
跨会话持久记忆,越用越懂你
执行能力
只能生成文字
可执行终端命令、操作文件、控制浏览器
运行位置
云端,数据上传服务商
本地或你的服务器,数据不离开你
扩展性
封闭生态
开放技能标准(agentskills.io)、MCP 生态
触达方式
网页
CLI + Telegram/Discord/Slack/WhatsApp 等 15+ 平台
模型绑定
固定模型
支持 300+ 模型,随时切换,不锁定
核心特性 :
连接 (Connect) : Telegram、Discord、Slack、WhatsApp、Signal、Email、CLI——一个 Agent,统一内存,所有平台
记忆 (Remember) : 自动生成技能,永久记住解决过的问题,跨会话持久化
定时 (Schedule) : 自然语言设定定时任务——日报、备份、晨间简报
委派 (Delegate) : 生成隔离子 Agent,零上下文成本的并行流水线
搜索与多模态 (Search) : 网页搜索、浏览器自动化、视觉理解、图像生成、TTS
二、官方核心资源
三、安装教程 3.1 一键安装(推荐) macOS / Linux / WSL2 / Android (Termux) curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安装完成后重载 Shell:
source ~/.bashrc source ~/.zshrc
Windows 原生 (PowerShell) irm https://res1.hermesagent.org.cn/install.ps1 | iex
或使用官方仓库地址:
irm https://raw.githubusercontent.com/NousResearch/hermes-agent /main/scripts/install.ps1 | iex
特点 :
不需要管理员权限
安装目录: %LOCALAPPDATA%\hermes\
自动将 hermes 加入 User PATH
安装完成后需打开新终端窗口
桌面版安装(macOS / Windows) 前往 https://hermes-agent.nousresearch.com/ 下载对应平台的桌面安装包,CLI 与桌面应用会同时安装。安装包仅约 7.3MB,全新环境安装约 10-15 分钟(含依赖),已有环境 1-3 分钟。
3.2 pip 安装 pip install hermes-agent pipx install hermes-agent
3.3 手动安装(从源码) git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git cd hermes-agentcurl -LsSf https://astral.sh/uv/install.sh | sh uv venv venv --python 3.11 export VIRTUAL_ENV="$(pwd) /venv" uv pip install -e ".[all]" mkdir -p ~/.hermes/{cron,sessions,logs,memories,skills,pairing,hooks,image_cache,audio_cache,whatsapp/session}cp cli-config.yaml.example ~/.hermes/config.yamltouch ~/.hermes/.envmkdir -p ~/.local/binln -sf "$(pwd) /venv/bin/hermes" ~/.local/bin/hermeshermes model hermes doctor hermes chat -q "Hello! What tools do you have available?"
可选扩展 :
扩展
功能
安装命令
all
包含以下所有功能
uv pip install -e ".[all]"
messaging
Telegram 和 Discord 网关
uv pip install -e ".[messaging]"
cron
定时任务 Cron 表达式解析
uv pip install -e ".[cron]"
voice
CLI 麦克风输入和音频播放
uv pip install -e ".[voice]"
mcp
模型上下文协议支持
uv pip install -e ".[mcp]"
honcho
AI 原生记忆(Honcho 集成)
uv pip install -e ".[honcho]"
3.4 安装器自动处理的依赖 安装程序会自动安装以下依赖,无需手动预装:
uv — 快速 Python 包管理器
Python 3.11 — 通过 uv 安装,无需 sudo
Node.js v22 — 用于浏览器自动化和 WhatsApp 桥接
ripgrep — 快速文件搜索
ffmpeg — TTS 音频格式转换
PortableGit (Windows) — 便携版 Git,约 45MB
四、配置教程 4.1 首次设置向导
向导提供三种模式:
快速设置 — 免费 OAuth 登录,无需 API 密钥 (hermes setup --portal)
完整设置 — 手动配置每个提供商、工具和选项
空白模式 — 仅最低限度配置,其余关闭
4.2 模型配置 Hermes 支持 30+ LLM 提供商,要求模型至少有 64K tokens 上下文窗口。
国内推荐 :
Kimi / Moonshot — 国内直连无需代理,中文适配好
GLM (智谱) — 设置 GLM_API_KEY
MiniMax — 国际/中国区端点可选
DeepSeek — 设置 DEEPSEEK_API_KEY
Custom Endpoint — 任何 OpenAI 兼容 API(如字节方舟 Coding Plan)
配置方式 :
hermes model hermes config set model anthropic/claude-opus-4.6 hermes config set OPENROUTER_API_KEY sk-or-... /model openrouter:nous/hermes-3-405b
配置文件位置 :
密钥和令牌 → ~/.hermes/.env (Linux/macOS) 或 %USERPROFILE%\.hermes\.env (Windows)
非密钥设置 → ~/.hermes/config.yaml 或 %USERPROFILE%\.hermes\config.yaml
4.3 主要提供商列表
提供商
说明
配置方式
Nous Portal
订阅制,零配置
OAuth 登录
OpenAI Codex
ChatGPT OAuth
设备代码认证
Anthropic
Claude 模型
OAuth 或 API 密钥
OpenRouter
多提供商路由 (200+ 模型)
API 密钥
Z.AI
GLM / 智谱托管模型
GLM_API_KEY
Kimi / Moonshot
Moonshot 托管模型
KIMI_API_KEY
Kimi China
中国区 Moonshot 端点
KIMI_CN_API_KEY
MiniMax
国际/中国区端点
MINIMAX_API_KEY / MINIMAX_CN_API_KEY
DeepSeek
直接 DeepSeek API
DEEPSEEK_API_KEY
Alibaba Cloud
Qwen 模型 (DashScope)
DASHSCOPE_API_KEY
Hugging Face
20+ 开放模型
HF_TOKEN
Google AI Studio
Gemini 模型
GOOGLE_API_KEY
xAI
Grok 模型
XAI_API_KEY
Ollama Cloud
托管 Ollama 模型
OLLAMA_API_KEY
LM Studio
本地桌面应用
LM_API_KEY
Custom Endpoint
VLLM/SGLang/Ollama 等
base URL + API 密钥
GitHub Copilot
Copilot 订阅
OAuth 或 GH_TOKEN
五、核心使用教程 5.1 基础命令 hermes hermes --tui hermes model hermes tools hermes config set hermes gateway hermes setup hermes claw migrate hermes update hermes doctor hermes doctor --fix hermes --continue hermes chat -q "问题"
5.2 对话中的斜杠命令
命令
功能
/help
显示所有可用命令
/tools
列出可用工具
/model
交互式切换模型
/skills
查看自动积累的技能
/insights --days 7
查看 Agent 周报(学到什么、哪些技能被频繁调用)
/save
保存对话
/personality pirate
尝试有趣的个性
/voice on
开启语音模式
/edit
调用外部编辑器
5.3 消息网关(多平台接入) hermes gateway setup hermes gateway hermes gateway &
支持的平台 (15+):
平台
状态
配置方式
Telegram
✅
TELEGRAM_BOT_TOKEN
Discord
✅
DISCORD_BOT_TOKEN
Slack
✅
SLACK_BOT_TOKEN + SLACK_SIGNING_SECRET
WhatsApp
✅
浏览器自动化,首次需扫码
Signal
✅
—
Matrix
✅
—
Email
✅
SMTP 配置
钉钉
✅
—
飞书
✅
—
企业微信
✅
—
Home Assistant
✅
HA_URL + HA_TOKEN
Webhooks
✅
自定义 HTTP 回调
跨平台对话连续 : 在 Telegram 聊到一半,切到 Discord 继续,上下文不丢。
5.4 定时任务(Cron) 在对话中直接用自然语言设定:
> 每天早上9点检查 Hacker News 上的 AI 新闻,并通过 Telegram 给我发送摘要 > every weekday at 7:30am, collect: (1) top 10 HN posts, (2) my unread GitHub notifications, (3) weather. Send as email to me@example.com.
5.5 从 OpenClaw 迁移 hermes claw migrate hermes claw migrate --dry-run hermes claw migrate --preset user-data
迁移内容包括: 人格文件(SOUL.md)、记忆数据(MEMORY.md/USER.md)、自建技能、命令审批白名单、各平台 API Key、TTS 语音资源、工作区指令(AGENTS.md)。迁移完成后 OpenClaw 原始数据不会被删除。
六、Skills 技能系统 6.1 技能信任层级
层级
说明
Builtin
随 Hermes 内置,不可篡改
Official
Nous 发布,经过安全审计
Trusted
验证的社区成员发布
Community
其他所有;经过安全扫描但安装前需阅读源码
6.2 技能管理命令 hermes skills browse hermes skills search telegram hermes skills info <name> hermes skills install <name>
6.3 必装技能推荐(第一天)
LLM Wiki (内置) — Karpathy 风格的精简参考
gstack (trusted) — 浏览器自动化、QA 测试、设计审查三合一
OpenAI taps (trusted) — OpenAI 函数调用原语暴露为 Hermes 工具
Manim (official) — 从文本生成数学动画
security-audit (official) — 扫描仓库常见漏洞
6.4 自进化机制
每次任务或约 5 次工具调用后,Hermes 进行自我回顾
检测到重复模式时自动生成技能文件 (~/.hermes/skills/<name>/SKILL.md)
技能是可执行程序,不是笔记——描述触发条件、运行方式、所需上下文
使用 /skills 命令查看积累的技能,/insights --days 7 查看 Agent 周报
七、记忆架构
文件
用途
容量限制
MEMORY.md
短期记忆,当前工作内容
~2,200 字符
USER.md
关于你的事实(姓名、偏好、角色)
~1,375 字符
Session search
FTS5 全文索引,所有历史对话可搜索
无限
小容量限制是有意设计——防止 Agent 变成”陈旧上下文的垃圾抽屉”,强制整合重要信息。如需无限语义记忆,可接入社区记忆提供商: Honcho、Mem0、Hindsight、Supermemory 等。
八、Windows 原生安装深度指南 8.1 能力矩阵(原生 vs WSL2)
功能
Windows 原生
WSL2
CLI (hermes chat/setup/gateway 等)
✅
✅
交互式 TUI
✅
✅
消息 Gateway (15+ 平台)
✅
✅
Cron 调度器
✅
✅
Browser tool (Node 驱动 Chromium)
✅
✅
MCP servers (stdio 和 HTTP)
✅
✅
本地 Ollama / LM Studio
✅
✅
Web Dashboard
✅
✅
Dashboard /chat 内嵌终端面板
❌ (需 POSIX PTY)
✅
登录时自启动
✅ (schtasks)
✅ (systemd)
8.2 安装器 10 步执行流程
引导 uv — Astral 的高性能 Python 管理器
通过 uv 安装 Python 3.11 — 无需预先安装 Python
安装 Node.js 22 — 优先 winget,否则解压可移植 Node tarball
安装可便携版 Git — 若 PATH 上已有 git 则复用;否则下载 PortableGit (~45MB)
克隆仓库 并创建 virtualenv
分级 uv pip install — 先 .[all],限流则逐步回退
基于 .env 自动安装消息平台 SDK — 检测各平台 Token 针对性安装
设置 HERMES_GIT_BASH_PATH 指向 bash.exe
将 bin 目录加入 User PATH
运行 hermes setup — 首次运行向导
8.3 安装器选项 & ([scriptblock ]::Create((irm https://raw.githubusercontent.com/NousResearch/hermes-agent /main/scripts/install.ps1))) -NoVenv -SkipSetup -Branch main
参数
默认值
用途
-Branch
main
克隆指定分支
-NoVenv
关闭
跳过 venv 创建
-SkipSetup
关闭
跳过安装后的 hermes setup 向导
-HermesHome
%LOCALAPPDATA%\hermes
覆盖数据目录
-InstallDir
%LOCALAPPDATA%\hermes\hermes-agent
覆盖代码目录
8.4 Windows 专属环境变量
变量
作用
HERMES_GIT_BASH_PATH
覆盖 bash.exe 的解析路径
HERMES_DISABLE_WINDOWS_UTF8
设为 1 禁用 UTF-8 stdio 垫片
EDITOR / VISUAL
编辑器(默认 notepad)
8.5 Gateway 自启动管理 hermes gateway install hermes gateway status hermes gateway start hermes gateway stop hermes gateway restart hermes gateway uninstall
8.6 数据目录布局
路径
内容
%LOCALAPPDATA%\hermes\hermes-agent\
Git 检出 + venv(可删除重装)
%LOCALAPPDATA%\hermes\git\
PortableGit
%LOCALAPPDATA%\hermes\node\
可移植 Node.js
%LOCALAPPDATA%\hermes\bin\
hermes.cmd 垫片(已加入 User PATH)
%USERPROFILE%\.hermes\
配置、auth、skills、会话、日志(重装不会动)
8.7 卸载 hermes uninstall hermes uninstall Remove-Item -Recurse -Force "$env:USERPROFILE \.hermes" Remove-Item -Recurse -Force "$env:LOCALAPPDATA \hermes"
九、模型选择建议 ⚠️ 首要误区 不要使用小型或老旧模型! Gemma 2B、Llama 3.1 8B 等次前沿模型无法可靠调用工具,会导致循环或垃圾输出。社区共识: 第一天用前沿模型,本地模型仅用于实验。
模型对比
模型
价格
工具调用
速度
最适合
Claude Sonnet / Opus
$$$
优秀
快
生产级代理工作流
GPT-5
$$$
优秀
快
生产环境
GLM-5 (智谱)
$
优秀
快
最佳性价比前沿模型
MiniMax M2.7
$$
优秀
快
高性价比
DeepSeek
$
良好
快
成本优化
Nous Portal (订阅)
$ 固定
优秀
快
可预测月费
Ollama + Qwen 2.5 Coder
免费
良好
取决于 GPU
离线编码
Ollama + Gemma/Llama 8B
免费
差
—
仅聊天,不适用于代理工作
十、常见问题速查
问题
原因
解决方案
hermes: command not found
PATH 未更新
打开新终端或 source ~/.bashrc
API 密钥未设置
未配置提供商
hermes model 配置或 hermes config set
更新后配置丢失
配置格式变更
hermes config check → hermes config migrate
Windows: “bad interpreter”
原生 Windows 兼容问题
安装 WSL2 (wsl --install)
WinError 193
绕过了 .cmd 垫片
改用 .cmd 变体 (如 npx.cmd)
重启后 Gateway 跑不起来
组策略禁用 ONLOGON
查看 hermes gateway status,用 HERMES_GATEWAY_FORCE_STARTUP=1 重装
Browser tool 超时
Chromium 安装失败
运行 hermes doctor,执行 npx playwright install chromium
中文等字符显示成 ?
UTF-8 垫片未生效
检查 HERMES_DISABLE_WINDOWS_UTF8 未被设置,切到 Windows Terminal
编辑器 /edit 无反应
$env:EDITOR 只设到当前进程
在系统属性→环境变量中设为 User scope
自定义端点返回垃圾内容
错误的 base URL 或模型名称
先在单独的客户端验证端点
模型不可用或回退异常
提供商路由设置过于激进
基础提供商稳定前保持路由关闭
恢复工具包(问题排查顺序)
hermes doctor — 诊断问题(80% 的问题能直接给出答案)
hermes model — 检查/切换模型
hermes setup — 重新运行设置向导
hermes sessions list — 列出会话
hermes --continue — 恢复会话
hermes gateway status — 检查网关状态
十一、社区教程与文章索引 中文深度教程
英文教程
官方文档
十二、GitHub 生态数据 (截至 2026-06-28)
Topics : ai, ai-agent, ai-agents, anthropic, chatgpt, claude, claude-code, clawdbot, codex, hermes, hermes-agent, llm, moltbot, nous-research, openai, openclaw
十三、实用工作流示例 示例 1: 本地编码助手 cd ~/projects/my-repohermes > audit this repo for dead code, imports that aren't used, and commented-out blocks older than 6 months. Produce a markdown report.
Hermes 读取文件、运行 grep,将报告写入 ./hermes-output/。第二次询问同类问题时会更快——因为它在第一次运行时已创建 repo-audit 技能。
示例 2: $5 VPS 上的 Telegram 机器人 curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash hermes gateway setup hermes daemon start
添加定时任务:
> every morning at 8am, summarize my GitHub notifications and send them to me here
示例 3: 每日 Cron 简报 hermes > every weekday at 7:30am, collect: (1) top 10 HN posts overnight, (2) my unread GitHub notifications, (3) weather in Beijing. Send as a plain-text email to me@example.com.
示例 4: Docker 沙盒终端 hermes config set terminal.backend docker hermes config set terminal.backend ssh
示例 5: 语音模式 cd ~/.hermes/hermes-agentuv pip install -e ".[voice]"
示例 6: MCP 服务器集成 在 ~/.hermes/config.yaml 中添加:
mcp_servers: github: command: npx args: ["-y" , "@modelcontextprotocol/server-github" ] env: GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"
十四、关键洞察
模型无关是最大的保险 — Hermes 不绑定任何模型,技能和记忆不受模型切换影响
跨平台上下文不丢 — 客户从任何渠道联系,AI 都知道之前聊了什么
有界记忆是特性 — 小容量限制强制信息整合,保持工作上下文紧凑
技能 ≠ 笔记 — 技能是可执行程序,描述完整工作流程,可直接复用
第一天用前沿模型 — 这是避免”首周末陷阱”的最重要建议
30 天复合效应 — 从通用助手变成专属助手,技能目录从空到 20+
/insights 让 AI 第一次有了周报 — AI 员工的”绩效考核”第一次成为可能
OpenClaw 一键迁移 — hermes claw migrate,同一个团队的正式继任者
本文档基于多搜索引擎、GitHub API、官方文档和社区博客综合整理。GitHub 数据采集时间: 2026-06-28。
refer
-
声明:
若文章存在错误,望诸君不吝指正^
blog仅供个人记录学习所用
部分笔记由于年代久远,做的笔记找不到最初是引用谁的,若是不允许引用转载,请联系我