Hermes Agent 安装与使用指南 —— Nous Research 自进化 AI 代理

什么是 Hermes Agent？

Hermes Agent 是由 Nous Research 开发的一款自进化 AI 代理。它不只是一个对话机器人——它内置了完整的学习循环：从经验中创建技能、在使用中自我改进、主动持久化知识、搜索自己的过往对话，并在一次次会话中建立越来越深刻的用户画像。

flowchart TD
    A[用户输入] --> B[Hermes Agent 循环]
    B --> C{是否需要新技能?}
    C -->|是| D[自主创建技能]
    C -->|否| E[执行任务]
    D --> E
    E --> F[经验总结]
    F --> G[知识持久化]
    G --> H[记忆 & 用户画像]
    H --> B
    
    style B fill:#7C3AED,color:#fff
    style D fill:#F59E0B,color:#000
    style G fill:#10B981,color:#fff

核心特性一览

特性	说明
🧠 自我进化	自主创建技能，在使用中自改进，建立长期记忆
🔧 模型中立	支持 30+ 模型提供商，随时切换，零锁定
🌐 多平台连接	Telegram / Discord / Slack / WhatsApp / Signal / 钉钉 / 飞书 / 微信 / QQ 等
🖥️ 终端 TUI	完整终端界面，多行编辑，斜杠命令自动补全
⏰ 定时任务	内置 Cron 调度器，支持自然语言设定
🚚 子代理并行	派生孤立子代理并行工作，管线化复杂任务
🏠 6 种终端后端	本地 / Docker / SSH / Daytona / Singularity / Modal，服务器优雅托管
📦 Skills 生态	兼容 agentskills.io 开放标准，支持 MCP 协议

安装指南

快速安装（推荐）

Hermes Agent 支持 Linux、macOS、WSL2，一行命令搞定：

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

安装完成后，刷新 shell 配置并启动：

source ~/.bashrc   # 或 source ~/.zshrc
hermes              # 开始聊天！

Windows 用户

Windows 原生不支持，请先安装 WSL2：

# PowerShell（管理员）
wsl --install -d Ubuntu

然后在 WSL2 终端中执行安装命令。

Android / Termux

手机安装的详细手动步骤见 Termux 指南。

配置模型提供商

安装后最重要的一步：选择 LLM 提供商。

hermes model    # 交互式配置向导

支持 30+ 提供商，常见选择：

提供商	接入方式	说明
Nous Portal	OAuth 登录	零配置订阅
OpenAI Codex	设备码认证	ChatGPT OAuth
Anthropic Claude	OAuth 或 API Key	Max 计划 + 额外用量
OpenRouter	API Key	200+ 模型自由路由
DeepSeek	API Key	直接接入
阿里云 DashScope	API Key	Qwen 系列模型
Z.AI / GLM	API Key	智谱模型
Kimi / Moonshot	API Key	月之暗面模型
MiniMax	OAuth / API Key	MiniMax-M2.7
自定义端点	Base URL + Key	VLLM / Ollama / SGLang 等

⚠️ 最低要求：64K 上下文窗口。Hermes 需要至少 64K tokens 的工作记忆。

配置架构

密钥/Token → ~/.hermes/.env
非敏感设置 → ~/.hermes/config.yaml

通过 CLI 设置自动分流：

hermes config set model anthropic/claude-sonnet-4
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-xxx

CLI 使用

flowchart LR
    A[hermes 启动] --> B{选择界面}
    B --> C[hermes 经典 CLI]
    B --> D[hermes --tui 现代 TUI]
    C --> E[交互对话]
    D --> E
    E --> F[斜杠命令 /]
    F --> G[/model 换模型]
    F --> H[/skills 浏览技能]
    F --> I[/compress 压缩上下文]
    E --> J[退出 / 保存]

启动方式

hermes                # 经典 CLI
hermes --tui          # 现代 TUI（推荐）
hermes -c             # 恢复上次会话
hermes -s <skill>     # 预加载技能
hermes chat -q "你好" # 单次查询
hermes -w             # 隔离工作目录

状态栏

会话中底部会实时显示状态：

⚕ claude-sonnet-4-20250514 │ 12.4K/200K │ [██████░░░░] 6% │ $0.06 │ 15m

元素	含义
模型名	当前模型
Token 计数	已用 / 最大上下文
彩色进度条	绿 < 50% → 黄 50-80% → 橙 80-95% → 红 ≥ 95%
费用	估算会话成本
时长	已用时

常用斜杠命令

命令	功能
`/help`	显示所有命令
`/model`	切换模型
`/tools`	列出可用工具
`/skills browse`	浏览 Skills Hub
`/personality pirate`	换人格（pirate / kawaii / 等）
`/retry`	重试上一轮
`/undo`	撤销最后一轮
`/compress`	压缩上下文
`/voice on`	启用语音模式
`/background <prompt>`	后台执行任务
`/title My Session`	命名当前会话

快捷键

按键	操作
`Enter`	发送消息
`Alt+Enter` / `Ctrl+J`	换行（多行输入）
`Tab`	自动补全/接受建议
`Ctrl+C`	中断当前操作
`Ctrl+B`	开始/停止语音录制
`Ctrl+G`	在编辑器中编辑输入

