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 触发器和定时调度

---

快速开始

安装

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

按照提示进行快速安装，选择模型，直接安装后续也可以配置模型

基本命令

# 交互式聊天（默认）
hermes

# 单次查询
hermes chat -q "What is the capital of France?"

# 设置向导
hermes setup

# 切换模型/提供商
hermes model

# 检查健康状态
hermes doctor

---

CLI 主要功能

全局标志

--version, -V              # 显示版本
--resume, -r SESSION       # 按 ID 或标题恢复会话
--continue, -c [NAME]      # 按名称恢复，或最近会话
--worktree, -w            # 独立的 git worktree 模式
--skills, -s SKILL        # 预加载技能（逗号分隔或重复）
--profile, -p NAME        # 使用命名配置
--yolo                     # 跳过危险命令确认
--pass-session-id         # 在系统提示中包含会话 ID

聊天模式

hermes chat [flags]
  -q, --query TEXT          # 单次查询，非交互式
  -m, --model MODEL         # 模型（例如 anthropic/claude-sonnet-4）
  -t, --toolsets LIST       # 逗号分隔的工具集
  --provider PROVIDER       # 强制指定提供商
  -v, --verbose             # 详细输出
  --checkpoints             # 启用文件系统快照

配置管理

hermes setup [section]      # 交互式设置向导
hermes config edit          # 编辑配置文件
hermes login                # OAuth 登录
hermes doctor [--fix]       # 检查依赖和配置

---

核心特性详解

1. Skills 技能系统

Hermes 最独特的功能是通过技能实现自我改进。当它解决复杂问题、发现工作流程或被纠正时，可以将这些知识保存为技能文档。技能会持续积累，让代理更擅长处理你的特定任务和环境。

# 查看已安装的技能
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 等

# 启动网关
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	跨平台消息发送

启用/禁用工具：

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 密钥

切换模型：

hermes model  # 交互式模型/提供商选择器

---

在会话中的斜杠命令

命令	功能
/new	新会话
/clear	清屏并开始新会话
/retry	重发最后一条消息
/undo	移除最后一组交换
/config	显示配置
/model	更改模型
/voice on/off	语音模式开关
/tools	管理工具
/help	显示所有命令
/quit	退出 CLI

---

关键路径和配置文件

~/.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 代理的方向：开源、可定制、能学习的自主系统。无论你是开发者、研究人员还是普通用户，都能从中受益。