Hermes Agent 77 个命令完全指南:按功能分类的权威参考

Hermes Agent 77 个命令完全指南:按功能分类的权威参考

开篇:什么是 Hermes Agent?

在 AI 智能体工具快速演进的 2026 年,开源的 Hermes Agent 正以它独特的开放性和灵活性赢得越来越多开发者的青睐。由 Nous Research 开发的这款 AI 智能体框架,可以运行在终端、桌面应用、消息平台和 IDE 中,与 Claude Code(Anthropic)、Codex(OpenAI)、OpenCode 等工具同属一个品类——但 Hermes 有几个核心差异化特性让它脱颖而出。

Hermes 最大的特色是提供商无关。你可以随时切换 OpenRouter、Anthropic、OpenAI、DeepSeek、Google Gemini、xAI Grok、HuggingFace、本地模型等 20 多家提供商,而工作流完全不变。这是业界少有的真正实现「模型无关」的智能体框架。它还支持凭证池化——同一个提供商可以配置多个 API Key,自动轮换使用,当某个 Key 耗尽时自动跳过。

另一大特色是自我进化的技能系统。Hermes 会从每次交互中学习,将可复用的工作流保存为技能文档(SKILL.md)。当你解决了一个复杂问题、发现了一个工作流、或者被纠正了错误,这些知识可以固化为技能,在未来的会话中自动加载。技能会随时间积累,让代理越来越擅长你的特定任务和场景。

跨会话持久记忆让 Hermes 记住你是谁、你的偏好、环境细节和经验教训。记忆后端可插拔(内置 SQLite、Honcho、Mem0 等),你可以自由选择。

还有多平台消息网关——同一个智能体实例可以同时运行在 Telegram、Discord、Slack、WhatsApp、iMessage、Signal、Matrix、Teams、Email 等 20 多个平台上,拥有完整的工具调用能力,不只是聊天机器人。

Hermes 的能力部分来自于它丰富而精细的命令体系。本文全面梳理 Hermes Agent 的 77 个核心命令,按功能分类一一解读。


一、基础交互命令

这是 Hermes 最常用的命令组。Hermes 默认进入交互式聊天模式,但同时也提供了丰富的非交互式选项,方便脚本调用和 CI/CD 集成。

hermes — 启动交互式对话

无参数启动,进入交互式聊天界面。这是最常用的入口。启动后可以持续对话,Hermes 会跨轮次保持上下文。用户每输入一条消息,Hermes 会调用 LLM 并执行工具调用,然后返回结果。这个循环持续进行,直到用户退出。

hermes chat — 精细化聊天控制

显式启动聊天模式。支持多种子选项:

-q, --query TEXT — 单次查询模式,非交互式。这是脚本调用的主力选项。例如 hermes chat -q "列出当前目录下的所有 Python 文件并统计行数" 会返回结果后自动退出。适合集成到 Makefile、CI 流水线、定时任务中。

-m, --model MODEL — 指定模型,覆盖配置中的默认设置。例如 hermes chat -m anthropic/claude-sonnet-4 使用 Claude Sonnet 4,或者 hermes chat -m openai/gpt-4o 使用 GPT-4o。模型名称格式为 提供商/模型名

-t, --toolsets LIST — 指定启用的工具集,逗号分隔。例如 -t terminal,file,web 只加载终端、文件和网络搜索三个工具集。这可以减少 Token 消耗、提升专注度。

--provider PROVIDER — 强制指定提供商,不依赖默认配置。例如 --provider openrouter

-v, --verbose — 详细输出模式,显示模型调用详情、工具执行过程、API 耗时等调试信息。

-Q, --quiet — 静默模式。隐藏启动横幅、旋转动画、工具调用预览等非必要输出。适合在终端输出需要被其他程序解析的场景。

--checkpoints — 启用文件系统检查点。Hermes 会在关键操作前自动创建快照,可以用 /rollback 命令回滚到之前的文件状态。这是实验性操作的防护网。

