Hermes Agent

Hermes Agent 是 Nous Research 开源的自进化 AI agent 框架。slogan："The agent that grows with you" —— 越用越聪明，跨会话记住一切。

跟 OpenClaw 的关系

Hermes 被很多人视为 OpenClaw 的进化版/替代品 —— 同样支持多端接入 + Gateway，但多了自主学习闭环（自动从经验中沉淀技能）。Hermes 自带 hermes claw migrate 命令一键从 OpenClaw 迁移。

核心特性

特性	说明
自学习闭环	⭐ 业界唯一原生学习，从执行中提炼技能
长期记忆	跨会话持久化，对你了解越来越深
多模型自由	200+ 模型一条命令切换，无厂商锁定
TUI 完整	多行编辑、命令补全、历史、流式输出
多端接入	15+ IM 平台（Telegram / 飞书 / 钉钉 / WhatsApp / Email）
定时自动化	内置 Cron，跑日报/备份/审计
并行处理	Subagent + 多工作流
多环境运行	本地 / Docker / SSH / Daytona / Modal

安装

推荐：一键脚本（Linux / macOS / WSL2）

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

source ~/.bashrc
hermes      # 启动

会自动装：

• uv Python 包管理器
• Python 3.11
• Node.js v22（浏览器自动化）
• ripgrep（文件搜索）
• ffmpeg（音频转换）

Windows 不直接支持

必须用 WSL2，原生 Windows 不可用。

手动安装

# 1. 克隆
git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# 2. uv + Python 3.11
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv venv --python 3.11
export VIRTUAL_ENV="$(pwd)/venv"

# 3. 装依赖
uv pip install -e ".[all]"

# 4. 配置目录
mkdir -p ~/.hermes/{cron,sessions,logs,memories,skills,pairing,hooks,image_cache,audio_cache,whatsapp/session}
cp cli-config.yaml.example ~/.hermes/config.yaml
touch ~/.hermes/.env

# 5. 启动
./venv/bin/hermes

配置 Shuro

方式 A：用 hermes model 交互配（推荐）

hermes model

按提示：

1. 选 「More providers」
2. 选 「Custom Endpoint」（兼容 OpenAI 格式）
3. 填：
   • Base URL: https://shuro.vip/v1
   • API Key: <您的 API Key>
   • Model: claude-opus-4-7 / gpt-5.5

方式 B：编辑 ~/.hermes/.env

# 用兼容 OpenAI 协议接 Shuro
OPENAI_API_KEY=<您的 API Key>
OPENAI_BASE_URL=https://shuro.vip/v1

# 或者用 Anthropic 协议
ANTHROPIC_API_KEY=<您的 API Key>
ANTHROPIC_BASE_URL=https://shuro.vip

方式 C：编辑 ~/.hermes/config.yaml

default_model: openai/claude-opus-4-7

providers:
  Shuro:
    type: openai_compatible
    base_url: https://shuro.vip/v1
    api_key_env: OPENAI_API_KEY
    models:
      - claude-opus-4-7
      - claude-sonnet-4-6
      - gpt-5.5
      - gpt-5.4

  Shuro_anthropic:
    type: anthropic
    base_url: https://shuro.vip
    api_key_env: ANTHROPIC_API_KEY

完整命令清单

hermes                          # 交互式对话 TUI
hermes model                    # 选/切 LLM 提供商
hermes tools                    # 配置启用的工具集
hermes config set <key> <val>   # 设置单项配置
hermes gateway                  # 启动多平台消息网关
hermes setup                    # 全量配置向导
hermes claw migrate             # ⭐ 从 OpenClaw 迁移数据
hermes update                   # 更新到最新版
hermes doctor                   # 诊断环境和配置
hermes version                  # 版本
hermes status                   # 配置状态
hermes chat -q "提示词"          # 单次查询（脚本用）

配置目录

~/.hermes/
├── config.yaml          # 主配置
├── .env                 # 环境变量（API Key）
├── cron/                # 定时任务
├── sessions/            # 对话会话
├── logs/                # 日志
├── memories/            # ⭐ 持久化记忆
├── skills/              # ⭐ 学到的技能（自动沉淀）
├── pairing/             # 多用户授权
├── hooks/               # 生命周期钩子
├── image_cache/         # 图像缓存
├── audio_cache/         # 音频缓存
└── whatsapp/session/    # WhatsApp 会话数据

多端消息网关

启动网关接入 15+ 平台：

hermes gateway          # 前台运行
hermes gateway &        # 后台运行
hermes gateway setup    # 交互式配置

支持平台

类别	平台
国际 IM	Telegram / Discord / Slack / WhatsApp / Signal / Matrix
企业	飞书 / 钉钉 / 企业微信 / Mattermost
传统	Email / SMS / iMessage（BlueBubbles）
其他	Home Assistant / Webhooks

接入 Telegram（最常见）

# 1. 在 BotFather 申请 bot，拿 token
# 2. 配 Hermes
hermes config set gateway.telegram.bot_token "1234567:ABC..."
hermes config set gateway.telegram.enabled true
hermes gateway restart

# 3. Telegram 找你的 bot 开始聊天

自学习闭环（独家特性）

Hermes 是业界唯一自带学习能力的 agent 框架：

你: "帮我重构 auth.ts"
Hermes: （读代码 → 分析 → 重构 → 跑测试）
              ↓
       Hermes 自动观察：
       - 我用了什么工具序列？
       - 哪些步骤反复执行？
       - 用户满意吗？
              ↓
       提炼成 skill 写入 ~/.hermes/skills/
              ↓
下次类似任务 → Hermes 直接调用学到的 skill
            → 速度 + 质量都提升

跟 Claude Code 的手写 Skill 不同 —— Hermes 自己写 Skill，无需人工。

定时自动化（Cron）

# 每天 9 点跑日报
hermes config set cron.daily_report.enabled true
hermes config set cron.daily_report.schedule "0 9 * * *"
hermes config set cron.daily_report.prompt "总结昨天的 git 提交，发到飞书"

# 每小时备份某目录
hermes config set cron.backup.schedule "0 * * * *"
hermes config set cron.backup.prompt "压缩 /important/ 到 /backup/，按时间命名"

跟 OS-level crontab 比，Hermes Cron 可以让 AI 自主判断任务执行细节（不是死板的固定脚本）。

从 OpenClaw 迁移

hermes claw migrate

自动把 ~/.openclaw/ 下的 workspace / memory / sessions 迁到 ~/.hermes/。

跟其他 Agent 工具对比

维度	Hermes	OpenClaw	Claude Code	OpenCode
学习闭环	✅ 唯一	❌	❌	❌
长期成长	✅	✅ 部分	❌	❌
多端接入	✅ 15+	✅ 10+	❌	❌
模型自由	✅ 200+	✅	✅	✅
编程深度	中	中	极强	强
厂商锁定	❌	部分	部分	❌
TUI	✅	✅	CLI	CLI

适合 vs 不适合

适合

• ✅ 想要 AI 越用越懂你
• ✅ 多端 IM 接入需求强
• ✅ 团队/朋友圈共享场景
• ✅ 需要定时任务自动化

不适合

• ❌ 深度编程任务（Claude Code 更强）
• ❌ Windows 原生（要 WSL2）
• ❌ 简单一次性使用（杀鸡用牛刀）

资源

• Hermes Agent GitHub
• Nous Research 官网
• 菜鸟教程 Hermes Agent
• Hermes Agent 中文社区
• 实战 Hermes + Claude Code + Superpowers 三件套