Hermes Agent命令使用手册，从入门到精通

前面已经介绍了如何安装 Hermes Agent，但是我们大部分都是直接一个 hermes 启动命令之后就开始聊天，对于那些不熟悉命令使用起来确实不知道如何下手。

其实 Hermes Agent 内置了丰富的命令系统，可以让我们来方便使用它的强大功能，目前命令分为两大类：

CLI 命令：例如在终端直接运行 hermes <command>，用于配置、管理和启动。
交互式斜杠命令：在 hermes TUI 会话中或消息平台（Telegram、Discord 等）中输入，以 / 开头，支持自动补全和别名。

通过这些命令，您可以通过自然语言或结构化指令与智能体进行交互，执行任务、查询信息、管理配置等。

下面按照命令进行一下归类分组，方便我们记忆和使用。

核心交互命令

hermes

这是刚入门用的第一个命令，它可以启动交互式终端用户界面（TUI），进入与 Agent 的聊天会话。

            
            hermes                       # 启动交互式 TUI
hermes --continue            # 继续最近会话
hermes -c                    # 简写形式
hermes -c "会话名"            # 恢复指定标题的会话
hermes --resume <session_id> # 恢复指定 ID 的会话

hermes chat

进行单次或指定参数的 AI 对话，适合脚本调用或快速查询。

            
            hermes chat -q "你的问题内容"              # 单次查询
hermes chat -q "问题" --quiet              # 静默模式，适合脚本
hermes chat -q "问题" --model anthropic/claude-sonnet-4  # 指定模型
hermes chat -q "问题" --toolsets web,terminal  # 启用特定工具集
hermes chat -q "问题" --worktree           # 在独立 git worktree 中运行

配置与设置命令

hermes setup

运行配置向导，调整模型、API 密钥、网关等设置。

            
          
            hermes setup                 # 完整向导
hermes setup model           # 仅配置模型
hermes setup terminal        # 仅配置终端后端
hermes setup gateway         # 仅配置消息平台
hermes setup tools           # 仅配置工具
hermes setup agent           # 仅配置 Agent 行为
hermes setup --non-interactive  # 非交互模式，使用默认值
hermes setup --reset         # 重置为默认配置后再设置

          

hermes config

查看、编辑和查询配置文件。

            
          
            hermes config                # 显示当前配置
hermes config edit           # 编辑配置文件
hermes config set <key> <value>  # 设置配置项
hermes config set terminal.backend docker  # 设置 Docker 沙箱 [^36^]
hermes config get <key>      # 获取配置项
hermes config migrate        # 迁移配置

          

hermes model

交互式选择或切换默认 AI 模型和提供商。

hermes model # 交互式选择模型

hermes tools

查看、启用或禁用可用工具集（网页搜索、终端执行、技能等）。

            
            hermes tools  # 交互式配置工具
hermes tools --platform cli  # 配置 CLI 平台的工具

认证与凭证管理

hermes auth

管理凭证、API 密钥和 OAuth 登录，支持同一提供商的多密钥轮换。

            
          
            hermes auth  # 交互式凭证管理向导
hermes auth list   # 列出所有凭证池
hermes auth list openrouter  # 列出特定提供商的凭证
hermes auth add openrouter --api-key sk-or-v1-xxx  # 添加 API 密钥
hermes auth add anthropic --type oauth            # 添加 OAuth 凭证
hermes auth remove openrouter 2                   # 移除指定凭证
hermes auth reset openrouter   # 清除凭证冷却状态

          

注意：hermes login 和 hermes logout 已弃用，请使用 hermes auth。

消息网关命令

hermes gateway

启动或配置消息网关，支持多平台接入。

            
            hermes gateway               # 启动网关服务（前台运行）
hermes gateway setup         # 配置 Telegram、Discord 等平台

hermes whatsapp

配置和配对 WhatsApp 桥接。

            
            hermes whatsapp              # 运行 WhatsApp 配对流程，包括 QR 码扫描

hermes pairing

管理消息平台的配对请求。

            
            hermes pairing list # 显示待处理和已批准的用户
hermes pairing approve telegram <code>  # 批准配对码
hermes pairing revoke telegram <user-id> # 撤销用户访问权限
hermes pairing clear-pending # 清除待处理配对码

会话管理命令

hermes sessions

管理对话会话（列出、导出、重命名、删除）。

            
            hermes sessions list         # 列出所有会话
hermes sessions rename <id> "新标题"  # 重命名会话
hermes sessions delete <id>  # 删除会话
hermes sessions export <id>  # 导出会话
hermes sessions prune        # 清理旧会话

配置文件（Profile）命令

hermes profile

管理配置 profile（隔离记忆、技能和设置），支持多实例运行。

            
          
            hermes profile list          # 列出所有配置文件
hermes profile use <name>    # 切换到指定配置文件
hermes profile create <name> # 创建新配置文件
hermes profile create <name> --clone      # 克隆当前配置（仅配置）
hermes profile create <name> --clone-all  # 克隆所有内容（包括记忆、会话）
hermes profile create <name> --clone-from <source>  # 从指定源克隆
hermes profile delete <name> # 删除配置文件
hermes profile show <name>   # 显示配置文件详情
hermes profile export <name> # 导出配置文件为 tar.gz
hermes profile import <file> # 从 tar.gz 导入配置文件
hermes profile alias <name>  # 重新生成 shell 别名
hermes profile rename <old> <new>  # 重命名配置文件

          