--source TAG — 设置会话源标签。默认值为 cli。当你从不同入口(CLI、桌面、Web、Telegram)使用 Hermes 时,这个标签帮助区分会话来源,方便后续统计和分析。

会话恢复与分支

hermes --resume, -r SESSION — 按会话 ID(如 20260228_143052_a1b2c3)恢复历史会话。适合工作中断后精确回到之前的上下文。

hermes --continue, -c [NAME] — 按名称恢复最近会话。不传名称时恢复最近一个会话。比 --resume 更方便快捷。

hermes --worktree, -w — 隔离的 git worktree 模式。适用于并行运行多个代理分别处理不同分支,避免 git 文件冲突。每个 worktree 有独立的文件系统视图。

启动预配置

hermes --skills, -s SKILL — 预加载技能列表。可重复使用或逗号分隔。例如 hermes -s python-debugging,git-workflow 在启动时即加载调试和 Git 工作流两个技能。技能中包含的提示会注入系统提示,指导 Hermes 的行为。

hermes --profile, -p NAME — 使用指定的配置启动。配置文件有独立的 skills/、plugins/、cron/、memories/ 目录。适合在同一台机器上运行多个用途不同的 Hermes 实例。

hermes --yolo — 跳过所有危险命令的审批提示。默认情况下 Hermes 会在执行 rm -rfgit reset --hard 等破坏性命令前请求用户确认。--yolo 跳过这个保护层,谨慎使用。

hermes --pass-session-id — 在系统提示中包含当前会话 ID。某些高级场景下,子代理或外部系统需要知道自己所属的会话上下文。


二、配置管理命令

配置是 Hermes 的基础层。面向新用户和需要精细化控制的高级用户分别提供了不同层次的命令。

交互式向导

hermes setup [section] — 交互式配置向导,是新手最友好的入口。不加参数时启动全流程向导,引导用户逐步完成模型选择、终端配置、API Key 设置等步骤。

分模块设置:
- hermes setup model — 仅配置模型和提供商
- hermes setup terminal — 仅配置终端后端(本地/Docker/SSH/Modal)
- hermes setup gateway — 仅配置消息网关
- hermes setup tools — 仅配置工具启用/禁用
- hermes setup agent — 仅配置代理行为参数

每个子向导都是独立的 curses TUI,支持方向键选择、空格键切换、回车确认。

hermes model — 交互式模型/提供商选择器。打开一个列表界面,显示所有支持的提供商和可用的模型。可以选择模型后自动测试连通性。支持 20 多家主流提供商:OpenRouter、Anthropic、OpenAI、Nous Portal、GitHub Copilot、Google Gemini、DeepSeek、xAI Grok、HuggingFace、Z.AI/GLM、MiniMax、Kimi/Moonshot、阿里 DashScope、小米 MiMo、Kilo Code、OpenCode Zen/Go、Qwen OAuth 等。此外还支持自定义端点。

配置文件操作

hermes config — 查看当前配置摘要,包括模型、提供商、上下文长度、终端类型、工具状态等关键信息。

hermes config edit — 在系统默认编辑器中打开 config.yaml。在 CLI 模式下会使用 $EDITOR 环境变量指定的编辑器。

hermes config set KEY VAL — 直接设置配置项,无需编辑器。支持点号分隔的层级键名:
- hermes config set model.default deepseek/deepseek-chat
- hermes config set display.interface tui
- hermes config set security.redact_secrets true
- hermes config set approvals.mode smart

hermes config path — 打印 config.yaml 的完整文件路径。

hermes config env-path — 打印 .env 文件的完整路径。API Key 和安全凭据存储在此文件中。

配置健康检查

hermes config check — 检查当前配置是否存在缺失的必填项、已废弃的选项、或格式不正确的值。生成检查报告,列出问题和修复建议。

hermes config migrate — 升级配置文件的必要工具。当 Hermes 新版本引入新的配置选项时,migrate 会将缺失的选项以默认值添加到现有配置中,保证配置文件的完整性。

诊断命令

