Hermes Agent — 完整指南

What is Hermes

什么是 Hermes Agent？

一个开源、可扩展、自我改进的 AI 代理框架

🧠

自我改进

通过技能系统学习经验 — 每次解决复杂问题后，可以将工作流保存为可复用技能，让代理在后续会话中更强大。

🧬

跨会话记忆

记住你是谁、你的偏好、环境细节和经验教训。支持多种记忆后端（内置、Honcho、Mem0 等）。

📡

多平台网关

同一代理运行在 Telegram、Discord、Slack、WhatsApp、Signal、Matrix、Email 等 10+ 平台，拥有完整工具访问权限。

🔌

模型无关

支持 OpenRouter、Anthropic、OpenAI、DeepSeek、本地模型等 20+ 提供商，可在工作流中随时切换。

👤

多配置档案

运行多个独立的 Hermes 实例，每个拥有独立的配置、会话、技能和记忆。

🔧

高度可扩展

插件、MCP 服务器、自定义工具、Webhook 触发器、Cron 定时任务和完整的 Python 生态系统。

Capabilities

核心能力

Hermes 能做什么

💻

软件开发

编写代码、调试、测试、代码审查、CI/CD 配置、GitHub PR 管理

🌐

网络自动化

网页搜索、内容提取、浏览器自动化、表单填写

📊

数据分析

数据处理、可视化、Jupyter Notebook、统计分析

🔍

学术研究

论文搜索（arXiv）、文献综述、知识库构建

🎨

内容创作

图片生成、文字转语音、ASCII 艺术、HTML 原型设计

🏠

智能家居

Home Assistant 集成、灯光控制、设备自动化

📧

消息与邮件

跨平台消息发送、邮件收发、日历管理

⏰

定时任务

Cron 调度、Webhook 触发、自动化工作流

🤖

多代理协作

任务委派给子代理、并行工作流、tmux 多实例

Getting Started

快速开始

5 分钟上手 Hermes

curl -fsSL install.sh | bash

下载安装 Hermes Agent

hermes setup

运行交互式配置向导 — 设置模型、API 密钥等

hermes

启动交互式对话

hermes gateway run

启动消息网关（Telegram / Discord 等）

hermes model

切换模型和提供商

hermes doctor

检查依赖和配置健康状态

Command Line

CLI 终端命令

在终端中执行的 hermes 命令

🌐 全局参数

--version, -V

显示 Hermes 版本信息

--resume, -r SESSION

通过 ID 或标题恢复之前的会话

--continue, -c [NAME]

按名称恢复会话，不指定则恢复最近一次

--worktree, -w

隔离的 git worktree 模式（并行代理不冲突）

--skills, -s SKILL

预加载指定技能（逗号分隔或重复使用）

--profile, -p NAME

使用指定的配置文件（Profile）

--yolo

跳过危险命令的确认提示

💬 对话

hermes

启动交互式对话（默认命令）

hermes chat -q TEXT

单次查询，非交互模式 — 执行完即退出

hermes chat -m MODEL

指定模型，如 anthropic/claude-sonnet-4

hermes chat -t LIST

指定启用的工具集（逗号分隔）

hermes chat --provider P

强制指定提供商（openrouter / anthropic / nous）

hermes chat --checkpoints

启用文件系统检查点（支持 /rollback）

⚙️ 配置管理

hermes setup

交互式配置向导（model / terminal / gateway / tools）

hermes model

交互式模型/提供商选择器

hermes config

查看当前配置

hermes config edit

用编辑器打开 config.yaml

hermes config set KEY VAL

设置配置值，如 model.default gpt-4

hermes doctor [--fix]

检查依赖和配置健康状态

hermes status [--all]

显示各组件状态

hermes login [--provider P]

OAuth 登录（nous / openai-codex）

🧰 工具与技能

hermes tools

交互式工具启用/禁用界面

hermes tools list

列出所有工具及其状态

hermes tools enable NAME

启用指定工具集

hermes tools disable NAME

禁用指定工具集

hermes skills list

列出已安装的技能

hermes skills search QUERY

在技能中心搜索

hermes skills install ID

安装技能（ID 或 URL）

hermes skills browse

浏览所有可用技能

hermes skills update

更新已过时的技能

hermes skills uninstall NAME

卸载技能

📡 消息网关

hermes gateway run

前台启动网关

hermes gateway install

安装为后台 systemd 服务

hermes gateway start / stop / restart

控制网关服务的启动/停止/重启

hermes gateway setup

配置消息平台连接

📋 会话管理

hermes sessions list

列出最近会话

hermes sessions browse

交互式会话选择器

hermes sessions export OUT

导出会话为 JSONL 文件

hermes sessions delete ID

删除会话

hermes sessions prune

清理旧会话（--older-than N 天）

⏰ 定时任务 & Webhook

hermes cron list

列出定时任务

hermes cron create SCHED