提示：创建 profile 后会自动生成命令别名（如 coder 对应 hermes -p coder）。

技能管理命令

hermes skills

浏览、管理和调用学习到的可复用技能。

            
          
            hermes skills browse         # 浏览技能注册表
hermes skills browse --source official  # 浏览官方技能
hermes skills search <关键词> # 搜索技能
hermes skills inspect <skill> # 预览技能（不安装）
hermes skills install <skill> # 安装技能
hermes skills install <skill> --force  # 强制安装（覆盖策略检查）
hermes skills list           # 列出已安装技能
hermes skills check          # 检查技能更新
hermes skills update         # 更新技能到最新版
hermes skills uninstall <skill>  # 卸载技能
hermes skills publish <skill>    # 发布技能到注册表
hermes skills config         # 按平台配置技能启用/禁用
hermes skills tap <url>      # 添加自定义技能源

          

诊断与维护命令

hermes doctor

诊断系统环境、配置问题和依赖检查。

            
            hermes doctor          # 运行诊断
hermes doctor --fix    # 尝试自动修复问题

hermes dump

生成可复制的设置摘要，用于技术支持/调试。

hermes dump  # 显示配置摘要（API 密钥已脱敏）

适用场景：报告 GitHub issue、在 Discord 求助、快速检查配置。

hermes debug

上传调试信息（日志和系统信息）用于技术支持。

hermes debug  # 上传调试信息

hermes logs

查看、跟踪和过滤日志文件。

            
          
            hermes logs                  # 显示最近 50 行 agent 日志
hermes logs -f               # 实时跟踪日志
hermes logs gateway -n 100   # 显示最近 100 行网关日志
hermes logs --level WARNING --since 1h  # 过去 1 小时的警告
hermes logs --session abc123   # 按会话 ID 过滤
hermes logs errors --since 30m # 过去 30 分钟的错误
hermes logs list             # 列出所有日志文件

          

hermes status

显示 Agent、认证和平台运行状态。

            
            hermes status                # 显示状态
hermes status --all          # 显示所有详情（可分享格式，已脱敏）
hermes status --deep         # 深度检查（耗时较长）

hermes backup / hermes import

备份和恢复 Hermes 数据。

            
            hermes backup                # 备份配置、会话、技能和记忆到 zip 文件
hermes import <backup.zip>   # 从备份恢复

定时任务与 Webhook

hermes cron

管理定时任务调度器。

            
          
            hermes cron list             # 列出所有定时任务
hermes cron create "每天检查邮件" --schedule "0 9 * * *"  # 创建任务
hermes cron edit <id>         # 编辑任务
hermes cron pause <id>        # 暂停任务
hermes cron resume <id>       # 恢复任务
hermes cron run <id>          # 立即运行任务
hermes cron remove <id>       # 删除任务
hermes cron status            # 检查调度器状态
hermes cron tick              # 运行一次到期的任务并退出

          

hermes webhook

管理动态 Webhook 订阅（事件驱动激活）。

            
            hermes webhook subscribe <name> --prompt "处理 {event.type}"  # 创建订阅
hermes webhook list            # 列出所有订阅
hermes webhook remove <name>   # 删除订阅
hermes webhook test <name>     # 测试订阅

集成与扩展命令

hermes mcp

管理 MCP（Model Context Protocol）服务器配置。

            
            hermes mcp list              # 列出 MCP 服务器
hermes mcp add <name>        # 添加 MCP 服务器
hermes mcp remove <name>     # 移除 MCP 服务器
hermes mcp serve             # 将 Hermes 作为 MCP 服务器运行（供 Claude Desktop、Cursor 等使用）

hermes acp

将 Hermes 作为 ACP（Agent Communication Protocol）服务器运行，用于编辑器集成。

hermes acp  # 启动 ACP 服务器

hermes honcho

管理 Honcho 跨会话记忆集成。

hermes honcho  # 配置 Honcho 记忆

hermes memory

配置外部记忆提供商。

hermes memory  # 配置记忆提供商

hermes plugins

管理 Hermes Agent 插件。

            
            hermes plugins list          # 列出插件
hermes plugins install <name>  # 安装插件
hermes plugins enable <name>   # 启用插件
hermes plugins disable <name>  # 禁用插件
hermes plugins remove <name>   # 移除插件

其他实用命令

hermes insights

显示 Token/成本/活动分析。

hermes insights  # 显示使用分析

hermes claw

OpenClaw 迁移助手，方便把 OpenClaw 配置迁移到 Hermes

            
            hermes claw          # 迁移 OpenClaw 配置
hermes claw migrate  # 执行迁移

hermes dashboard

启动 Web 仪表板（管理配置、API 密钥和会话）。

            
            hermes dashboard             # 启动本地 Web 服务器并打开浏览器
