Hermes Agent常用命令完全指南:助你事半功倍的高效 AI 助手

一、什么是 Hermes Agent？

Hermes Agent 是由 Nous Research 开发的开源 AI 助手，具备以下核心能力：

• 持久记忆：跨会话保存上下文和学习内容
• 工具调用：自动执行命令、操作文件、调用 API
• 自动构建技能：根据需求动态生成和安装新技能
• 多平台接入：支持 CLI、Telegram、Discord、企业微信等
• 定时任务：通过 cron 实现自动化工作流

无论是个人开发者还是团队协作，Hermes Agent 都能显著提升效率。

把 Hermes Agent 的已经基本操作和常用命令做了一次全面的梳理。

二、安装与初始配置

2.1 快速安装

# 推荐方式：通过官方脚本安装（自动跟踪最新版本）
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
# 或使用源码安装（适合开发者）
git clone https://github.com/NousResearch/hermes-agent
cd hermes-agent
./setup-hermes.sh

2.2 核心配置命令

安装完成后，需要先配置 LLM 提供商和模型：

# 交互式配置向导（推荐首次运行）
hermes setup

# 配置/切换模型和提供商（如 OpenAI、Anthropic、本地 Ollama 等）
hermes model

# 诊断配置和依赖问题
hermes doctor

# 查看 Agent、认证、平台状态
hermes status

# 更新 Hermes 到最新版本
hermes update

# 查看/编辑配置文件
hermes config

示例：配置使用 OpenAI GPT-4

hermes model
# 会弹出交互式界面，选择：
# 1. 提供商：OpenAI
# 2. 模型：gpt-4-turbo
# 3. 设置 API Key

三、终端命令（CLI Commands）

注意：以下命令在终端中直接执行，不是在 Hermes 对话中输入。

3.1 启动 Hermes

# 正常启动（推荐在项目目录下启动，当前目录 = 项目根目录）
hermes

# 或使用现代 TUI 界面
hermes --tui

# 继续上一次对话
hermes -c

# 恢复指定对话（通过会话 ID）
hermes -r 
# 完整命令：
hermes --resume 

# 以独立工作区启动（隔离文件，适合并行任务）
hermes -w

# 单次查询模式（不进入交互式对话）
hermes chat -q "总结最新的 Git 提交"

# 纯脚本模式（只输出最终答案，无多余内容，适合自动化）
hermes -z "生成一个 Python 爬虫脚本"

示例 1：快速查询

hermes chat -q "今天北京的天气怎么样？"
# 输出：北京今天晴转多云，气温 15-25°C...

示例 2：脚本化调用

# 将 Hermes 的输出保存到变量
result=$(hermes -z "生成一个随机密码，长度 16")
echo "你的新密码是：$result"

3.2 会话管理

# 查询所有会话历史
hermes sessions list

# 通过 ID 删除指定会话
hermes sessions delete 

# 清理旧对话（交互式确认）
hermes sessions prune

# 删除 1 天前的所有会话（无需确认）
hermes sessions prune --older-than 1 --yes

# 删除 7 天前的所有会话
hermes sessions prune --older-than 7 --yes

示例：清理旧会话

# 查看所有会话
hermes sessions list
# 输出：
# ID: abc123 | 标题: 代码调试 | 更新时间: 2026-06-10
# ID: def456 | 标题: 文章撰写 | 更新时间: 2026-06-12

# 删除指定会话
hermes sessions delete abc123

# 批量清理 3 天前的会话
hermes sessions prune --older-than 3 --yes

3.3 配置与信息查看

# 查看日志
hermes logs

# 查看错误级别日志
hermes logs --level error

# 查看完整配置
hermes config

# 查看当前使用的配置文件路径
hermes config --show-path

# 备份 Hermes 主目录到 zip 文件
hermes backup

# 从 zip 文件恢复备份
hermes import 

3.4 网关管理（对接消息平台）

# 启动网关服务（前提：已配置微信/钉钉/飞书/Telegram 等）
hermes gateway

# 网关设置向导
hermes gateway setup

# 启动网关
hermes gateway start

# 查看网关/平台状态
hermes gateway status

示例：接入 Telegram Bot

# 1. 先配置 Telegram Bot Token
hermes gateway setup
# 选择 Telegram，输入 Bot Token

# 2. 启动网关
hermes gateway start

# 现在可以在 Telegram 中与 Hermes 对话了！

3.5 技能管理

# 浏览官方技能商店
hermes skills browse

# 搜索技能
hermes skills search <关键词>

