Hermes Agent 命令与案例详解

Written by

in

文章目录
  • 本文档基于官方 GitHub 仓库 NousResearch/hermes-agent 的文档整理,所有内容均以官方文档为准。
  • 目录
    • Hermes Agent 命令与案例参考
      • 1. CLI 命令参考
        • 全局入口点
        • 全局选项
        • 顶级命令
        • 常用命令示例
      • 2. 斜杠命令参考
        • 会话管理
        • 配置
        • 工具与技能
        • 信息
        • 退出
        • 动态斜杠命令
      • 3. 内置工具参考
        • 浏览器工具集 (browser)
        • 文件工具集 (file)
        • 终端工具集 (terminal)
        • 网络工具集 (web)
        • 其他重要工具
      • 4. 技能目录
        • 自主 AI 代理
        • 创意
        • 数据科学
        • DevOps
        • GitHub
        • MLOps
        • 生产力
        • 社交媒体
        • 软件开发
      • 5. 案例示例
        • 案例 1:使用 GitHub 技能管理仓库
        • 案例 2:使用创意技能生成图表
        • 案例 3:使用 MLOps 技能微调模型
        • 案例 4:使用计划技能进行项目规划
        • 案例 5:使用浏览器工具进行网页自动化
      • 6. 官方文档链接

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

      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"

      在交互式 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 ... 从注册表和官方可选技能目录中搜索、浏览、检查、安装、审核、发布和配置技能

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

      工具 描述
      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 进行分析

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

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

      工具 描述
      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 将文本转换为语音音频

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

      • 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/webhook-subscriptions – 为事件驱动架构创建和管理 webhook 订阅

      • 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/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 – 当您有多步骤项目的规范或要求时使用

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

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

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

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

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

      • 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 命令内容请搜索风君子博客以前的文章或继续浏览下面的相关文章,希望大家以后多多支持风君子博客!

      站内搜索