hermes doctor [--fix] — 全面的健康检查命令。诊断范围包括:
- Python 环境和依赖版本
- 模型提供商连通性
- 终端后端可用性
- 工具集依赖完整性
- API Key 有效性
- 配置文件完整性
- 技能目录结构
- 数据库状态

--fix 参数时会尝试自动修复发现的问题。

hermes status [--all] — 显示各组件运行状态。默认显示摘要:模型状态、工具状态、网关状态、存储状态。--all 显示全部组件的详细状态。


三、工具与技能管理命令

Hermes 的核心能力来自可插拔的工具系统和可积累的技能库。工具决定了代理能做什么,技能决定了代理知道怎么做。

工具管理

Hermes 的工具系统采用「工具集」架构。每个工具集包含一组相关的工具。例如 terminal 工具集包含 shell 命令执行、进程管理、后台任务等工具;web 工具集包含网页抓取、搜索引擎、内容提取等工具。所有工具集定义在 toolsets.pyTOOLSETS 字典中。

hermes tools — 交互式工具启用/禁用界面。基于 curses 的 TUI,左侧显示所有工具集,右侧显示选中工具集的详细工具列表。支持按平台分别配置——例如在 Telegram 上禁用 browser 工具集,在 CLI 上保留。

hermes tools list — 以文本列表形式输出所有工具集及其状态(启用/禁用/按平台启用),便于脚本解析。

hermes tools enable NAME — 启用指定工具集。例如启用图像分析能力:hermes tools enable vision。启用后需要 /reset 新会话才能生效。

hermes tools disable NAME — 禁用指定工具集。例如在安全敏感场景中禁用网络访问:hermes tools disable web

技能管理

技能是 Hermes 最独特的机制。每个技能是一个包含 YAML 前置元数据和 Markdown 正文的 SKILL.md 文件。技能可以包含精确的指令、命令示例、陷阱警告、验证步骤。当技能加载到会话中时,其内容注入系统提示,指导模型的行为。

hermes skills list — 列出所有已安装技能,显示名称、描述、版本、作者、安装来源。

hermes skills search QUERY — 在官方技能中心搜索可用但尚未安装的技能。搜索范围覆盖社区贡献的数百个技能。

hermes skills install ID — 安装技能。ID 可以是中心注册的标识符,也可以直接是一个 HTTPS 链接指向 SKILL.md 文件。后者支持私有仓库中的技能。使用 --name 参数可以覆盖技能在元数据中定义的名字。

hermes skills inspect ID — 预览技能内容和元数据,但不实际安装。用于评估技能是否适合自己使用。

hermes skills config — 按平台配置技能的启用/禁用状态。例如可以让 git-workflow 技能仅在 CLI 中加载,而在 Telegram 中禁用。

hermes skills check — 检查所有已安装技能是否有可用的更新版本。

hermes skills update — 批量更新所有过时的技能到最新版本。

hermes skills uninstall N — 通过索引号移除已安装的技能。

hermes skills publish PATH — 将本地开发的技能发布到官方技能注册中心。

hermes skills browse — 浏览全部分类下的所有公开技能。支持按分类、评分、安装量排序。

hermes skills tap add REPO — 添加 GitHub 仓库作为技能来源。技能将从指定仓库中自动发现和同步。


四、MCP 服务器管理命令

Model Context Protocol 是 AI 工具互操作的标准协议。Hermes 既可以作为 MCP 客户端连接外部服务,也可以作为 MCP 服务器暴露自身能力。

hermes mcp serve — 将 Hermes 自身作为 MCP 服务器运行,暴露其工具给其他 MCP 客户端(如 VS Code、Zed、JetBrains 等 IDE)。

hermes mcp add NAME — 添加一个 MCP 服务器连接。支持两种连接模式:
- --url 参数连接到远程 HTTP MCP 服务器
- --command 参数运行本地 MCP 服务器进程(stdio 模式)

例如 hermes mcp add filesystem --command "npx @modelcontextprotocol/server-filesystem /path" 添加文件系统 MCP 服务器。

hermes mcp remove NAME — 移除已配置的 MCP 服务器。

hermes mcp list — 列出所有已配置的 MCP 服务器及其状态(连接/断开)。

