Hermes Agent 保姆级入门教程：你的第一个 AI Terminal Agent

胡单纯

504人浏览 · 2026-04-20 16:29:44

胡单纯 · 2026-04-20 16:29:44 发布

Hermes Agent 保姆级入门教程：你的第一个 AI Terminal Agent

TL;DR: Hermes Agent 是由 Nous Research 开源的 AI Agent 框架，帮你用自然语言操控电脑、写代码、管文件、调度任务。它支持 20+ 模型提供商、跨平台消息接入、持久记忆和技能学习。本文从零开始，手把手教你安装、配置、生产使用的完整流程。

什么是 Hermes Agent？

Hermes Agent 是一个跑在终端里的 AI Agent，和 Claude Code（Anthropic）、OpenAI Codex 属于同一类别 —— 能自主调用工具、操作文件系统、执行命令。但它有几个独特优势：

特性	说明
多模型支持	OpenRouter、Anthropic、DeepSeek、MiniMax 等 20+ 提供商自由切换
跨平台消息	Telegram、Discord、Slack、飞书、微信……同一 Agent 接入所有平台
持久记忆	跨 session 记住你的身份、偏好、环境配置
技能学习	把复杂工作流存成可复用技能，下一次直接加载
定时任务	内置 Cron 调度，不用额外配置

官网： https://hermes-agent.nousresearch.com/
GitHub： https://github.com/NousResearch/hermes-agent

环境准备

支持的系统

Linux（Ubuntu 20.04+、Debian、Arch 等）
macOS（Intel & Apple Silicon）
Windows WSL2（推荐用 Ubuntu 子系统）

前置要求

Python 3.10+（检查：python3 --version）
Git
curl（用于下载安装脚本）
pip（Python 包管理）
一个 LLM 提供商的 API Key（见下文）

提供商	说明	获取地址
OpenRouter	聚合 100+ 模型，按量付费	https://openrouter.ai/
Anthropic	Claude 系列	https://console.anthropic.com/
DeepSeek	性价比高	https://platform.deepseek.com/
MiniMax	国内可用	https://platform.minimaxi.com/
硅基流动	国内可用	https://siliconflow.cn/

安装 Hermes Agent

一键安装（推荐）

打开终端，运行：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

脚本会自动：

检测你的系统环境
创建虚拟环境 ~/.hermes/venv/
安装依赖包
下载主程序
添加 hermes 命令到 PATH

安装完成后，验证：

hermes --version

看到版本号即安装成功。

手动安装（可选）

# 克隆仓库
git clone https://github.com/NousResearch/hermes-agent.git ~/.hermes/hermes-agent
cd ~/.hermes/hermes-agent

# 创建虚拟环境
python3 -m venv venv
source venv/bin/activate

# 安装
pip install -e .

# 验证
hermes --version

首次配置

启动配置向导

hermes setup

交互式向导会依次询问：

1. 选择模型提供商（OpenRouter / Anthropic / DeepSeek / ...）
2. 输入 API Key
3. 选择终端配色主题
4. 配置消息平台（可选，跳过也行）
5. 启用需要的工具集

跟着提示走，2 分钟搞定基础配置。

目录结构

安装后，Hermes 在 ~/.hermes/ 下生成以下结构：

~/.hermes/
├── config.yaml          # 主配置文件
├── .env                 # API Key 等敏感信息
├── skills/             # 安装的技能包
├── sessions/           # 对话历史记录
├── logs/               # 日志文件
└── hermes-agent/       # 源代码（git 安装时才有）

手动配置文件

# 查看当前配置
hermes config

# 编辑配置
hermes config edit

# 查看配置路径
hermes config path

config.yaml 核心配置项：

model:
  default: anthropic/claude-sonnet-4-6
  provider: openrouter
  api_key: ${OPENROUTER_API_KEY}

agent:
  max_turns: 90
  tool_use_enforcement: true

terminal:
  backend: local
  timeout: 180

memory:
  memory_enabled: true
  user_profile_enabled: true

.env 文件示例：

# OpenRouter
OPENROUTER_API_KEY=sk-or-v1-xxxxx

# 或 Anthropic
ANTHROPIC_API_KEY=sk-ant-xxxxx

# 或 DeepSeek
DEEPSEEK_API_KEY=sk-xxxxx

安全提醒： .env 文件包含你的 API Key，切勿上传到 GitHub 或分享给他人。

快速上手：你的第一个问题

交互式对话

安装配置完成后，直接输入：

hermes

你会看到欢迎 banner，然后就可以用自然语言和它对话了：

$ hermes
[Hermes Agent v2.x.x]
Type /help for commands.

You: 帮我查看当前目录有什么文件

单次查询模式

不需要交互，直接问一个问题：

hermes chat -q "What is the capital of France?"

基础操作演示

1. 读取文件

You: 读取 ~/.bashrc 文件的前 20 行

2. 执行终端命令

You: 在当前目录创建一个名为 hello.py 的 Python 文件，内容是打印 "Hello, Hermes!"

3. 搜索文件

You: 在当前目录找出所有 .md 文件

4. 写代码并运行

