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
hermes chat --quiet -q "仅返回 JSON"
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 Codeautonomous-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、GRPOmlops/training/unsloth – 使用 Unsloth 进行快速微调的专家指南 — 速度提升 2-5 倍
生产力
productivity/google-workspace – Gmail、日历、云端硬盘、联系人、表格和文档集成productivity/linear – 通过 GraphQL API 管理 Linear 问题、项目和团队productivity/maps – 位置情报 — 地理编码地点、反向地理编码坐标、计算路线productivity/nano-pdf – 使用自然语言指令编辑 PDFproductivity/notion – 用于创建和管理页面、数据库和块的 Notion APIproductivity/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 – 预提交验证流水线 — 静态安全扫描、单元测试、lintingsoftware-development/subagent-driven-development – 使用独立子代理执行实施计划时使用software-development/systematic-debugging – 遇到任何错误、测试失败或意外行为时使用software-development/test-driven-development – 在编写任何功能或错误修复的代码之前使用software-development/writing-plans – 当您有多步骤项目的规范或要求时使用
5. 案例示例
案例 1：使用 GitHub 技能管理仓库
hermes chat --skills github-repo-management
案例 2：使用创意技能生成图表
hermes chat --skills creative/architecture-diagram
案例 3：使用 MLOps 技能微调模型
hermes chat --skills mlops/training/axolotl
案例 4：使用计划技能进行项目规划
/plan 构建一个具有用户认证的 Web 应用程序
案例 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 快速发展，请始终参考官方文档以获取最新信息。
18
0
已为社区贡献5条内容
所有评论(0)