Hermes Agent 命令与案例详解

2026-05-12 11:26:04 李昊哲小课

Hermes Agent 命令与案例参考

本文档基于官方 GitHub 仓库 NousResearch/hermes-agent 的文档整理，所有内容均以官方文档为准。

1. CLI 命令参考

Hermes Agent 提供了一系列终端命令，用于启动、配置和管理代理。

全局入口点

hermes [global-options] <command> [subcommand/options]

全局选项

选项	描述
`--version`, `-V`	显示版本并退出
`--profile <name>`, `-p <name>`	选择要使用的 Hermes 配置文件
`--resume <session>`, `-r <session>`	按 ID 或标题恢复之前的会话
`--continue [name]`, `-c [name]`	恢复最近的会话，或恢复与标题匹配的最近会话
`--worktree`, `-w`	在隔离的 git 工作树中启动，用于并行代理工作流
`--yolo`	绕过危险命令批准提示
`--pass-session-id`	在代理的系统提示中包含会话 ID
`--tui`	启动 TUI 而不是经典 CLI
`--dev`	与 `--tui` 一起使用：通过 `tsx` 直接运行 TypeScript 源代码（供 TUI 贡献者使用）

顶级命令

命令	用途
`hermes chat`	与代理进行交互式或一次性聊天
`hermes model`	交互式选择默认提供商和模型
`hermes gateway`	运行或管理消息网关服务
`hermes setup`	交互式设置向导
`hermes whatsapp`	配置和配对 WhatsApp 桥接
`hermes auth`	管理凭证（添加、列出、删除、重置、设置策略）
`hermes login` / `logout`	已弃用 — 使用 `hermes auth`
`hermes status`	显示代理、认证和平台状态
`hermes cron`	检查和触发 cron 调度器
`hermes webhook`	管理动态 webhook 订阅以进行事件驱动激活
`hermes doctor`	诊断配置和依赖问题
`hermes dump`	可复制的设置摘要，用于支持/调试
`hermes debug`	调试工具 — 上传日志和系统信息以获取支持
`hermes backup`	将 Hermes 主目录备份到 zip 文件
`hermes import`	从 zip 文件恢复 Hermes 备份
`hermes logs`	查看、跟踪和过滤代理/网关/错误日志文件
`hermes config`	显示、编辑、迁移和查询配置文件
`hermes pairing`	批准或撤销消息配对代码
`hermes skills`	浏览、安装、发布、审核和配置技能
`hermes honcho`	管理 Honcho 跨会话内存集成
`hermes memory`	配置外部内存提供程序
`hermes acp`	将 Hermes 作为 ACP 服务器运行，用于编辑器集成
`hermes mcp`	管理 MCP 服务器配置并将 Hermes 作为 MCP 服务器运行
`hermes plugins`	管理 Hermes Agent 插件（安装、启用、禁用、删除）
`hermes tools`	按平台配置启用的工具
`hermes sessions`	浏览、导出、清理、重命名和删除会话
`hermes insights`	显示令牌/成本/活动分析
`hermes claw`	OpenClaw 迁移助手
`hermes dashboard`	启动 Web 仪表板以管理配置、API 密钥和会话
`hermes profile`	管理配置文件 — 多个隔离的 Hermes 实例
`hermes completion`	打印 shell 完成脚本（bash/zsh）
`hermes version`	显示版本信息
`hermes update`	拉取最新代码并重新安装依赖项
`hermes uninstall`	从系统中删除 Hermes

常用命令示例

# 启动交互式聊天
hermes
# 一次性查询
hermes chat -q "总结最新的 PR"
# 指定模型
hermes chat --provider openrouter --model anthropic/claude-sonnet-4.6
# 启用特定工具集
hermes chat --toolsets web,terminal,skills
# 安静模式（仅返回 JSON）
hermes chat --quiet -q "仅返回 JSON"
# 在隔离的 git 工作树中工作
hermes chat --worktree -q "审查此仓库并打开 PR"

2. 斜杠命令参考

在交互式 CLI 或消息平台中，可以使用斜杠命令。

会话管理