hermes mcp test NAME — 测试指定 MCP 服务器的连通性,返回工具列表和执行测试。

hermes mcp configure NAME — 切换 MCP 暴露的工具的选择——可以选择将哪些工具暴露给模型使用,哪些隐藏。


五、消息网关命令

Hermes 的网关支持 20 多种消息平台,这意味着你可以在 Telegram 上命令 Hermes 编写代码、在 Slack 中让它分析数据、在 WhatsApp 上让它查询数据库——所有平台共享同一个智能体核心,但走不同的安全策略和审批流程。

hermes gateway run — 前台运行消息网关。日志直接打印到终端,适合调试和验证配置。按 Ctrl+C 停止。

hermes gateway install — 将网关安装为后台服务。Linux 下使用 systemd user service,Windows 下使用 Windows Service。

hermes gateway start / stop — 手动启动/停止已安装的网关服务。

hermes gateway restart — 重启网关服务。在修改配置或更新后使用。

hermes gateway status — 检查网关运行状态,显示是否正在运行、启动时间、连接的平台列表、消息统计。

hermes gateway setup — 交互式配置消息平台。引导用户完成 Telegram Bot Token 配置、Discord Bot 权限设置、WhatsApp 二维码扫描等各平台特有的认证流程。

支持平台列表:Telegram、Discord、Slack、WhatsApp(Baileys 桥接 + 官方 Business Cloud API)、iMessage(Photon 协议,无需 Mac 中介服务器)、Signal、Email(IMAP/SMTP)、SMS、Matrix、Mattermost、Microsoft Teams、LINE、SimpleX、ntfy、Google Chat、Home Assistant、钉钉、飞书、企业微信、微信、Raft 代理网络、API Server、Webhooks。Open WebUI 可以通过 API Server 适配器连接。


六、会话管理命令

Hermes 的会话系统基于 SQLite + FTS5(全文搜索 5)引擎。所有对话记录持久化到本地,支持高效检索、导出和管理。

hermes sessions list — 列出最近的会话列表。每个条目显示会话 ID、标题(自动生成或用户设置)、开始时间、消息数量、使用的模型。输出按时间倒序排列。

hermes sessions browse — 交互式会话浏览器。支持搜索关键词筛选、时间范围过滤、模型筛选。选中会话后可以查看摘要或继续对话。

hermes sessions export OUT — 将会话导出为 JSONL(JSON Lines)格式文件。每行一个 JSON 对象,包含消息角色、内容、时间戳、工具调用记录。适合数据分析和模型微调。

hermes sessions rename ID T — 重命名指定会话。让你的会话列表更有条理。

hermes sessions delete ID — 永久删除指定会话。不可恢复,谨慎操作。

hermes sessions prune — 清理旧会话。支持 --older-than N days 参数指定天数阈值。超出阈值的会话将被删除。适合定期清理以节省磁盘空间。

hermes sessions stats — 显示会话存储统计:会话总数、消息总数、存储空间占用、平均每会话消息数等。帮助你了解使用规模和增长趋势。


七、定时任务命令

Hermes 内置的 cron 调度器支持从简单的间隔定时到复杂的 cron 表达式,每个任务可以加载技能、覆盖模型、指定工作目录、启用多平台投递。

hermes cron list — 列出所有定时任务。--all 参数同时显示已禁用的任务。每个条目显示任务 ID、名称、调度表达式、下次执行时间、执行次数、状态。

hermes cron create SCHED — 创建新定时任务。调度格式非常灵活:
- 持续时间:"30m"(每30分钟)、"2h"(每2小时)
- 自然语言:"every monday 9am""every weekday at 18:00"
- 标准 cron:"0 9 *"(每天上午9点)
- ISO 时间戳:一次性执行

创建时可以指定提示词、技能列表、模型/提供商、投递平台、工作目录等。

hermes cron edit ID — 编辑定时任务的配置。可以修改调度表达式、提示词内容、技能列表、投递方式、工作目录等。