# 安装指定技能
hermes skills install 

# 列出已安装的技能
hermes skills list

# 更新技能
hermes skills update 

示例：安装 GitHub 技能

# 搜索与 GitHub 相关的技能
hermes skills search github

# 安装 GitHub 技能
hermes skills install github

# 现在可以让 Hermes 帮你管理 GitHub 仓库了

3.6 全局选项

以下选项可以配合 hermes 命令使用：

# 指定 profile（支持多实例）
hermes --profile 

# 恢复指定会话
hermes --resume 

# 恢复最近会话
hermes --continue

# 使用隔离 git worktree（适合并行任务）
hermes --worktree

# 跳过危险命令确认（谨慎使用）
hermes --yolo

# 安静模式（适合脚本）
hermes --quiet

四、聊天内命令（Slash Commands）

注意：以下命令在 Hermes 对话中输入，以 / 开头。

4.1 会话管理

# 新建会话（清空上下文），可带标题
/new
/new 我的项目讨论

# 重置会话（同 /new）
/reset

# 清屏并开启新会话（对话不变，只是屏幕清理干净）
/clear

# 恢复指定会话
/resume 
/resume <会话标题>

# 浏览所有会话
/sessions

# 设置当前会话标题
/title 项目A代码审查

# 查看对话历史
/history

# 保存当前对话
/save

# 重新生成上一条回复
/retry

# 撤销上一轮对话
/undo

# 手动压缩上下文（节省 token）
/compress

# 回滚文件检查点（代码改坏了可回滚）
/rollback

# 退出（可删除当前会话记录）
/quit
/quit --delete

示例 1：多轮对话管理

用户：hermes
Hermes：你好！有什么可以帮你的？

用户：/new Python 教程
Hermes：已创建新会话"Python 教程"。

用户：帮我写一个快速排序算法
Hermes：[生成代码...]

用户：/undo
Hermes：已撤销上一轮对话。

用户：/history
Hermes：显示当前会话的历史记录...

示例 2：恢复会话

# 场景：昨天讨论了一半的项目，今天继续
用户：hermes
Hermes：你好！

用户：/sessions
Hermes：
  1. Python 教程 (ID: abc123)
  2. 代码调试 (ID: def456)

用户：/resume abc123
Hermes：已恢复会话"Python 教程"，我们上次讨论到了...

4.2 模型与配置

# 切换模型（支持 --global 持久化）
/model
/model gpt-4-turbo
/model claude-3-opus --global

# 查看当前使用的模型
/model

# 切换快速模式（省 token，响应更快）
/fast fast

# 切换回正常模式
/fast normal

# 调整推理强度
/reasoning low
/reasoning medium
/reasoning high

# 切换自动批准危险命令
/yolo

# 调整工具输出详细程度
/verbose

示例：根据任务切换模型

# 代码生成任务：使用 GPT-4
/model gpt-4-turbo

# 创意写作任务：使用 Claude
/model claude-3-opus

# 简单查询任务：使用快速模式
/fast fast

4.3 工具与技能

# 列出可用工具
/tools

# 启用/禁用工具
/tools enable 
/tools disable 

# 列出工具集
/toolsets

# 技能管理
/skills
/skills install 
/skills search 

# 重新加载技能或 .env
/reload-skills
/reload

# 浏览器工具控制
/browser connect
/browser status

# 定时任务管理
/cron
/cron list
/cron add 

示例：使用技能

用户：/skills search docker
Hermes：找到以下技能：
  1. docker-manager（Docker 容器管理）
  2. docker-compose-helper（Docker Compose 配置生成）

用户：/skills install docker-manager
Hermes：技能安装成功！

用户：帮我启动 Docker 容器 nginx
Hermes：[调用 docker-manager 技能，执行 docker run...]

4.4 信息与调试

# 显示帮助信息
/help

# 查看会话状态 + 摘要
/status

# 查看 token 使用量和费用
/usage

# 查看使用统计与分析
/insights
/insights 7  # 查看最近 7 天的统计

# 上传调试报告（系统信息 + 日志）
/debug

# 查看网关/平台状态
/platforms
/gateway

示例：监控 token 使用

用户：/usage
Hermes：
  本次会话：
    - Prompt tokens: 1,234
    - Completion tokens: 567
    - Total: 1,801 tokens
  今日总计：
    - Total tokens: 15,678
    - 费用（GPT-4）: $0.48

4.5 高级操作

# 后台任务
/background
/bg

# 设置持续目标（支持子目标）
/goal 完成项目A的代码重构