消息网关：连接多平台

Hermes Agent 最强大的特性之一——一个后台进程同时连接所有平台。

hermes gateway setup    # 交互式配置
hermes gateway          # 前台启动
hermes gateway install  # 安装为系统服务
hermes gateway start    # 启动服务
hermes gateway stop     # 停止服务
hermes gateway status   # 查看状态

支持平台

平台	语音	图片	文件	线程	流式输出
Telegram	✅	✅	✅	—	✅
Discord	✅	✅	✅	✅	✅
Slack	✅	✅	✅	✅	✅
WhatsApp	—	✅	✅	—	✅
Signal	—	✅	✅	—	✅
钉钉	—	✅	✅	✅	✅
飞书/Lark	✅	✅	✅	✅	✅
微信	✅	✅	✅	—	✅
QQ	✅	✅	✅	—	—
企业微信	✅	✅	✅	—	✅
Microsoft Teams	—	✅	—	✅	✅
邮件	—	✅	✅	✅	—
Home Assistant	—	—	—	—	—

Skills 技能系统

Hermes 的技能是过程性记忆——可复用的工作流模板，从 agentskills.io 生态中安装，或由 Agent 自主创建。

hermes skills search kubernetes     # 搜索技能
hermes skills install openai/skills/k8s  # 安装

创建新技能：

flowchart LR
    A[完成复杂任务] --> B[Agent 分析过程]
    B --> C{是否可复用?}
    C -->|是| D[自动创建技能]
    C -->|否| E[丢弃]
    D --> F[下次直接调用]
    F --> G[技能在使用中自我改进]

每个已安装的技能自动注册为斜杠命令：

/gif-search funny cats
/github-pr-workflow create a PR
/excalidraw

记忆系统

Hermes 的记忆系统是闭环学习的核心：

层级	机制	说明
💬 会话记忆	上下文窗口内	当前对话的临时记忆
📝 持久记忆	Agent 维护的 MEMORY.md	重要事实、偏好、教训
👤 用户画像	Honcho 辩证建模	跨会话的深层用户理解
🔍 回想要点	FTS5 + LLM 摘要	搜索过往对话获取上下文
🎯 定期促动	主动 nudge	Agent 自主决定何时更新记忆

终端后端

Hermes 支持 6 种终端执行后端：

hermes config set terminal.backend local     # 本地直接执行
hermes config set terminal.backend docker    # Docker 隔离
hermes config set terminal.backend ssh       # 远程服务器
hermes config set terminal.backend daytona   # 云工作空间
hermes config set terminal.backend modal     # Serverless

其中 Daytona 和 Modal 提供无服务器持久化——Agent 的环境在闲置时休眠，唤醒时按需启动，近乎零成本。

定时任务（Cron）

自然语言设定定时任务，自动投递到任意平台：

# 在对话中直接说：
"每天早上9点给我发一份 GitHub 仓库状态报告"
"每30分钟检查一次服务器磁盘使用率"
"每周日备份数据库到 S3"

从 OpenClaw 迁移

如果你正从 OpenClaw 迁移到 Hermes，内置迁移工具：

hermes claw migrate                     # 交互式迁移
hermes claw migrate --dry-run           # 预览迁移内容
hermes claw migrate --preset user-data  # 仅迁移用户数据
hermes claw migrate --overwrite         # 覆盖冲突文件

迁移内容自动导入：

SOUL.md — 人格设定
MEMORY.md / USER.md — 记忆与用户信息
自定义 Skills → ~/.hermes/skills/openclaw-imports/
命令允许列表 — 安全策略
消息平台配置 — Telegram / Discord 等
API Key — 允许列表中的密钥
工作目录配置 — AGENTS.md

安全机制

功能	说明
👥 用户白名单	默认拒绝未授权用户
✅ 命令审批	危险命令需手动确认 `/approve`
🏖️ 沙箱执行	Docker / SSH / Serverless 隔离
🔐 密钥分离	`.env` 与 config 文件分离
🔄 DM 配对	一对一私聊建立信任

快速故障排查

症状	原因	解决
打开但回复为空	提供商认证失败	运行 `hermes model` 重新配置
自定义端点返回乱码	Base URL / 模型名错误	先在外部客户端验证端点
网关启动但无人能发消息	Token / 白名单配置不完整	重新运行 `hermes gateway setup`
无法恢复旧会话	切换了 profile 或未保存	检查 `hermes sessions list`
`hermes doctor` 报错	配置缺失或过期	修复后重新测试基础聊天

恢复三部曲：

hermes doctor   # 诊断
hermes model    # 重配提供商
hermes setup    # 完整设置向导

总结

Hermes Agent 不仅仅是一个 AI 聊天机器人——它是一个自我进化的 AI 伙伴，能够自主创建技能、积累长期记忆、通过 20+ 消息平台与你交互，并通过可配置的终端后端在任何环境下运行。

相比其他 AI 代理，Hermes 最大的差异化在于：

闭环学习 —— 不只是对话，而是从每次交互中成长
模型中立 —— 随时切换提供商，不对接单一生态
无处不在 —— 从 Telegram 到终端，从手机到服务器

沉鱼的博客