hermes dashboard --port 8080 # 自定义端口
hermes dashboard --host 0.0.0.0  # 绑定到所有接口
hermes dashboard --no-open   # 不自动打开浏览器

前提条件：需要安装 pip install hermes-agent[web]（FastAPI + Uvicorn）。

hermes completion

生成 shell 自动补全脚本。

            
            hermes completion bash       # 生成 Bash 补全脚本
hermes completion zsh        # 生成 Zsh 补全脚本

hermes version

显示版本信息。

hermes version   # 显示 Hermes Agent 版本

hermes update

更新 Hermes 到最新版本。

hermes update  # 更新到最新版本

hermes uninstall

卸载 Hermes Agent。

            
            hermes uninstall         # 卸载 Hermes
hermes uninstall --full  # 同时删除配置和数据
hermes uninstall --yes   # 无需确认直接卸载

交互式斜杠命令

前面介绍的命令是终端的顶级命令，下面这些是要进入 hermes TUI 会话或消息平台（Telegram、Discord 等）中才能使用，输入以 / 开头的命令。

命令不区分大小写，支持前缀匹配（如 /h 自动匹配 /help）。

通用命令（TUI 和 Gateway 都支持）

命令比较简单，我这边直接整理成表格方便阅读。

命令	描述
`/help`	显示所有可用命令列表和帮助
`/new`	开始新会话，清空历史记录
`/model`	查看或切换当前使用的 AI 模型。可选的参数为 `[provider/model]`。
`/usage`	查看当前会话 Token 使用情况
`/insights`	显示使用分析和统计。可选的参数为 `[days]`。
`/skills`	浏览或调用已学习的技能。可选的参数为 `[skill-name]`。
`/compress`	手动压缩会话上下文，节省 Token
`/retry`	重试生成上一次回复
`/undo`	撤销最近一次交互
`/memory`	查看 Agent 的持久记忆
`/personality`	切换 Agent 的人格模式
`/stop`	中断正在运行的后台任务或工具执行
`/title`	为当前会话设置自定义标题。参数为 `<标题>`。
`/verbose`	切换工具执行的输出详细程度（off → new → all → verbose）

TUI专用命令

命令	描述
`/quit`	退出 CLI 会话。别名：`/exit`, `/q`。
`/clear`	清屏。
`/history`	显示会话历史。
`/save`	保存当前会话。
`/config`	查看或编辑配置。
`/prompt`	查看或编辑当前系统提示词。
`/statusbar`	切换状态栏显示。
`/tools`	列出当前启用的工具。
`/toolsets`	列出可用工具集。
`/platforms`	显示网关和平台状态。别名：`/gateway`。
`/paste`	检查剪贴板图片并附加到下一条消息。
`/skin`	切换 CLI 主题。
`/cron`	管理定时任务。
`/browser`	浏览器自动化控制。
`/plugins`	管理插件。

Gateway专用命令

命令	描述
`/status`	显示当前会话信息、Agent 及平台状态
`/sethome` 或 `/set-home`	将当前聊天标记为通知主频道
`/approve`	批准待处理的危险命令。可跟 session 或 always 参数。
`/deny`	拒绝待处理的危险命令
`/update`	更新 Hermes Agent 到最新版本
`/commands`	浏览所有命令和技能。可跟页码参数。

动态技能命令

每个安装的技能都会自动注册为斜杠命令：

            
            /gif-search funny cats                    # 使用 gif-search 技能
/axolotl help me fine-tune Llama 3       # 使用 axolotl 技能
/github-pr-workflow create a PR           # 使用 GitHub PR 工作流技能
/excalidraw                               # 仅输入技能名，让 Agent 询问需求

快速命令

我们还可以在 config.yaml 中定义的快捷命令，例如代码审查，部署等

            
            quick_commands:
  review: "Review my latest git diff and suggest improvements"
  deploy: "Run the deployment script at scripts/deploy.sh"
  morning: "Check my calendar and summarize today's priorities"

然后在 CLI 中直接输入：

            
            /review      # 执行定义的 review 提示词
/deploy      # 执行部署脚本
/morning     # 执行晨间简报

全局选项

所有命令都支持以下全局选项：

            
          
            hermes --version, -V         # 显示版本
hermes --profile <name>, -p <name>  # 指定配置文件
hermes --resume <session>, -r <session>  # 恢复指定会话
hermes --continue [name], -c [name]  # 继续最近会话
hermes --worktree, -w        # 在独立 git worktree 中启动
hermes --yolo                # 绕过危险命令审批提示

          

最佳实践

自动补全：输入 / 后按 Tab 键可查看所有可用斜杠命令。
前缀匹配：输入 /mod 会自动匹配 /model，输入 /com 匹配 /compress。
平台差异：Discord 中使用 ! 语法（如 !new、!status），Telegram 中使用 / 语法。
配置文件隔离：使用 hermes profile create 创建工作/个人隔离环境，避免配置冲突。
安全建议：生产环境使用 hermes config set terminal.backend docker 启用 Docker 沙箱执行终端命令。
日志排查：遇到问题先运行 hermes doctor，需要分享诊断信息时使用 hermes dump。
定期备份：使用 hermes backup 定期备份配置和会话数据。