Hermes Agent安装教程

错过了龙虾没什么，这个你一定要动手试试！现在国内企业内部都积极使用AI，作为大学生只用AI-APP做简单对话在互联网求职赛道里就会被落下，给大家整理了最新AI届的新方向——Hermes Agent

1. 新手入门

目标：让你的 Hermes 跑起来，完成第一次对话。

核心概念

• 记忆：跨会话地记住你的偏好、项目上下文以及环境
• 技能 skill：日常执行中自动总结并制作 skill，以更好地工作与节省 token
• 网关系统：链接 15+ 通讯平台的渠道

一键安装 Hermes

macOS / Linux / WSL2

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

Windows 用户：需先安装 WSL2，然后在 WSL2 终端中执行上述命令。

安装过程会自动处理：

• Python、Node.js、Git 等依赖项
• 创建配置目录 ~/.hermes/
• 设置环境变量

安装完成后执行：

source ~/.bashrc  # 重载 shell 配置（zsh 用户执行：source ~/.zshrc）
hermes version    # 检查版本
hermes doctor     # 诊断运行环境

任务 2：配置模型供应商

安装完成后，系统会自动进入配置向导。选择 Quick Setup（推荐新手），然后选择模型供应商。

推荐的新手配置方案：

模型供应商推荐 DeepSeek、Kimi 等国产大模型，免费额度高，先尝试后再用高级大模型。

配置命令：

hermes model  # 交互式选择模型
# 或直接设置
hermes config set OPENROUTER_API_KEY sk-or-xxx

首次对话测试

hermes chat -q "Hello! What tools do you have available?"

如果回复正常则安装成功。

常见命令速查

hermes              交互式命令行界面，开启对话
hermes model        选择大语言模型服务商与对应模型
hermes tools        配置启用的工具集
hermes config set   设置单项配置项
hermes gateway      启动消息网关
hermes setup        重新运行全量配置向导
hermes doctor       诊断运行环境与配置问题
hermes status       检查配置状态
hermes update       更新至最新版本

2. 中级进阶

目标：让 Hermes 变得"有用"，接入常用通讯平台。

核心机制深度理解

1）Skill 系统（技能沉淀）

这是 Hermes 最强大的特性。当 Hermes 完成一个复杂任务后，它会自动总结经验并创建可复用的 Skill。

触发 Skill 创建的时机：

• 完成多步骤任务后
• 用户明确要求"创建技能"时
• 跨会话重复某种工作模式时

查看已有技能：

ls ~/.hermes/skills/

2）消息网关（Gateway）

一个网关可以同时接入 15+ 平台，实现"随时随地调用 AI"。

实践任务清单

任务 1：接入 Telegram 机器人

步骤 1：创建 Bot

1. 在 Telegram 中搜索 @BotFather
2. 发送 /newbot 创建新机器人
3. 获取 Bot Token

步骤 2：配置 Hermes

# 在 ~/.hermes/.env 中添加
TELEGRAM_BOT_TOKEN=your-bot-token

# 或通过命令配置
hermes config set TELEGRAM_BOT_TOKEN your-bot-token

步骤 3：编辑配置文件

# ~/.hermes/config.yaml
gateway:
  adapters:
    telegram:
      enabled: true

步骤 4：启动网关

hermes gateway

步骤 5：在 Telegram 中向机器人发送 /start

任务 2：接入飞书 / 钉钉机器人

飞书配置：

hermes gateway setup
# 选择飞书，按照指引配置

或手动编辑 ~/.hermes/config.yaml：

gateway:
  adapters:
    feishu:
      enabled: true
      require_mention: false
      default_group_policy: open

钉钉配置：

gateway:
  adapters:
    dingtalk:
      enabled: true

任务 3：配置常用工具集

hermes tools

可启用的工具包括：

filesystem         文件读写操作
web_search         互联网搜索
firecrawl          网页抓取
send_message       多平台消息发送
execute_command    执行终端命令
mcp                模型上下文协议扩展

任务 4：测试记忆功能

1. 告诉 Hermes 你的偏好（如："我叫小明，我喜欢用中文交流"）
2. 退出对话：exit
3. 重新开启对话：hermes chat
4. 问它："你知道我是谁吗？"

