Hermes Agent 是 Nous Research 开源的自主 AI Agent 框架。
- GitHub 仓库:github.com/nousresearc…
- Hermes Agent 官网:hermes-agent.nousresearch.com/
官方定义非常直接:
The agent that grows with you. 一个会随着使用不断成长的 Agent。它是一个自主智能体,运行时间越长,能力就越强。
💡 它能解决什么问题?
你有没有过这种感觉——跟 AI 对话就像和金鱼聊天?每次新会话,AI 就忘了上次讨论的所有细节;每次遇到类似问题,都要重新解释背景;AI 明明帮你解决过一个问题,下次又用同样的笨方法。
这不是你的问题,是大多数 AI 工具的通病:没有记忆,不会成长。
Hermes Agent 正是为了解决这个痛点而生。它不是另一个「套壳聊天机器人」,而是一个真正能记住你、学会你的偏好、越用越懂你的 AI 伙伴。
🚀 核心亮点
-
🧠
三层记忆系统
会话记忆 → 短期记忆 → 长期记忆 → 技能记忆。跨对话保持上下文,用户偏好和项目信息永不丢失。
-
🔄
自进化闭环
完成任务 → 自动提取经验 → 创建 Skill → 存入知识库 → 下次复用并优化。AI 会从成功的工作流中「长出」自己的技能。
-
🔌
639+ 内置技能
开箱即用的技能库,覆盖代码审查、调试、重构、系统设计等常见场景。支持 agentskills.io 标准,技能可共享、可复用。
-
🌐
多 LLM 一键切换
支持 OpenAI、Claude、Nous Portal、OpenRouter(200+模型)、Kimi、MiniMax 等,一行命令切换底层模型,无厂商锁定。
-
📱
全平台接入
CLI 终端、Telegram、Discord、Slack……一个网关,多端同步。放在 $5 VPS 上就能跑,空闲时几乎零成本。
💻 实战场景展示
假设你需要在一个新项目中实现用户认证功能:
# 1. 告诉 Hermes 你的项目背景
> 我在做一个 React + Node.js 的 SaaS 项目,需要加用户认证
# 2. Hermes 记住了!(长期记忆)
> 好的,我看到你的项目结构是 Next.js + Prisma + PostgreSQL
> 建议使用 NextAuth.js 方案,要我现在创建相关文件吗?
# 3. 完成后,Hermes 自动总结经验
> 已将 JWT + OAuth 双因素认证方案保存为 Skill: saas-auth-pattern
> 下次遇到类似需求可直接调用
# 4. 下次项目中直接复用
> 在另一个项目使用相同 Skill
> Hermes: 检测到已有认证方案经验,是否应用 saas-auth-pattern?
> ✓ 自动适配新项目结构
📖 上手指南
只需一行命令即可安装(需要 Python 3.10+):
1 安装 Hermes Agent
curl -L https://hermes-agent.org/install.sh | sh
2 配置 API Key
hermes config
# 按提示输入 OpenAI / Claude / Nous Portal 等 API Key
3 启动并对话
hermes run
Hermes Agent 的核心理念是:让 AI 成为长期在线的数字员工,而非一次性聊天机器人。
Hermes Agent不是一个“一问一答”的聊天机器人,而是一个能长期运行、自我进化、主动干活的AI智能体。它的核心能力包括:
| 能力 | 说明 | 一句话示例 |
|---|---|---|
| 自然语言操控电脑 | 用中文指令完成文件操作、代码编辑 | “帮我把桌面所有Excel合并成一个” |
| 持久化记忆 | 跨会话记住你的偏好和项目信息 | 几周后还记得你的工作目录 |
| 自我进化技能 | 完成任务后自动提炼经验为Skill | 下次同类任务直接调用,不用重来 |
| 定时自动化 | 用自然语言设置定时任务 | “每天早上8点把新闻发我微信” |
| 多平台接入 | 微信/飞书/钉钉/Telegram远程控制 | 手机上指挥电脑干活 |
| 子Agent委派 | 同时启动多个AI并行处理 | 三个任务10分钟全搞定 |
| 浏览器自动化 | 像人一样操作网页 | 自动填表单、抓数据、截图 |
终端命令大全
1.1 基础命令
| 命令 | 说明 | 示例 |
|---|---|---|
hermes | 启动交互式对话 | 直接输入即可 |
hermes --continue | 恢复上一次会话 | 继续昨天的项目讨论 |
hermes --version | 查看版本 | 确认安装成功 |
hermes doctor | 诊断系统问题 | 排查环境问题 |
1.2 配置命令
| 命令 | 说明 | 示例 |
|---|---|---|
hermes setup | 完整配置向导 | 首次配置推荐使用 |
hermes model | 配置/切换大模型 | 在交互菜单中选择 |
hermes tools | 配置工具权限 | 启用/禁用工具集 |
hermes config edit | 编辑配置文件 | 手动修改YAML配置 |
hermes config list | 查看当前配置 | 确认配置生效 |
1.3 网关命令
| 命令 | 说明 | 示例 |
|---|---|---|
hermes gateway setup | 配置消息平台 | 接入微信/飞书/Telegram |
hermes gateway start | 启动网关服务 | 后台运行 |
hermes gateway status | 查看网关状态 | 检查连接 |
1.4 定时任务命令
| 命令 | 说明 | 示例 |
|---|---|---|
/cron add | 添加定时任务 | /cron add "每天早上8点" "推送新闻" |
/cron list | 查看所有任务 | 列出已配置的定时任务 |
/cron remove | 删除任务 | /cron remove 1 |
1.5 记忆与技能命令
| 命令 | 说明 | 示例 |
|---|---|---|
/model | 切换模型 | 在对话中直接切换 |
/compress | 压缩会话历史 | 节省token |
/usage | 查看消耗 | 监控API费用 |
对话指令实战技巧
2.1 如何写一个高质量Prompt
给Hermes下指令时,建议遵循以下公式:
[操作对象] + [具体动作] + [输出格式] + [边界条件]
错误示例:
“帮我整理文件”
正确示例:
“帮我把桌面‘下载’文件夹中所有Word文档,按修改日期倒序排列,移动到‘待处理_日期’文件夹。操作前先问我确认。”
Hermes Agent 是业内少见的原生内置学习闭环的 AI Agent,可从执行经验中沉淀技能、自主优化能力、持久化知识、检索历史对话,并在跨会话中持续完善用户认知模型。
Hermes Agent 支持自由切换任意大模型,包括 Nous Portal、OpenRouter(200+ 模型)、OpenAI、GLM、Kimi、MiniMax 等,执行 hermes model 即可切换,无需改代码、无厂商锁定。
| 提供商 | 说明 | 设置方式 |
|---|---|---|
| Nous Portal | 订阅制,零配置 | 通过 hermes model 进行 OAuth 登录 |
| OpenAI Codex | ChatGPT OAuth,使用 Codex 模型 | 通过 hermes model 进行设备代码认证 |
| Anthropic | 直接使用 Claude 模型 | 通过 Claude Code 认证或 Anthropic API 密钥 |
| OpenRouter | 多提供商路由 | 输入您的 API 密钥 |
| DeepSeek | 直接 DeepSeek API 访问 | 设置 DEEPSEEK_API_KEY |
| Hugging Face | 通过统一路由器访问 20+ 开放模型 | 设置 HF_TOKEN |
| 自定义端点 | VLLM、SGLang、Ollama 或任何 OpenAI 兼容 API | 设置基础 URL 和 API 密钥 |
当然买 Coding Plan 还是最划算的,毕竟包月:
| 特性 | 能力说明 |
|---|---|
| 原生终端交互 | 完整 TUI 界面,支持多行编辑、命令补全、历史回溯、流式输出等 |
| 全平台接入 | 一个网关接入 CLI、Telegram、Discord、Slack、WhatsApp 等多端 |
| 闭环学习体系 | 自主管理记忆、技能生成与优化、跨会话召回、用户建模 |
| 定时自动化 | 内置 Cron 调度,支持日报、备份、审计等 7×24 自动任务 |
| 并行任务处理 | 支持子 Agent 并行执行、多工作流拆分与 RPC 工具调用 |
| 多环境运行 | 支持本地、Docker、SSH、Daytona、Modal 等 6 种后端 |
| 科研级能力 | 支持轨迹生成、强化学习环境、训练数据压缩 |
故障排除
| 问题 | 解决方案 |
|---|---|
hermes: command not found | 重新加载 shell(source ~/.bashrc)或检查 PATH |
| API 密钥未设置 | 运行 hermes model 配置提供商,或 hermes config set OPENROUTER_API_KEY your_key |
| 更新后配置丢失 | 运行 hermes config check 然后 hermes config migrate |
如需更多诊断信息,运行 hermes doctor — 它会告诉您缺少什么以及如何修复。
**提示:**您可以随时通过
hermes model切换提供商——无需更改代码,没有锁定。
消息网关
Hermes Agent 消息网关允许您通过多个平台与智能体交互——Telegram、Discord、Slack、WhatsApp、Signal、Email、Home Assistant 等。
从一个网关向 15+ 个平台发送消息。无论您身在何处,都可以与 Hermes 保持联系。
支持的平台
| 平台 | 说明 | 状态 |
|---|---|---|
| Telegram | 最完整的消息平台集成 | ✅ 支持 |
| Discord | 支持服务器和语音频道 | ✅ 支持 |
| Slack | 工作区集成 | ✅ 支持 |
| 通过 WhatsApp Web | ✅ 支持 | |
| Signal | 隐私消息应用 | ✅ 支持 |
| Matrix | 去中心化通信 | ✅ 支持 |
| Mattermost | 自托管消息 | ✅ 支持 |
| SMTP 邮件 | ✅ 支持 | |
| SMS | 短信发送 | ✅ 支持 |
| DingTalk | 钉钉 | ✅ 支持 |
| Feishu | 飞书 | ✅ 支持 |
| WeCom | 企业微信 | ✅ 支持 |
| BlueBubbles | macOS iMessage | ✅ 支持 |
| Home Assistant | 智能家居 | ✅ 支持 |
| Webhooks | 自定义 HTTP 回调 | ✅ 支持 |
设置消息平台
交互式设置:
hermes gateway setup
这将启动交互式配置向导,引导您完成每个平台的设置。
手动配置:
或直接编辑 ~/.hermes/config.yaml:
Telegram:
# 在 ~/.hermes/.env 中
TELEGRAM_BOT_TOKEN=your-bot-token
# config.yaml
gateway:
adapters:
telegram:
enabled: true
Discord:
# 在 ~/.hermes/.env 中
DISCORD_BOT_TOKEN=your-discord-token
# config.yaml
gateway:
adapters:
discord:
enabled: true
allowed_channels:
- "123456789"
Slack:
# 在 ~/.hermes/.env 中
SLACK_BOT_TOKEN=xoxb-your-token
SLACK_SIGNING_SECRET=your-signing-secret
# config.yaml
gateway:
adapters:
slack:
enabled: true
WhatsApp:
# WhatsApp 需要浏览器自动化
# 首次设置需要扫描二维码
# config.yaml
gateway:
adapters:
whatsapp:
enabled: true
session_dir: ~/.hermes/whatsapp/session
Email (SMTP):
# 在 ~/.hermes/.env 中
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USERNAME=your-email@gmail.com
SMTP_PASSWORD=your-app-password
# config.yaml
gateway:
adapters:
email:
enabled: true
from_email: your-email@gmail.com
Home Assistant:
# 在 ~/.hermes/.env 中
HA_URL=http://homeassistant.local:8123
HA_TOKEN=your-long-lived-access-token
# config.yaml
gateway:
adapters:
homeassistant:
enabled: true
启动网关
前台运行:
hermes gateway
后台运行(推荐):
hermes gateway &
# 或使用 systemd
systemctl enable hermes-agent
systemctl start hermes-agent
Docker 运行:
docker run -d \
--name hermes-gateway \
-v ~/.hermes:/home/hermes/.hermes \
ghcr.io/nousresearch/hermes-agent:latest \
hermes gateway
平台特定配置
Telegram:
- 通过 @BotFather 创建新机器人
- 获取 bot token
- 配置并运行 Hermes
- 在 Telegram 中向您的机器人发送
/start
Discord:
- 在 Discord 开发者门户创建应用
- 添加机器人到服务器
- 获取 bot token
- 配置并运行 Hermes
Slack:
- 在 Slack 应用门户创建新应用
- 添加 bot token 作用域
- 安装到工作区
- 配置并运行 Hermes
发送消息:
使用 send_message 工具通过任何配置的通道发送消息:
send_message(
platform="telegram",
chat_id="123456789",
message="Hello from Hermes!"
)
或通过 cron 安排自动化消息:
# 设置每日简报
hermes
❯ 每天早上9点检查 Hacker News 上的 AI 新闻,并通过 Telegram 给我发送摘要
语音支持
某些平台支持语音交互:
- Telegram:语音消息和语音通话
- Discord:语音频道和语音消息
- CLI:麦克风输入和 TTS
有关语音模式的详细信息,请参阅语音模式指南。
安全考虑
重要:
- 不要将 API 密钥提交到源代码控制
- 使用环境变量或安全的凭据存储
- 限制允许与智能体交互的用户/频道
- 定期轮换 API 密钥
- 在公共平台上启用命令审批
故障排除
| 问题 | 解决方案 |
|---|---|
| 机器人无响应 | 检查网关是否正在运行 |
| 权限错误 | 验证 bot token 和权限 |
| 消息未发送 | 检查通道 ID 和配置 |
| 连接超时 | 检查网络和防火墙设置 |
**提示:**使用
hermes gateway --verbose查看详细日志以调试问题。