hermes cron pause ID / resume ID — 暂停/恢复定时任务。暂停的任务不会触发执行,但保留配置和调度信息。

hermes cron run ID — 立即触发任务执行,不等候下一个调度周期。可以在测试时使用。

hermes cron remove ID — 删除定时任务。删除后不可恢复。

hermes cron status — 查看 cron 调度器的整体状态:是否在运行、任务总数、待执行任务数、历史执行统计。

每个任务支持丰富的配置:技能预加载、模型提供商覆盖、前置数据收集脚本(输出自动注入提示词上下文)、链式引用(将任务 A 的输出传递到任务 B)、工作目录挂载(自动加载该目录的 AGENTS.md/CLAUDE.md)、跨平台投递(同时发送到 Telegram 和邮件)。


八、Webhook 命令

Webhook 系统允许外部服务通过 HTTP POST 请求触发 Hermes 执行任务。与 cron 的时间驱动不同,webhook 是事件驱动的。

hermes webhook subscribe N — 注册 Webhook 路由。在 /webhooks/ 路径上创建一个新的端点。可以配置请求体模板、响应格式、认证方式。

hermes webhook list — 列出所有已注册的 Webhook 订阅。显示端点路径、创建时间、触发次数、最后触发时间。

hermes webhook remove NAME — 移除指定 Webhook 订阅。端点立即失效。

hermes webhook test NAME — 向指定 Webhook 发送测试 POST 请求,验证端点的连通性和响应。

Webhook 的典型应用场景:GitHub 推送事件触发代码检查、GitLab MR 事件触发自动测试、Zapier/Make 集成触发工作流、Prometheus 告警触发自动排障。


九、配置文件管理命令

配置文件(Profile)是 Hermes 支持多实例运行的基础设施。每个配置文件拥有完全独立的环境。

hermes profile list — 列出所有已有配置。显示名称、创建时间、使用的模型、技能数量、插件数量。默认配置高亮显示。

hermes profile create NAME — 创建新配置。支持克隆现有配置:
- --clone 从当前配置克隆
- --clone-all 克隆全部配置
- --clone-from NAME 从指定配置克隆

克隆时可以选择性地复制 skills/、plugins/、cron/、memories/ 目录。

hermes profile use NAME — 设置指定配置为系统默认。之后启动 Hermes 时自动使用该配置。

hermes profile delete NAME — 删除指定配置及其数据。

hermes profile show NAME — 显示配置详情:模型配置、工具集状态、技能列表、插件列表、记忆状态等。

hermes profile alias NAME — 管理配置的快捷包装脚本。创建类似 hermes-workhermes-personal 的快捷命令。

hermes profile rename A B — 将配置 A 重命名为 B。

hermes profile export NAME — 将配置导出为 tar.gz 存档。适合备份或在机器间迁移。

hermes profile import FILE — 从存档导入配置。


十、凭证与密钥池管理命令

对于使用多个 API Key 或 OAuth 提供商的企业用户,Hermes 提供了强大的凭证管理功能。

hermes auth — 交互式凭证管理器,支持添加、列出、移除、重置各种提供商凭证。基于 curses 的 TUI 界面。

hermes auth add [PROVIDER] — 添加指定提供商的凭证。支持的提供商包括:
- nous — Nous Portal OAuth
- openai-codex — OpenAI Codex OAuth
- qwen-oauth — 通义千问 OAuth
- anthropic — Anthropic API Key

凭证添加后会自动加入对应提供商的凭证池。

hermes auth list [PROVIDER] — 列出指定提供商的凭证池。显示每个凭证的状态(有效/耗尽/错误)、添加时间、最后使用时间。不指定提供商时列出所有。

hermes auth remove P INDEX — 通过提供商名称和凭证索引移除单个凭证。

hermes auth reset PROVIDER — 清除指定提供商的费率限制或密钥耗尽状态。当 API Key 的限速解除后使用此命令恢复使用。

多凭证池化的核心价值:同样的提供商,配置多个 Key 后 Hermes 自动轮换使用;当某个 Key 因超出速率限制或消费额度耗尽而失败时,自动跳过并切换到下一个,保证了服务的高可用性。


