首页
手游
资讯
专题
首页 > 教程攻略 > ai教程 >Hermes Agent常用命令完全指南:让你事半功倍的高效 AI 助手

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

来源：互联网 时间：2026-07-25 07:13:51

一、什么是 Hermes Agent？

Hermes Agent 是 Nous Research 开源的一款 AI 助手，它身上有几个很实用的核心能力，值得重点了解：

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

  • 持久记忆

    ：跨会话保存上下文和学习内容，意味着聊过的内容不会轻易丢失。

  • 工具调用

    ：自动执行命令、操作文件、调用 API，相当于给了它一双“手”。

  • 自动构建技能

    ：根据需求动态生成和安装新技能，扩展性很强。

  • 多平台接入

    ：支持 CLI、Telegram、Discord、企业微信等，哪里顺手用哪里。

  • 定时任务

    ：通过 cron 实现自动化工作流，省去手动重复操作。

无论是个人开发者还是团队协作，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 对话里的指令，而是操作系统的 shell 命令。

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

# 保存当前对话
/sa ve

# 重新生成上一条回复
/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 的功能确实很强大，通过本文介绍的常用命令，你可以做到：

  • 高效管理会话

    ：快速新建、恢复、清理会话

  • 灵活配置模型

    ：根据任务切换不同模型

  • 扩展能力

    ：通过技能系统增强功能

  • 多平台接入

    ：在 CLI、Telegram、Discord 等平台使用

  • 自动化工作流

    ：通过 cron 和后台任务实现自动化

关键命令速查表

：

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

相关阅读

相关下载