命令	描述
`/new` (别名: `/reset`)	开始新会话
`/clear`	清屏并开始新会话
`/history`	显示对话历史
`/save`	保存当前对话
`/retry`	重试上一条消息
`/undo`	删除最后一条用户/助手交换
`/title`	设置当前会话的标题
`/compress [focus topic]`	手动压缩对话上下文
`/rollback`	列出或恢复文件系统检查点
`/snapshot` (别名: `/snap`)	创建或恢复 Hermes 配置/状态快照
`/stop`	终止所有正在运行的后台进程
`/queue <prompt>` (别名: `/q`)	为下一轮排队提示（不中断当前代理响应）
`/resume [name]`	恢复之前命名的会话
`/status`	显示会话信息
`/agents` (别名: `/tasks`)	显示当前会话中的活动代理和运行任务
`/background <prompt>` (别名: `/bg`)	在单独的后台会话中运行提示
`/btw <question>`	使用会话上下文提出临时问题（无工具，不持久化）
`/plan [request]`	加载捆绑的 `plan` 技能以编写 markdown 计划
`/branch [name]` (别名: `/fork`)	分支当前会话（探索不同路径）

配置

命令	描述
`/config`	显示当前配置
`/model [model-name]`	显示或更改当前模型
`/provider`	显示可用提供商和当前提供商
`/personality`	设置预定义个性
`/verbose`	循环工具进度显示：关闭 → 新 → 全部 → 详细
`/fast [normal\|fast\|status]`	切换快速模式 — OpenAI 优先级处理 / Anthropic 快速模式
`/reasoning`	管理推理工作和显示
`/skin`	显示或更改显示皮肤/主题
`/statusbar` (别名: `/sb`)	切换上下文/模型状态栏的开关
`/voice [on\|off\|tts\|status]`	切换 CLI 语音模式和语音播放
`/yolo`	切换 YOLO 模式 — 跳过所有危险命令批准提示

工具与技能

命令	描述
`/tools [list\|disable\|enable] [name...]`	管理工具：列出可用工具，或禁用/启用特定工具
`/toolsets`	列出可用工具集
`/browser [connect\|disconnect\|status]`	管理本地 Chrome CDP 连接
`/skills`	从在线注册表搜索、安装、检查或管理技能
`/cron`	管理计划任务（列表、添加/创建、编辑、暂停、恢复、运行、删除）
`/reload-mcp` (别名: `/reload_mcp`)	从 config.yaml 重新加载 MCP 服务器
`/reload`	将 `.env` 变量重新加载到运行会话中
`/plugins`	列出已安装的插件及其状态

信息

命令	描述
`/help`	显示帮助消息
`/usage`	显示令牌使用情况、成本细分和会话持续时间
`/insights`	显示使用情况洞察和分析（最近 30 天）
`/platforms` (别名: `/gateway`)	显示网关/消息平台状态
`/paste`	附加剪贴板图像
`/copy [number]`	将最后一条助手响应复制到剪贴板
`/image <path>`	为下一条提示附加本地图像文件
`/terminal-setup [auto\|vscode\|cursor\|windsurf]`	TUI 专用：配置本地 VS Code 系列终端绑定
`/debug`	上传调试报告（系统信息 + 日志）并获取可共享链接
`/profile`	显示活动配置文件名称和主目录
`/gquota`	显示 Google Gemini Code Assist 配额使用情况（仅当 `google-gemini-cli` 提供商处于活动状态时可用）

退出

命令	描述
`/quit`	退出 CLI（也可用：`/exit`）

动态斜杠命令

命令	描述
`/<skill-name>`	将任何已安装的技能加载为按需命令
`/skills ...`	从注册表和官方可选技能目录中搜索、浏览、检查、安装、审核、发布和配置技能

3. 内置工具参考

Hermes Agent 提供了 53 个内置工具，按工具集分组。

浏览器工具集 (browser)

工具	描述
`browser_back`	在浏览器历史记录中导航回上一页
`browser_cdp`	发送原始 Chrome DevTools Protocol (CDP) 命令
`browser_click`	点击由快照中的引用 ID 标识的元素
`browser_console`	获取浏览器控制台输出和 JavaScript 错误
`browser_get_images`	获取当前页面上所有图像的列表及其 URL 和 alt 文本
`browser_navigate`	在浏览器中导航到 URL
`browser_press`	按下键盘键
`browser_scroll`	沿方向滚动页面
`browser_snapshot`	获取当前页面的基于文本的可访问性树快照
`browser_type`	将文本输入到由引用 ID 标识的输入字段中
`browser_vision`	截取当前页面的屏幕截图并使用视觉 AI 进行分析