十一、其他管理命令

这些命令覆盖了使用分析、桌面体验、IDE 集成、数据迁移等场景。

hermes insights [--days N] — 使用分析仪表盘。展示 API 调用量趋势、Token 消耗统计、模型使用分布、工具调用频率、会话时长分布等。默认显示近 30 天数据,可通过 --days 参数调整。

hermes update — 升级到最新版本的 Hermes Agent。从官方源拉取最新代码或 PyPI 包。

hermes desktop / hermes gui — 启动原生 Electron 桌面应用。支持 macOS、Linux、Windows。功能包括:流式聊天、会话列表、拖拽上传、剪贴板粘贴图片、Cmd+K 快捷命令面板、状态栏模型切换器、可配置快捷键、原生通知、实时子代理监控窗口、VS Code Marketplace 主题、远程网关登录。

hermes dashboard — 启动 Web 管理面板。完全在浏览器中运行,可以配置所有消息渠道、MCP 目录、Webhook/钩子、记忆系统、配置构建器(模型 + 技能 + MCP 组合)。内嵌了 hermes --tui 聊天界面。面板通过 OAuth/Token 认证保护。

hermes proxy — 启动 OpenAI 兼容的本地代理服务器,运行在 http://localhost:端口。这个代理的后端连接到你的 OAuth 提供商(Claude Pro、ChatGPT Pro、SuperGrok)。也就是说,你可以将 Codex CLI、Aider、Cline、Continue 或其他任何 OpenAI 兼容客户端指向这个代理,而无需 API Key。

hermes portal — 快速登录 Nous Portal,通过 OAuth 完成身份认证,无需手动配置 API Key。

hermes kanban — 多代理协作看板系统。支持 20 多个子命令:
- initcreatelistshowassignlinkunlink
- commentcompleteblockunblockarchive
- tailwatchstatsrunslog
- dispatchdaemongc

看板使用 SQLite 持久化,支持多配置/多工作者协作。调度器可以在网关中自动运行,回收过期任务、推动就绪任务、分配工作者。

hermes pairing list/approve/revoke — 管理 DM 授权。控制哪些用户可以发送私信给代理。防止未经授权的用户访问代理能力。

hermes plugins list/install/remove — 插件管理。插件是扩展 Hermes 能力的轻量级方式,可以在 ~/.hermes/plugins/ 中安装自定义插件。

hermes secrets bitwarden ... — 集成 Bitwarden Secrets Manager 作为外部密钥存储。支持从 Bitwarden 读取 API Key 和配置文件。

hermes memory setup/status/off — 配置持久记忆系统。支持的后端包括:
- 内置 SQLite(默认,零配置)
- Honcho(开源记忆服务器)
- Mem0(记忆管理平台)
- Memory-based 工具调用

记忆系统包括两个维度:用户画像(用户偏好、角色、习惯)和工作记忆(环境细节、工具技巧)。关闭记忆:hermes memory off

hermes send — 通过消息网关发送一条独立消息到指定平台。适合脚本调用:hermes send -p telegram "Deployment complete"

hermes completion bash|zsh — 生成 shell 自动补全脚本。安装后可以在终端中输入 hermes 后按 Tab 查看命令和选项的自动补全提示。

hermes acp — 启动 ACP 服务器。ACP(Agent Communication Protocol)是 IDE 集成的标准协议。VS Code、Zed、JetBrains 等 IDE 可以通过 ACP 连接到 Hermes。

hermes claw migrate — 从 OpenClaw 迁移配置、会话和技能到 Hermes。简化了工具迁移的流程。

hermes uninstall — 完全卸载 Hermes Agent,包括配置、会话数据和技能。


十二、会话内斜杠命令

在交互式会话中,斜杠命令是最高频率的操作方式。输入 / 即可看到完整列表和提示。

会话控制命令

/new/reset — 开启全新会话,清除所有上下文和历史。当你需要从一个完全干净的状态开始时使用。

/clear — CLI 模式下清屏并新建会话。界面上的旧内容消失,但对话历史仍在会话数据库中。