如果它能记住你的名字，说明记忆系统正常工作。

任务 5：触发 Skill 创建

尝试让 Hermes 完成一个复杂任务：

hermes chat
> 请帮我抓取 Hacker News 首页的 AI 新闻，并总结成中文摘要发给我

观察 Hermes 是否会提示创建新技能。

中级阶段验收标准

• Telegram / 飞书机器人能正常响应消息
• hermes tools 启用了至少 3 个工具
• 跨会话记忆功能正常（重开对话后能识别你）
• 成功触发至少一次 Skill 创建流程

3. 高手精通

目标：构建自进化闭环，实现自动化工作流。

核心机制深度理解

1）MCP（Model Context Protocol）集成

MCP 是一种标准协议，允许 Hermes 连接到外部工具和服务。通过 MCP，Hermes 可以：

• 连接本地数据库
• 操作 GitHub 仓库
• 调用自定义 API
• 访问文件系统

2）多 Agent 编排

Hermes 支持并行任务处理，可以创建多个子 Agent 协同工作。

3）Cron 定时任务

内置 Cron 调度，支持 7×24 小时自动执行任务。

实践任务清单

任务 1：MCP 扩展集成

安装 MCP 扩展：

uv pip install -e ".[mcp]"

配置 MCP 服务器，在 ~/.hermes/config.yaml 中添加：

mcp:
  servers:
    filesystem:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
    github:
      command: "npx"
      args: ["-y", "@modelcontextprotocol/server-github"]

使用 MCP 工具，在对话中直接调用：

请读取我 GitHub 上的最新 Issue，并总结给我

任务 2：搭建定时自动化任务

创建 Cron 任务：

hermes chat
> 帮我创建一个每天早上 9 点运行的任务，总结今日 AI 新闻并发到我的 Telegram

Hermes 会自动创建对应的 Cron 任务配置。

查看定时任务：

ls ~/.hermes/cron/

手动管理 Cron，编辑 ~/.hermes/cron/tasks.yaml：

tasks:
  - name: daily_news
    schedule: "0 9 * * *"  # 每天早上 9 点
    command: "总结今日 AI 新闻"
    platform: telegram
    chat_id: "your-chat-id"

任务 3：多 Agent 编排

创建主 Agent 调用子 Agent：

hermes chat
> 创建一个调研 Agent 负责收集信息，一个写作 Agent 负责整理成文，一个校对 Agent 负责检查错误

通过配置文件定义多 Agent 协作流程：

agents:
  researcher:
    role: "调研员"
    tools: [web_search, firecrawl]
  writer:
    role: "作家"
    tools: [filesystem]
  editor:
    role: "校对员"
    tools: [filesystem]

任务 4：高级配置与安全

配置执行后端：

# Docker 隔离模式
hermes config set terminal.backend docker

# SSH 远程模式
hermes config set terminal.backend ssh

数据备份：

# 备份配置
tar -czvf hermes-backup.tar.gz ~/.hermes/

# 备份内容：
# ~/.hermes/sessions/    # 对话历史
# ~/.hermes/memories/    # 记忆数据
# ~/.hermes/skills/      # 技能配置
# ~/.hermes/config.yaml  # 主配置

任务 5：性能优化

监控日志：

tail -f ~/.hermes/logs/hermes.log

优化启动速度：

# 预热模型
hermes model warmup

资源限制，在 Docker 中运行以限制资源：

docker run -d \
  --name hermes-agent \
  --memory="2g" \
  --cpus="2" \
  -v ~/.hermes:/home/hermes/.hermes \
  ghcr.io/nousresearch/hermes-agent:latest \
  hermes

高手阶段验收标准

• MCP 扩展正常集成（至少连接一个外部服务）
• Cron 定时任务能自动执行
• 多 Agent 协作流程正常运行
• 掌握数据备份与安全配置
• 能阅读并修改 config.yaml 高级配置

常见问题与解决方案

诊断命令：遇到任何问题，首先运行：

hermes doctor

这会告诉你缺少什么以及如何修复。

快快给自己武装起来吧！