You: 用 Python 写一个函数，计算斐波那契数列第 n 项，然后测试 n=10

核心功能详解

1. 工具集（Toolsets）

Hermes 的能力来自「工具集」，你需要先启用才能用。

查看可用工具

hermes tools list

启用/禁用工具

hermes tools enable terminal    # 启用终端工具
hermes tools enable web         # 启用网页搜索
hermes tools enable file        # 启用文件操作

工具集一览

工具集	功能
`terminal`	执行 Shell 命令
`file`	读取、写入、搜索文件
`web`	网页搜索、内容提取
`browser`	浏览器自动化
`code_execution`	沙盒 Python 执行
`vision`	图片分析
`image_gen`	AI 图片生成
`tts`	文字转语音
`memory`	持久记忆
`session_search`	搜索历史对话
`delegation`	子 Agent 委托
`cronjob`	定时任务
`messaging`	跨平台发消息

注意： 工具集修改后需要 /reset（开新 session）才生效，因为 Hermes 会缓存当前的工具列表。

2. 技能（Skills）

Skills 是 Hermes 的「学习」机制 —— 把解决过的问题流程存成文档，下次遇到直接加载。

列出已安装技能

hermes skills list

搜索技能市场

hermes skills search "python"
hermes skills browse

安装技能

hermes skills install technical-blog-writing

在会话中加载技能

You: /skill technical-blog-writing

加载后，Hermes 会读取该技能的完整说明（包括工作流、最佳实践），并在当前任务中应用。

制作自己的技能

当你用 Hermes 完成一个复杂任务后，可以问它：

You: 把这个工作流存成一个技能，方便以后复用

Hermes 会自动整理成技能文档保存。下次直接 /skill 你的技能名 就能加载。

3. 记忆系统（Memory）

Hermes 有持久记忆，会跨 session 记住：

用户信息：你是谁、偏好什么
环境信息：项目结构、配置细节
学到的东西：你纠正过它的方式、常用的工作流

查看记忆状态

hermes memory status

配置记忆提供商

默认用内置 SQLite，也可切换到 Honcho 或 Mem0：

hermes honcho setup    # 如果装了 honcho 插件

4. 消息网关（Gateway）

Gateway 让 Hermes 接入 IM 平台，在 Telegram、Discord、飞书里和它对话。

启动 Gateway

hermes gateway run

配置消息平台

hermes gateway setup

支持的平台：

平台	说明
Telegram	最简单，5 分钟配置完成
Discord	需要开发者模式
Slack	需要创建 App
飞书	企业应用
微信	通过企业微信接入
WhatsApp
Signal
Email	SMTP/IMAP

作为系统服务运行

hermes gateway install     # 安装为 systemd 服务
hermes gateway start       # 启动
hermes gateway status      # 查看状态

这样服务器重启后 Gateway 也会自动启动。

5. 定时任务（Cron）

# 创建定时任务
hermes cron create "0 9 * * *" "总结昨天的日志写入 ~/daily-log.md"

# 列出所有任务
hermes cron list

# 手动触发一次
hermes cron run <job_id>

# 删除任务
hermes cron remove <job_id>

定时任务常用于：

每日自动总结
定时监控服务状态
定时抓取数据
定时发送报告

6. 多会话管理

查看历史会话

hermes sessions list

恢复会话

# 恢复最近一次
hermes --continue

# 按 ID 恢复
hermes --resume 20260225_143052_a1b2c3

导出会话

hermes sessions export ~/conversations.jsonl

清理旧会话

hermes sessions prune --older-than 30 days

进阶用法

1. 子 Agent 委托（delegate_task）

把复杂任务拆解，并行分给多个子 Agent：

# 示例：同时让三个子 Agent 并行工作
# Agent A: 调研竞品
# Agent B: 写架构设计
# Agent C: 准备测试数据

子 Agent 在独立会话中运行，互不干扰，适合「调研 + 实现」并行的场景。

2. MCP 服务器接入

MCP（Model Context Protocol）让 Hermes 能接入更多外部工具：

# 添加 MCP 服务器
hermes mcp add <name> --url <server_url>
# 或
hermes mcp add <name> --command "<command>"

# 列出已配置的 MCP 服务器
hermes mcp list

# 测试连接
hermes mcp test <name>

3. 多 Profile 管理

如果你有多个项目或多个身份，可以用 Profile 实现完全隔离的配置：

# 创建新 Profile
hermes profile create work

# 切换
hermes profile use work

# 克隆现有配置
hermes profile create personal --clone-from default

每个 Profile 有独立的：

config.yaml
.env
skills/
sessions/

4. Webhook 触发

外部服务可以触发 Hermes 执行任务：

# 创建一个 Webhook 路由
hermes webhook subscribe mytask

# 测试这个 Webhook
curl -X POST http://localhost:18989/webhooks/mytask \
  -d '{"prompt": "分析上传的日志文件"}'

常见问题排查

`hermes: command not found`

# 检查安装
which hermes
ls ~/.hermes/venv/bin/hermes

# 重新加载 PATH
source ~/.bashrc
# 或
source ~/.zshrc

API Key 不生效

# 检查 .env 文件是否正确
cat ~/.hermes/.env