/retry — 重新发送上一条消息。当模型生成失败、结果不符合预期或出现工具调用错误时使用。不会重置上下文,只是重试最后一次交互。

/undo — 撤销最近一次问答交换。删除模型最后一次回复和你的上一条消息,回到之前的状态。

/title [name] — 为当前会话命名。好的命名方便后续通过 --resume--continue 快速找回。不传参数时自动生成标题。

/compress — 手动触发上下文压缩。当会话较长、接近模型上下文窗口限制时,Hermes 会自动压缩。手动压缩可以在你感觉响应变慢时使用。

/stop — 终止所有后台运行的子代理进程和长时间任务。

/rollback [N] — 恢复到之前的文件系统检查点。时间机器功能,当实验性操作破坏了文件时使用。

/snapshot [sub] — 创建或恢复 Hermes 配置和状态的快照。方便在重大配置变更前备份。

/background — 在后台运行一个提示词任务。适合耗时操作,不阻塞当前会话。

/queue — 将提示词排入队列,在当前任务完成后自动执行。

/steer — 在不打断当前工具调用流程的情况下注入一条消息。消息会在下一次工具调用结果返回后插入。

/agents/tasks — 显示所有活跃的子代理和待执行/正在执行的任务。

/resume [name] — 恢复之前命名的会话。

/goal [text|sub] — 设置常驻目标。Hermes 会在多轮对话中持续努力完成。支持 status(查看目标状态)、pause(暂停)、resume(恢复)、clear(清除)子命令。适合设定长期任务目标。

/redraw — 刷新 TUI 界面。当界面显示异常时使用。

配置控制命令

/config — 在会话中查看当前配置关键项。

/model [name] — 显示当前模型,或切换模型。不传参数时显示当前模型,传名称时在会话中切换。

/personality [name] — 设置或切换代理人格设定。人格定义影响回复风格和语气。

/reasoning [level] — 设置推理链可见级别。从 none(完全隐藏)到 xhigh(极度详细)。show 显示推理、hide 隐藏。

/verbose — 循环切换详细信息输出级别:offnewallverbose

/voice [on|off|tts] — 语音模式控制。on 开启语音输入(自动语音识别)+ 语音输出(TTS);tts 仅开启语音输出;off 关闭。

/yolo — 在会话中切换危险命令审批绕过。相当于 --yolo 标志的运行时版本。

/busy [sub] — 控制 Hermes 工作时 Enter 键的行为:queue(将输入排入队列)、steer(在不中断的情况下输入)、interrupt(中断当前工作)、status(查看队列状态)。

/indicator [style] — 选择 TUI 忙碌指示器的风格:kaomoji(颜文字)、emoji(表情符号)、unicode(Unicode 符号)、ascii(ASCII 字符)。

/footer [on|off] — 切换消息网关在最终回复底部显示的运行时元数据脚注。

/skin [name] — 切换界面主题风格。

/statusbar — 切换 CLI 模式下的状态栏显示。

工具与技能命令

/tools — 在会话中查看和切换工具启用/禁用状态。

/toolsets — 列出所有可用的工具集。

/skills — 搜索和安装技能,无需退出当前会话。

/skill — 将指定技能加载到当前会话。

/reload-skills — 重新扫描 ~/.hermes/skills/ 目录,加载新增的技能、卸载已删除的技能。

/reload — 重新加载 .env 文件中的环境变量到当前运行的会话中。修改了 API Key 后无需重启。

/reload-mcp — 重新加载 MCP 服务器连接。添加或修改 MCP 服务器配置后使用。

/cron — 管理定时任务。支持列出、查看状态、暂停、恢复。

/curator [sub] — 后台技能生命周期维护。子命令:status(状态)、run(执行)、pin(固定)、unpin(解除固定)、archive(归档)、restore(恢复)、prune(修剪)、backup(备份)、rollback(回滚)。

/kanban [sub] — 多配置协作看板。支持查看任务、链接、评论。

/plugins — 列出当前会话中已加载的插件。