文件工具集 (file)

工具	描述
`patch`	文件中的定向查找和替换编辑
`read_file`	读取文本文件（带行号和分页）
`search_files`	搜索文件内容或按名称查找文件
`write_file`	将内容写入文件，完全替换现有内容

终端工具集 (terminal)

工具	描述
`process`	管理使用 terminal(background=true) 启动的后台进程
`terminal`	在 Linux 环境中执行 shell 命令

网络工具集 (web)

工具	描述
`web_search`	搜索任何主题的网络信息
`web_extract`	从网页 URL 提取内容

其他重要工具

工具集	工具	描述
`clarify`	`clarify`	在继续之前向用户提问以获取澄清、反馈或决策
`code_execution`	`execute_code`	运行可以以编程方式调用 Hermes 工具的 Python 脚本
`cronjob`	`cronjob`	统一计划任务管理器
`delegation`	`delegate_task`	生成一个或多个子代理以在隔离上下文中处理任务
`memory`	`memory`	将重要信息保存到跨会话持久的内存中
`messaging`	`send_message`	向连接的消息平台发送消息，或列出可用目标
`session_search`	`session_search`	搜索过去对话的长期记忆
`skills`	`skill_manage`	管理技能（创建、更新、删除）
`skills`	`skill_view`	加载技能的完整内容或访问其链接的文件
`skills`	`skills_list`	列出可用技能（名称 + 描述）
`vision`	`vision_analyze`	使用 AI 视觉分析图像
`tts`	`text_to_speech`	将文本转换为语音音频

4. 技能目录

技能是 Hermes Agent 的可重用程序记忆，用于处理重复任务类型。以下是一些内置技能类别：

自主 AI 代理

autonomous-ai-agents/claude-code – 将编码任务委托给 Claude Code
autonomous-ai-agents/codex – 将编码任务委托给 OpenAI Codex CLI 代理
autonomous-ai-agents/hermes-agent – 使用和扩展 Hermes Agent 的完整指南
autonomous-ai-agents/opencode – 将编码任务委托给 OpenCode CLI 代理以进行功能实现

创意

creative/architecture-diagram – 生成软件系统的暗主题 SVG 图表
creative/ascii-art – 使用 pyfiglet（571 种字体）、cowsay 等生成 ASCII 艺术
creative/ascii-video – ASCII 艺术视频的生产流水线
creative/baoyu-comic – 支持多种艺术风格的知识漫画创建器
creative/baoyu-infographic – 使用 21 种布局类型生成专业信息图
creative/excalidraw – 使用 Excalidraw JSON 格式创建手绘风格图表
creative/ideation – 通过创意约束生成项目想法
creative/manim-video – 数学和技术动画的生产流水线
creative/p5js – 交互式和生成式视觉的生产流水线
creative/pixel-art – 将图像转换为具有硬件准确调色板的复古像素艺术
creative/popular-web-designs – 从真实网站提取的 54 个生产质量设计系统
creative/songwriting-and-ai-music – 歌曲创作技巧，AI 音乐生成提示（以 Suno 为重点）

数据科学

data-science/jupyter-live-kernel – 使用实时 Jupyter 内核进行有状态的迭代 Python 探索

DevOps

devops/webhook-subscriptions – 为事件驱动架构创建和管理 webhook 订阅

GitHub

github/codebase-inspection – 使用 pygount 检查和分析代码库以进行 LOC 计数
github/github-auth – 使用 git（通用）设置 GitHub 认证
github/github-code-review – 通过分析 git 差异来审查代码更改，留下内联评论
github/github-issues – 创建、管理、分类和关闭 GitHub 问题
github/github-pr-workflow – 完整的拉取请求生命周期 — 创建分支、提交更改、打开 PR、合并
github/github-repo-management – 克隆、创建、分支、配置和管理 GitHub 仓库

MLOps