# 测试 Key 是否有效
hermes doctor

工具不响应

# 检查工具是否启用
hermes tools list

# 重启新 session
/exit
hermes

Gateway 连接失败

# 查看日志
tail -50 ~/.hermes/logs/gateway.log

# 飞书用户特别注意
# 需要安装 lark-oapi 包：
~/.hermes/venv/bin/pip install lark-oapi

模型调用报错

# 检查配置
hermes config

# 切换模型
hermes model

# 查看详细错误
hermes doctor

工作流示例

示例 1：技术博客写作

# 1. 启动 Hermes，加载写作技能
hermes -s technical-blog-writing

# 2. 告诉它你要写什么
You: 我要写一篇关于 Docker 容器安全的博客，面向有基础的开发者

# 3. 它会按技能规范产出：
#    - 正确的结构
#    - 可运行的代码示例
#    - 结尾签名块
#    - 保存到 workspace/articles/
#    - 上传到飞书云盘

示例 2：代码审查

hermes

You: 审查 ~/myproject/src/ 目录下的所有 Python 文件，找出潜在的安全问题

示例 3：自动化日常任务

# 创建一个每天早上 9 点执行的任务
hermes cron create "0 9 * * 1-5" \
  "检查服务器状态，把异常日志发到我邮箱"

官方资源

资源	链接
官方文档	https://hermes-agent.nousresearch.com/docs/
GitHub	https://github.com/NousResearch/hermes-agent
Skills 市场	https://hermes-agent.nousresearch.com/docs/reference/skills-catalog
模型提供商列表	https://hermes-agent.nousresearch.com/docs/integrations/providers
消息平台配置	https://hermes-agent.nousresearch.com/docs/user-guide/messaging/

总结

Hermes Agent 的核心价值：

开箱即用 —— 安装简单，配置容易，5 分钟跑起来
本地优先 —— 所有数据存在本地，API Key 自己管
技能积累 —— 越用越聪明，技能越攒越多
跨平台 —— 终端、IM、API，想怎么聊就怎么聊

建议从今天开始，把一个日常重复任务交给 Hermes 自动处理，体验一下「AI Agent 本地化」的生产力。

项目	内容
作者	胡小纯
发布日期	2026-04-20
联系微信	hu–xiaochun
个人主页	https://胡小纯.cn
备用主页	https://xn–yets91feqb.cn/

技术没有捷径，但有方向

AtomGit开源社区

AtomGit 是由开放原子开源基金会联合 CSDN 等生态伙伴共同推出的新一代开源与人工智能协作平台。平台坚持“开放、中立、公益”的理念，把代码托管、模型共享、数据集托管、智能体开发体验和算力服务整合在一起，为开发者提供从开发、训练到部署的一站式体验。

更多推荐

山东大学创新实训个人纪实（5）——降低对话延迟调研

AtomGit开源社区

AI Agent Harness Engineering 增长策略：从免费试用到底价付费的4步转化漏斗

在讨论增长策略前，必须先厘清本文涉及的三个核心术语——零散Agent（Loose Agent）增长Harness（Growth Harness）零散Agent：指独立部署、功能单一的AI工具，如通用代码生成Agent、文本摘要Agent，缺乏与业务增长逻辑绑定的设计，通常由OpenAI Function Calling或LangChain简单搭建，决策链短、交互深度浅、留存率低。增长Harness

AtomGit开源社区

ChatGPT怎么导出表格 ——“AI导出鸭”终结结构化数据格式乱码困局

AtomGit开源社区

所有评论(0)

查看更多评论

胡单纯

@weixin_45494794

已为社区贡献8条内容

Hermes Agent 保姆级入门教程：你的第一个 AI Terminal Agent

胡单纯

Hermes Agent 保姆级入门教程：你的第一个 AI Terminal Agent

什么是 Hermes Agent？

环境准备

支持的系统

前置要求

推荐模型提供商

安装 Hermes Agent

一键安装（推荐）

手动安装（可选）

首次配置

启动配置向导

目录结构

手动配置文件

快速上手：你的第一个问题

交互式对话

单次查询模式

基础操作演示

核心功能详解

1. 工具集（Toolsets）

查看可用工具

启用/禁用工具

工具集一览

2. 技能（Skills）

列出已安装技能

搜索技能市场

安装技能

在会话中加载技能

制作自己的技能

3. 记忆系统（Memory）

查看记忆状态

配置记忆提供商

4. 消息网关（Gateway）

启动 Gateway

配置消息平台

作为系统服务运行

5. 定时任务（Cron）

6. 多会话管理

查看历史会话

恢复会话

导出会话

清理旧会话

进阶用法

1. 子 Agent 委托（delegate_task）

2. MCP 服务器接入

3. 多 Profile 管理

4. Webhook 触发

常见问题排查

hermes: command not found

API Key 不生效

工具不响应

Gateway 连接失败

模型调用报错

工作流示例

示例 1：技术博客写作

示例 2：代码审查

示例 3：自动化日常任务

官方资源

总结

所有评论(0)

温馨提示：您尚未绑定手机号

胡单纯

`hermes: command not found`