# 不中断当前任务，注入指引
/steer 优先处理登录模块的重构

# 队列下一条消息（当前任务完成后执行）
/queue 生成重构后的单元测试

# 会话切换到 Telegram 等平台
/handoff telegram

示例：设置长期目标

用户：/goal 开发一个博客系统
Hermes：已设置目标"开发一个博客系统"。我会帮你分解任务并逐步完成。

用户：/steer 先完成数据库设计
Hermes：收到，我会优先处理数据库设计部分。

[Hermes 自动生成数据库 schema...]

用户：/queue 完成后帮我生成 ORM 模型
Hermes：已加入队列，数据库设计完成后会自动执行。

五、实用技巧与最佳实践

5.1 多行输入

在对话中输入多行文本（如代码块）：

• 快捷键：Alt + Enter 或 Ctrl + J 或 Shift + Enter
• 注意：部分终端需要启用 Kitty 协议

示例：输入多行代码

用户（按 Alt+Enter 换行）：
我想要一个快速排序的实现：
def quicksort(arr):
    if len(arr) <= 1:
        return arr
    # 后面继续输入...

5.2 中断 Agent

当 Hermes 正在执行任务时，想中断它：

• 方法 1：输入新消息 + Enter
• 方法 2：按 Ctrl + C

5.3 语音模式

# 开启语音模式
/voice on

# 录制语音（按 Ctrl+B 开始/停止录音）
Ctrl+B

# 关闭语音模式
/voice off

5.4 预加载技能

在启动 Hermes 时预先加载常用技能：

hermes -s skill1,skill2,skill3

示例：

# 启动 Hermes 并加载 coding、github、docker 技能
hermes -s coding,github,docker

5.5 脚本化调用

使用 hermes -z 进行脚本化调用，只输出最终答案：

#!/bin/bash
# 示例：自动生成 Git commit message
changes=$(git diff --staged)
commit_msg=$(hermes -z "根据以下代码变更生成简洁的 Git commit message：$changes")
git commit -m "$commit_msg"

5.6 安全建议

• 默认行为：危险命令需要手动确认
• 跳过确认：使用 --yolo 或 /yolo（谨慎使用）
• 推荐：在生产环境中保持确认机制开启

六、推荐工作流

对于新用户，推荐以下工作流：

步骤 1：配置模型

hermes model
# 选择提供商和模型，配置 API Key

步骤 2：测试基本对话

hermes
# 进入对话后，测试基本功能
你好，请介绍一下你自己

步骤 3：接入消息平台（可选）

hermes gateway setup
# 选择 Telegram/Discord/企业微信等，配置 Token

hermes gateway start
# 现在可以在消息平台中与 Hermes 对话了

步骤 4：安装常用技能

# 在对话中
/skills browse
/skills install 

步骤 5：设置长期目标

# 在对话中
/goal 完成我的个人博客项目
/steer 先设计数据库

七、数据目录结构

Hermes 的所有数据保存在 ~/.hermes/ 目录下：

~/.hermes/
├── config.yaml       # 主配置文件
├── .env             # 环境变量（API Keys 等）
├── skills/          # 已安装的技能
├── sessions/        # 会话历史
├── memory/          # 持久记忆
├── logs/            # 日志文件
└── backups/         # 备份文件

重要配置文件：

• config.yaml：Hermes 的主配置文件
• .env：存储 API Keys 等敏感信息

八、常见问题排查

问题 1：启动失败

# 诊断配置和依赖问题
hermes doctor

# 查看错误日志
hermes logs --level error

问题 2：会话丢失

# 查看所有会话
hermes sessions list

# 恢复指定会话
hermes -r 

问题 3：技能无法使用

# 重新加载技能
/reload-skills

# 查看已安装技能
/skills list

# 重新安装技能
/skills install 

九、总结

Hermes Agent 是一款功能强大的 AI 助手，通过本文介绍的常用命令，你可以：

• 高效管理会话：快速新建、恢复、清理会话
• 灵活配置模型：根据任务切换不同模型
• 扩展能力：通过技能系统增强功能
• 多平台接入：在 CLI、Telegram、Discord 等平台使用
• 自动化工作流：通过 cron 和后台任务实现自动化

关键命令速查表：

场景	命令
启动 Hermes	hermes 或 hermes --tui
单次查询	hermes chat -q "问题"
继续上次对话	hermes -c
查看会话	hermes sessions list
配置模型	hermes model
安装技能	/skills install
查看帮助	/help
退出	/quit