网关命令

/approve — 批准待审批的命令执行。在消息平台中使用时,Hermes 执行危险命令前会等待用户确认。

/deny — 拒绝待审批的命令执行。

/restart — 重启消息网关服务。

/sethome — 将当前聊天设置为默认频道。所有系统通知将发送至此。

/update — 升级 Hermes 到最新版本。

/topic [sub] — 管理 Telegram DM 话题会话功能。

/platforms/gateway — 显示所有已连接的消息平台状态。

实用工具命令

/branch/fork — 基于当前会话创建一个独立的副本。分支可以独立发展,不影响原会话。

/handoff — 将正在进行的会话转移到指定消息平台继续。例如从 CLI 切换到 Telegram。

/fast — 切换优先级/快速处理模式。在快速模式下,Hermes 使用更小的模型或更简化的推理链。

/browser — 打开 CDP(Chrome DevTools Protocol)浏览器连接,用于网页自动化。

/history — 在当前终端中回放整个对话历史。

/save — 将当前对话保存到指定文件中。

/copy [N] — 将最近 N 条(默认 1 条)回复复制到系统剪贴板。

/paste — 从剪贴板粘贴图片到当前会话。

/image — 从本地文件系统上传图片。

信息查询命令

/help — 显示当前版本的完整命令帮助。是最权威的参考来源。

/commands [page] — 分页浏览所有可用的斜杠命令及其说明。

/usage — 显示当前会话的 Token 使用统计——输入 Token、输出 Token、总计、成本估算。

/insights [days] — 跨会话的使用行为分析——调用频率、Token 趋势、工具使用分布。

/status — 实时会话状态——模型、提供商、上下文长度、Token 使用。

/profile — 显示当前配置信息。

/debug — 收集系统信息和日志,上传并返回可分享的调试链接。

退出命令

/quit/exit/q — 退出 Hermes CLI,结束当前会话。所有未保存的上下文将丢失(但会话记录已在数据库中持久化)。


十三、全局标志

这些标志适用于任何子命令之前,影响整个 Hermes 实例的行为:

  • --version, -V — 显示版本号
  • --resume, -r SESSION — 按 ID 恢复会话
  • --continue, -c [NAME] — 按名称恢复最近会话
  • --worktree, -w — 隔离工作目录,并行代理不冲突
  • --skills, -s SKILL — 预加载指定技能
  • --profile, -p NAME — 使用指定配置
  • --yolo — 跳过所有命令审批
  • --pass-session-id — 在系统提示中包含会话 ID
  • --ignore-rules — 跳过项目上下文文件(.hermes.md、AGENTS.md、CLAUDE.md、.cursorrules)和 SOUL.md 的自动注入

结语:命令体系的哲学

Hermes Agent 的 77 个命令背后体现了一种独特的设计哲学:分层抽象 + 渐进暴露

对于日常用户,只需记住 hermes 启动对话就够了。单次查询用 hermes chat -q。遇到问题用 hermes doctor。更换模型用 hermes model。这些核心命令覆盖了 80% 的使用场景。

对于进阶用户,模型切换、工具管理、技能安装、会话恢复提供了深度定制能力。你可以为不同的工作场景创建不同的配置,每个配置拥有独立的模型、工具、技能和记忆。

对于 DevOps 和团队场景,网关消息平台集成、cron 定时任务编排、看板多代理协作、配置管理、凭证池化,支撑起完整的工作流自动化体系。

这不是一份需要从头背诵的命令列表,而是一份参考手册——当你遇到特定需求时,找到对应的功能分类,定位到具体命令。每一条命令都针对一个明确的场景设计,只需要一次使用就能记住。

最后,记住三个黄金入口:
- 设置系统hermes setuphermes model
- 诊断问题hermes doctorhermes config check
- 探索所有能力:在终端运行 hermes --help 或在会话中输入 /help

Hermes Agent 的核心信念是:工具应该适应人,而不是人适应工具。这套命令体系正是这一理念的最好体现——它不要求你记住一切,但当你需要时,它总在那里。

发表评论