创建任务：'30m' / 'every 2h' / '0 9 * * *'

hermes cron remove ID

删除定时任务

hermes webhook subscribe NAME

创建 Webhook 路由 /webhooks/<name>

hermes webhook list

列出 Webhook 订阅

👤 配置文件 & 其他

hermes profile create NAME

创建独立配置（--clone / --clone-all）

hermes profile use NAME

设为默认配置

hermes update

更新到最新版本

hermes plugins list / install / remove

插件管理

hermes memory setup / status / off

记忆提供商配置

hermes insights [--days N]

使用分析统计

In-Session

斜杠命令

在对话会话中直接输入的 / 命令

🎮 会话控制

命令	说明
`/new` `/reset`	开启全新会话
`/clear`	清屏并新建会话（CLI）
`/retry`	重新发送上一条消息
`/undo`	删除最后一次对话
`/title [name]`	命名当前会话
`/compress`	手动压缩上下文（节省 token）
`/stop`	终止所有后台进程
`/rollback [N]`	恢复到文件检查点
`/background <prompt>`	在后台运行任务
`/resume [name]`	恢复指定会话

⚙️ 配置调整

命令	说明
`/model [name]`	查看或切换模型
`/personality [name]`	设置人格（helpful / concise / creative / kawaii）
`/reasoning [level]`	推理强度：none / low / medium / high / xhigh / show
`/verbose`	切换详细模式：off → new → all
`/voice [on\|off\|tts]`	语音模式开关
`/yolo`	切换危险命令审批跳过
`/skin [name]`	切换主题（CLI）

🛠️ 工具与技能

命令	说明
`/skill <name>`	加载指定技能到当前会话
`/tools`	管理工具（CLI）
`/skills`	搜索/安装技能（CLI）
`/cron`	管理定时任务
`/reload-mcp`	重载 MCP 服务器

📡 网关 & 信息

命令	说明
`/approve`	批准待处理命令（网关）
`/deny`	拒绝待处理命令（网关）
`/restart`	重启网关
`/help`	显示帮助
`/usage`	Token 使用情况
`/platforms`	查看平台连接状态
`/quit` `/exit`	退出 CLI

Toolsets

可用工具集

通过 hermes tools 启用或禁用 — 修改后需 /reset 生效

工具集	功能	默认
`terminal`	Shell 命令与进程管理	✅
`file`	文件读写 / 搜索 / 修改	✅
`web`	网页搜索与内容提取	✅
`browser`	浏览器自动化	✅
`code_execution`	沙箱 Python 执行	✅
`vision`	图片分析	✅
`image_gen`	AI 图片生成	✅
`tts`	文字转语音	✅
`memory`	跨会话持久记忆	✅
`delegation`	子代理任务委派	✅
`cronjob`	定时任务管理	✅
`messaging`	跨平台消息发送	✅
`session_search`	搜索历史对话	✅
`homeassistant`	智能家居控制	❌
`rl`	强化学习工具	❌
`moa`	混合代理（Mixture of Agents）	❌

Configuration

配置速查

关键路径与常用配置项

📁 关键路径

路径	说明
`~/.hermes/config.yaml`	主配置文件
`~/.hermes/.env`	API 密钥和密钥
`~/.hermes/skills/`	已安装技能
`~/.hermes/sessions/`	会话记录
`~/.hermes/logs/`	网关和错误日志
`~/.hermes/auth.json`	OAuth 令牌和凭据池

🔧 常用配置项

配置项	说明	示例值
`model.default`	默认模型	`anthropic/claude-sonnet-4`
`model.provider`	模型提供商	`openrouter`
`agent.max_turns`	最大对话轮次	`90`
`compression.enabled`	启用上下文压缩	`true`
`compression.threshold`	压缩触发阈值	`0.50`
`memory.memory_enabled`	启用记忆	`true`
`security.redact_secrets`	自动隐藏密钥	`false`
`approvals.mode`	命令审批模式	`manual` / smart / off
`tts.provider`	文字转语音	`edge` / elevenlabs / openai

🌍 支持的模型提供商

提供商	认证方式	环境变量
`OpenRouter`	API Key	`OPENROUTER_API_KEY`
`Anthropic`	API Key	`ANTHROPIC_API_KEY`
`OpenAI`	API Key	`OPENAI_API_KEY`
`Google Gemini`	API Key	`GOOGLE_API_KEY`
`DeepSeek`	API Key	`DEEPSEEK_API_KEY`
`xAI / Grok`	API Key	`XAI_API_KEY`
`MiniMax`	API Key	`MINIMAX_API_KEY`
`Alibaba DashScope`	API Key	`DASHSCOPE_API_KEY`
`Groq`	API Key	`GROQ_API_KEY`
`Nous Portal`	OAuth	`hermes auth`
`Local GGUF`	无	`ollama` / `llama.cpp`

Hermes Agent完整指南