Hermes Agent 是一个开源 AI Agent 框架，核心优势在于两点：支持 Claude / GPT / Gemini / DeepSeek 等 15+ 模型 Provider 统一接入，以及支持 Telegram / Discord / Slack 等 15+ 消息平台部署。如果你需要的不只是一个终端工具，而是能跑在多个平台上、连接多个 AI Provider 的自定义 Agent，Hermes 是目前开源选项里功能最完整的。

Hermes Agent 完全上手指南：开源 AI 编程助手的安装、配置与核心能力

Hermes Agent 是一个 Python 实现的开源 AI Agent 框架，项目托管在 GitHub（hermes-agent），目前版本 v2026.4.x，活跃维护，约 3000 个测试用例。

Hermes 和 Claude Code 是什么关系？

先说定位差异，否则容易装完发现不是自己需要的东西。

维度	Hermes Agent	Claude Code
模型绑定	任意 Provider（OpenRouter / Anthropic / Gemini / DeepSeek / Kimi 等）	仅 Anthropic Claude
运行平台	CLI + Telegram / Discord / Slack / WhatsApp 等 15+ 平台	VS Code / JetBrains / 终端
使用场景	通用 Agent 框架，编程 + 信息处理 + 消息自动化	专注代码编写和工程任务
技能系统	Hermes Skills（YAML 文件，独立安装，社区 Hub）	Claude Code Skills（SKILL.md，本地目录）
内存模型	持久化 SQLite（FTS5 全文检索），跨会话	每次会话独立，CLAUDE.md 持久化配置
配置中心	`~/.hermes/config.yaml` + `~/.hermes/.env`	`.claude/settings.json` + `CLAUDE.md`

简单说：Claude Code 是专业的代码工具，Hermes 是通用的 Agent 平台。两者不互斥，很多开发者同时在用。

安装

环境要求

Python 3.11+
Git（用于 clone 和更新）
至少一个 LLM Provider 的 API Key

快速安装

bash

# 1. Clone 仓库
git clone https://github.com/path/to/hermes-agent
cd hermes-agent

# 2. 创建虚拟环境并安装依赖
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

pip install -e .

# 3. 运行设置向导
hermes setup

hermes setup 是一个交互式向导，会逐步引导你：

选择默认 LLM Provider（OpenRouter / Anthropic 等）
填入 API Key（写入 ~/.hermes/.env）
配置终端后端（local / docker / SSH）
可选：配置消息平台（Telegram Bot Token 等）

手动配置（不用向导）

复制 .env.example 到 ~/.hermes/.env，填写你需要的 Key：

env

# 推荐：OpenRouter（聚合多家 Provider）
OPENROUTER_API_KEY=sk-or-...

# 或者直接用 Anthropic
ANTHROPIC_API_KEY=sk-ant-...

# 工具扩展（按需）
EXA_API_KEY=...        # AI 搜索
FIRECRAWL_API_KEY=...  # 网页抓取

然后在 ~/.hermes/config.yaml 设定默认模型：

yaml

model:
  default: anthropic/claude-opus-4.6

核心能力一览

1. 工具系统（30+ 内置工具）

Hermes 的工具按「工具集（Toolset）」分组，按需启用：

工具集	代表工具	作用
`core`	terminal、file_read/write、file_patch	终端执行、文件操作
`web`	web_search、web_extract	Exa/Parallel 搜索 + 网页提取
`browser`	browser_navigate、browser_screenshot	Browserbase 自动化浏览器
`code`	execute_code	Python/JS/Bash 沙箱执行
`delegate`	delegate_task	子代理并发（最多 3 并发，2 层嵌套）
`mcp`	call_mcp_tool	调用 MCP Server 工具
`memory`	memory_save、memory_search	持久化记忆（SQLite FTS5）

详细工具清单见 Hermes 工具系统：30+ 工具全解析。

2. Skills（技能扩展）

Skills 是 Hermes 的斜杠命令扩展机制，每个 skill 是一个 YAML 文件：

yaml

name: code-review
description: 对指定文件或 PR 做代码审查
prompt: |
  你是代码审查专家。请对以下内容进行安全性、可维护性和性能审查：
  {{args}}

安装方式：

/skills browse — 从社区 Hub 搜索和安装
直接把 YAML 文件放到 ~/.hermes/skills/ 目录
hermes skills 命令管理已安装的技能

详细说明见 Hermes Skills 系统详解。

3. 多平台消息网关

Hermes 的 gateway 模式让 AI 助手跑在消息平台上：

bash

# 启动 Telegram 网关
hermes gateway telegram

# 启动 Discord 网关
hermes gateway discord

启动后，用户在 Telegram 里发消息给 Bot，Hermes 处理并回复。支持斜杠命令、文件上传、审批流程（危险命令需用户确认）。

