Linux/Mac Hermes Agent部署教程

Hermes Agent是什么
Hermes Agent:终端中的开源 AI 代理框架
简介
Hermes Agent 是由 Nous Research 开发的开源 AI 代理框架,它能够在你的终端、消息平台和 IDE 中运行。它与 Claude Code(Anthropic)、Codex(OpenAI)和 OpenClaw 属于同一类别------能够使用工具调用与系统交互的自主编码和任务执行代理。
核心特点
- 支持任意大语言模型提供商:包括 OpenRouter、Anthropic、OpenAI、DeepSeek、本地模型等 15+ 种以上的提供商
- 跨平台运行:支持 Linux、macOS 和 WSL
- 自我进化能力:通过技能(Skills)系统从经验中学习
- 持久记忆:在会话之间记住你是谁、你的偏好、环境细节和学到的经验
- 多平台网关:同一个代理可在 Telegram、Discord、Slack、WhatsApp、Signal、Matrix、Email 等 10+ 平台上运行
- 提供商无关性:可以在工作流中间切换模型和提供商
- 配置文件:可以运行多个独立的 Hermes 实例,拥有隔离的配置、会话、技能和记忆
- 高度可扩展:支持插件、MCP 服务器、自定义工具、Webhook 触发器和定时调度
快速开始
安装
bash
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
按照提示进行快速安装,选择模型,直接安装后续也可以配置模型
基本命令
bash
# 交互式聊天(默认)
hermes
# 单次查询
hermes chat -q "What is the capital of France?"
# 设置向导
hermes setup
# 切换模型/提供商
hermes model
# 检查健康状态
hermes doctor
CLI 主要功能
全局标志
bash
--version, -V # 显示版本
--resume, -r SESSION # 按 ID 或标题恢复会话
--continue, -c [NAME] # 按名称恢复,或最近会话
--worktree, -w # 独立的 git worktree 模式
--skills, -s SKILL # 预加载技能(逗号分隔或重复)
--profile, -p NAME # 使用命名配置
--yolo # 跳过危险命令确认
--pass-session-id # 在系统提示中包含会话 ID
聊天模式
bash
hermes chat [flags]
-q, --query TEXT # 单次查询,非交互式
-m, --model MODEL # 模型(例如 anthropic/claude-sonnet-4)
-t, --toolsets LIST # 逗号分隔的工具集
--provider PROVIDER # 强制指定提供商
-v, --verbose # 详细输出
--checkpoints # 启用文件系统快照
配置管理
bash
hermes setup [section] # 交互式设置向导
hermes config edit # 编辑配置文件
hermes login # OAuth 登录
hermes doctor [--fix] # 检查依赖和配置
核心特性详解
1. Skills 技能系统
Hermes 最独特的功能是通过技能实现自我改进。当它解决复杂问题、发现工作流程或被纠正时,可以将这些知识保存为技能文档。技能会持续积累,让代理更擅长处理你的特定任务和环境。
bash
# 查看已安装的技能
hermes skills list
# 搜索技能库
hermes skills search QUERY
# 安装技能
hermes skills install ID
# 在会话中加载技能
/skill <name>
2. 持久记忆
Hermes 可以在不同会话之间持久化记忆,包括:
- 你是谁(用户偏好)
- 环境详情
- 学到的经验教训
支持多种记忆后端(内置、Honcho、Mem0 等)。
3. 跨平台网关
支持的平台包括:
- 即时通讯:Telegram、Discord、Slack、WhatsApp、Signal、Matrix
- 其他:Email、SMS、Mattermost、Home Assistant、DingTalk、Feishu、WeCom 等
bash
# 启动网关
hermes gateway run
# 作为后台服务安装
hermes gateway install
# 控制服务
hermes gateway start/stop/restart
4. 工具集(Toolsets)
| 工具集 | 功能 |
|---|---|
web |
Web 搜索和内容提取 |
browser |
浏览器自动化 |
terminal |
Shell 命令和进程管理 |
file |
文件读写搜索 |
code_execution |
沙盒 Python 执行 |
vision |
图像分析 |
image_gen |
AI 图像生成 |
tts |
文本转语音 |
delegation |
子代理任务委派 |
cronjob |
定时任务管理 |
messaging |
跨平台消息发送 |
启用/禁用工具:
bash
hermes tools # 交互式管理
hermes tools enable NAME # 启用工具集
hermes tools disable NAME # 禁用工具集
支持的模型提供商
20+ 个提供商支持,包括但不限于:
| 提供商 | 认证方式 |
|---|---|
| OpenRouter | API 密钥 |
| Anthropic | API 密钥 |
| Nous Portal | OAuth |
| OpenAI Codex | OAuth |
| GitHub Copilot | Token |
| Google Gemini | API 密钥 |
| DeepSeek | API 密钥 |
| xAI / Grok | API 密钥 |
| Hugging Face | Token |
| 阿里云 DashScope | API 密钥 |
切换模型:
bash
hermes model # 交互式模型/提供商选择器
在会话中的斜杠命令
| 命令 | 功能 |
|---|---|
/new |
新会话 |
/clear |
清屏并开始新会话 |
/retry |
重发最后一条消息 |
/undo |
移除最后一组交换 |
/config |
显示配置 |
/model |
更改模型 |
/voice on/off |
语音模式开关 |
/tools |
管理工具 |
/help |
显示所有命令 |
/quit |
退出 CLI |
关键路径和配置文件
bash
~/.hermes/config.yaml # 主配置文件
~/.hermes/.env # API 密钥和秘密
$HERMES_HOME/skills/ # 已安装技能
~/.hermes/sessions/ # 会话记录
~/.hermes/logs/ # 网关和错误日志
~/.hermes/auth.json # OAuth token 和凭证池
典型应用场景
- 软件开发:代码编写、调试、重构
- 研究:文献综述、数据分析、论文总结
- 系统管理:自动化运维任务
- 数据分析:数据处理、可视化
- 内容创作:文章写作、翻译
- 家庭自动化:智能家居设备控制
- 任何需要从 AI 代理中获得持久上下文和完整系统访问权限的任务
官方资源
- GitHub: https://github.com/NousResearch/hermes-agent
- 文档: https://hermes-agent.nousresearch.com/docs/
- CLI 参考: https://hermes-agent.nousresearch.com/docs/reference/cli-commands
- 技能目录: https://hermes-agent.nousresearch.com/docs/reference/skills-catalog
与其他 AI 代理的对比
| 特性 | Hermes Agent | Claude Code | Codex |
|---|---|---|---|
| 开源 | ✅ | ❌ | ❌ |
| 支持模型数量 | 20+ | 仅限 Anthropic | 仅限 OpenAI |
| 自学习技能系统 | ✅ | ❌ | ❌ |
| 跨平台网关 | ✅(10+ 平台) | ❌ | ❌ |
| 价格 | 免费 + 你付模型费 | 订阅费 | 订阅费 |
| 部署灵活性 | 高(可本地部署) | 低 | 低 |
Hermes Agent 代表了下一代 AI 代理的方向:开源、可定制、能学习的自主系统。无论你是开发者、研究人员还是普通用户,都能从中受益。