mlops/huggingface-hub – Hugging Face Hub CLI (hf) — 搜索、下载和上传模型/数据集
mlops/evaluation/evaluating-llms-harness – 在 60+ 个学术基准上评估 LLM（MMLU、HellaSwag 等）
mlops/inference/llama-cpp – llama.cpp 本地 GGUF 推理 + HF Hub 模型发现
mlops/inference/obliteratus – 使用 OBLITERATUS 技术从开放权重 LLM 中移除拒绝行为
mlops/inference/outlines – 在生成过程中保证有效的 JSON/XML/代码结构
mlops/inference/serving-llms-vllm – 使用 vLLM 的 PagedAttention 提供高吞吐量的 LLM 服务
mlops/models/audiocraft-audio-generation – 用于音频生成的 PyTorch 库，包括文本到音乐
mlops/models/segment-anything-model – 用于零样本图像分割的基础模型
mlops/research/dspy – 使用声明式编程构建复杂的 AI 系统
mlops/training/axolotl – 使用 Axolotl 微调 LLM 的专家指南 — YAML 配置
mlops/training/fine-tuning-with-trl – 使用 TRL 通过强化学习微调 LLM — SFT、DPO、GRPO
mlops/training/unsloth – 使用 Unsloth 进行快速微调的专家指南 — 速度提升 2-5 倍

生产力

productivity/google-workspace – Gmail、日历、云端硬盘、联系人、表格和文档集成
productivity/linear – 通过 GraphQL API 管理 Linear 问题、项目和团队
productivity/maps – 位置情报 — 地理编码地点、反向地理编码坐标、计算路线
productivity/nano-pdf – 使用自然语言指令编辑 PDF
productivity/notion – 用于创建和管理页面、数据库和块的 Notion API
productivity/ocr-and-documents – 从 PDF 和扫描文档中提取文本
productivity/powerpoint – 在任何涉及 .pptx 文件的工作流中使用此技能

社交媒体

social-media/xurl – 通过 xurl（官方 X API CLI）与 X/Twitter 交互

软件开发

software-development/plan – Hermes 的计划模式 — 检查上下文，编写 markdown 计划
software-development/requesting-code-review – 预提交验证流水线 — 静态安全扫描、单元测试、linting
software-development/subagent-driven-development – 使用独立子代理执行实施计划时使用
software-development/systematic-debugging – 遇到任何错误、测试失败或意外行为时使用
software-development/test-driven-development – 在编写任何功能或错误修复的代码之前使用
software-development/writing-plans – 当您有多步骤项目的规范或要求时使用

5. 案例示例

案例 1：使用 GitHub 技能管理仓库

# 启动 Hermes 并加载 GitHub 技能
hermes chat --skills github-repo-management
# 在聊天中，您可以要求代理克隆仓库、创建分支等。

案例 2：使用创意技能生成图表

# 加载架构图技能
hermes chat --skills creative/architecture-diagram
# 请求生成系统架构图

案例 3：使用 MLOps 技能微调模型

# 加载 Axolotl 技能进行微调
hermes chat --skills mlops/training/axolotl
# 遵循技能指南设置微调配置

案例 4：使用计划技能进行项目规划

# 使用 /plan 斜杠命令
/plan 构建一个具有用户认证的 Web 应用程序
# 代理将生成详细的 markdown 计划

案例 5：使用浏览器工具进行网页自动化

# 启用浏览器工具集
hermes chat --toolsets browser
# 要求代理导航到网页并执行操作

6. 官方文档链接

GitHub 仓库: https://github.com/NousResearch/hermes-agent
官方文档: https://hermes-agent.nousresearch.com/docs/
CLI 命令参考: https://hermes-agent.nousresearch.com/docs/reference/cli-commands
斜杠命令参考: https://hermes-agent.nousresearch.com/docs/reference/slash-commands
工具参考: https://hermes-agent.nousresearch.com/docs/reference/tools-reference
技能目录: https://hermes-agent.nousresearch.com/docs/reference/skills-catalog
可选技能目录: https://hermes-agent.nousresearch.com/docs/reference/optional-skills-catalog

最后更新: 2025-04-23（基于官方文档最新内容）
注意：Hermes Agent 快速发展，请始终参考官方文档以获取最新信息。

到此这篇关于Hermes Agent 命令与案例详解的文章就介绍到这了,更多相关Hermes Agent 命令内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！