详细配置见消息网关部署指南。

4. ACP IDE 集成

ACP（Agent Client Protocol）让 Hermes 在 VS Code 或 Zed 里作为编辑器内嵌 Agent 运行，任务结果直接显示在编辑器 UI 里。

详细配置见 ACP IDE 集成指南。

5. 多 Provider 路由

Hermes 支持 15+ LLM Provider 统一接入，并内置智能路由：简单问题自动切廉价模型，复杂任务保留主力模型，节省 API 成本。

详细说明见多 Provider 路由与成本控制。

常用命令

bash

hermes                    # 启动 CLI 交互界面
hermes setup              # 重新运行设置向导
hermes config             # 查看/修改配置
hermes model              # 切换当前模型
hermes tools              # 管理工具启用状态
hermes skills             # 管理 skills
hermes gateway <platform> # 启动消息网关
hermes mcp serve          # 启动 MCP Server 模式
hermes --profile coder    # 用 coder 配置文件启动（多实例隔离）

CLI 内部的斜杠命令（/help 查看完整列表）：

/model        切换模型
/tools        查看/切换工具集
/skills       浏览和安装 skills
/plan         生成任务计划文档
/skin         切换 CLI 主题
/background   后台任务状态
/clear        清空当前会话

多实例隔离（Profiles）

一台机器跑多个 Hermes 实例、各自隔离配置和数据：

bash

hermes --profile work     # 工作用（Claude Opus）
hermes --profile personal # 个人用（Gemini Flash，低成本）
hermes --profile coding   # 编程用（DeepSeek Coder）

每个 profile 有独立的 ~/.hermes/profiles/<name>/ 目录（config、API keys、记忆、sessions 全部隔离）。

FAQ

Q: Hermes 和 Claude Code 能同时用吗？

可以，两者没有冲突。Hermes 还提供 MCP Server 模式（hermes mcp serve），让 Claude Code 直接调用 Hermes 里存储的消息记录，形成互补。

Q: 不用 OpenRouter，可以直接接 Anthropic 吗？

可以，在 ~/.hermes/.env 里设置 ANTHROPIC_API_KEY，然后 config.yaml 里 model.default 写 anthropic/claude-opus-4.6（保留 anthropic/ 前缀，Hermes 会路由到原生 Anthropic API）。

Q: 终端后端用 Docker 有什么好处？

沙箱隔离。Agent 执行命令跑在容器里，不会影响宿主机环境。对于需要安装依赖或有破坏性操作的任务，推荐用 Docker 后端。

Q: Hermes 的记忆系统和 Claude Code 的 CLAUDE.md 是什么关系？

不同层面的持久化。Hermes 记忆是对话级别的信息（memory_save 工具主动写入，FTS5 全文检索），跨会话累积。CLAUDE.md 是项目级的配置和指令，是静态的。两个机制互补，不替代。

Skills 详解

已知问题

已知问题

Hermes Agent 完全上手指南：开源 AI 编程助手的安装、配置与核心能力

Hermes 和 Claude Code 是什么关系？

安装

环境要求

快速安装

手动配置（不用向导）

核心能力一览

1. 工具系统（30+ 内置工具）

2. Skills（技能扩展）

3. 多平台消息网关

4. ACP IDE 集成

5. 多 Provider 路由

常用命令

多实例隔离（Profiles）

FAQ

本系列文章

Provider 与成本优化

能力扩展

部署与集成

内部机制深度解析

Hermes Agent 完全上手指南：开源 AI 编程助手的安装、配置与核心能力 ​

Hermes 和 Claude Code 是什么关系？ ​

安装 ​

环境要求 ​

快速安装 ​

手动配置（不用向导） ​

核心能力一览 ​

1. 工具系统（30+ 内置工具） ​

2. Skills（技能扩展） ​

3. 多平台消息网关 ​

4. ACP IDE 集成 ​

5. 多 Provider 路由 ​

常用命令 ​

多实例隔离（Profiles） ​

FAQ ​

本系列文章 ​

Provider 与成本优化 ​

能力扩展 ​

部署与集成 ​

内部机制深度解析 ​

Hermes Agent 完全上手指南：开源 AI 编程助手的安装、配置与核心能力

Hermes 和 Claude Code 是什么关系？

安装

环境要求

快速安装

手动配置（不用向导）

核心能力一览

1. 工具系统（30+ 内置工具）

2. Skills（技能扩展）

3. 多平台消息网关

4. ACP IDE 集成

5. 多 Provider 路由

常用命令

多实例隔离（Profiles）

FAQ

本系列文章

Provider 与成本优化

能力扩展

部署与集成

内部机制深度解析