sidebar_position: 1 title: “CLI Commands Reference” description: “Authoritative reference for Hermes terminal commands and command families”

CLI 命令参考

本页面介绍了您在终端中可使用的命令行指令。

有关聊天界面内的斜杠命令，请参阅 斜杠命令参考。

全局入口点

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

全局选项

顶层命令

hermes chat

hermes chat [options]

常用选项：

示例：

hermes
hermes chat -q "Summarize the latest PRs"
hermes chat --provider openrouter --model anthropic/claude-sonnet-4.6
hermes chat --toolsets web,terminal,skills
hermes chat --quiet -q "Return only JSON"
hermes chat --worktree -q "Review this repo and open a PR"
hermes chat --ignore-user-config --ignore-rules -q "Repro without my personal setup"
hermes chat --safe-mode -q "Is this bug mine or Hermes'?"

hermes -z <prompt> — 脚本化单次调用模式

对于通过程序方式调用的用户（如Shell脚本、CI系统、cron作业，或是向代理传递提示语的父进程），hermes -z 是最纯粹的单次调用入口：输入一个提示语，即可得到最终响应文本，标准输出和标准错误均不会输出其他内容。没有欢迎横幅、没有加载指示器、没有工具预览信息，也没有Session:行——仅有以纯文本形式呈现的代理最终回复。

hermes -z "What's the capital of France?"
# → Paris.

# Parent scripts can cleanly capture the response:
answer=$(hermes -z "summarize this" < /path/to/file.txt)

单次运行覆盖设置（不会修改 ~/.hermes/config.yaml 文件）：

hermes -z "…" --provider openrouter --model openai/gpt-5.5
# or:
HERMES_INFERENCE_MODEL=anthropic/claude-sonnet-4.6 hermes -z "…"

相同的智能体、相同的工具、相同的技能——仅去除了所有交互式及界面装饰层。如果需要在对话记录中同时显示工具的输出结果，请改用 hermes chat -q 命令；而 -z 明确用于表示“我只想要最终答案”。

hermes model

交互式提供者与模型选择器。该命令用于添加新的提供者、配置 API 密钥以及执行 OAuth 流程。 应在终端中运行此命令，而非在正在进行的 Hermes 对话会话内部执行。

hermes model

在以下情况下请使用此功能：

• 添加新的提供方（如 OpenRouter、Anthropic、Copilot、DeepSeek 或自定义提供方等）
• 登录基于 OAuth 的提供方（如 Anthropic、Copilot、Codex、Nous Portal）
• 输入或更新 API 密钥
• 从特定提供方的模型列表中选择
• 配置自定义/自托管的端点
• 将新默认设置保存到配置文件中

:::warning hermes model 与 /model 的区别 —— 请务必了解 hermes model（在终端中运行，独立于任何 Hermes 会话）是完整的提供方设置向导。它能够添加新的提供方、执行 OAuth 流程、提示输入 API 密钥以及配置端点。

而 /model（在正在运行的 Hermes 聊天会话中输入）仅能在您已设置的提供方和模型之间切换，无法添加新提供方、执行 OAuth 流程或提示输入 API 密钥。

如果您需要添加新的提供方：请先退出当前的 Hermes 会话（使用 Ctrl+C 或 /quit），然后在终端命令行中运行 hermes model。

::

/model 斜杠命令（会话进行中）

无需离开当前会话，即可在已配置的模型之间切换：

/model                              # Show current model and available options
/model claude-sonnet-4              # Switch model (auto-detects provider)
/model zai:glm-5                    # Switch provider and model
/model custom:qwen-2.5              # Use model on your custom endpoint
/model custom                       # Auto-detect model from custom endpoint
/model custom:local:qwen-2.5        # Use a named custom provider
/model openrouter:anthropic/claude-sonnet-4  # Switch back to cloud

默认情况下，对 /model 的更改仅适用于当前会话。若要将该更改永久保存到 config.yaml 中，请添加 --global 参数：

/model claude-sonnet-4 --global     # Switch and save as new default

:::info 如果我只看到 OpenRouter 模型怎么办？ 如果您仅配置了 OpenRouter，那么 /model 命令将只会显示 OpenRouter 的模型。若要添加其他提供商（如 Anthropic、DeepSeek、Copilot 等），请退出当前会话，然后通过终端运行 hermes model 命令。

::

提供商及基础 URL 的更改会自动保存到 config.yaml 文件中。当切换离开自定义端点时，旧的基准 URL 会被清除，以避免其影响其他提供商的连接。

hermes gateway

hermes gateway <subcommand>

子命令：

选项：

hermes gateway enroll 命令支持 --token、--connector-url、--gateway-id 和 --wake-url 参数。它会将注册令牌与连接器进行交换，然后将生成的 GATEWAY_RELAY_ID、GATEWAY_RELAY_SECRET、GATEWAY_RELAY_DELIVERY_KEY、可选的 GATEWAY_RELAY_URL，以及当提供了 --wake-url 时的 GATEWAY_RELAY_WAKE_URL 值写入当前激活配置文件的 .env 文件中。

::提示 WSL 用户 建议使用 hermes gateway run 而非 hermes gateway start——WSL 环境的 systemd 支持并不可靠。为确保设置持久化，可将其封装在 tmux 中运行：tmux new -s hermes 'hermes gateway run'。更多详情请参阅 WSL 常见问题。

::

hermes lsp

hermes lsp <subcommand>

用于管理语言服务器协议集成。LSP会在后台运行真正的语言服务器（如pyright、gopls、rust-analyzer等），并将这些服务器提供的诊断信息传递给write_file和patch函数所使用的写后检查功能。该功能的启用以检测是否处于Git工作区为条件——仅当当前工作目录或正在编辑的文件位于Git工作树中时，LSP才会启动。

子命令：

如需完整指南、支持的语言列表以及各类配置选项，请参阅LSP — 语义诊断。

hermes setup

hermes setup [model|tts|terminal|gateway|tools|agent] [--non-interactive] [--reset] [--quick] [--reconfigure] [--portal]

最简便的路径： 使用命令 hermes setup --portal — 通过 OAuth 登录 Nous Portal，即可一次性完成配置并启用工具网关。

首次运行时： 程序会启动首次配置向导。

已配置过的用户： 直接进入完整的重新配置向导 — 每个提示项都会以当前设置值作为默认值，按回车键即可保留该值，或输入新值。无需菜单导航。

如需直接跳转至特定配置板块而非完整向导：

可选参数：

hermes portal

hermes portal [status|open|tools]

可检查 Nous Portal 的认证状态、Tool Gateway 的路由情况，并跳转至订阅页面。若不指定子命令，则会执行 status 操作。

如需配置 Gateway 本身，请参阅 Tool Gateway。关于一次性设置流程，请参考上文中的 hermes setup --portal 命令。

hermes whatsapp

hermes whatsapp

执行 WhatsApp 配对/设置流程，包括模式选择与二维码配对功能。

hermes slack

hermes slack manifest              # print manifest to stdout
hermes slack manifest --write      # write to ~/.hermes/slack-manifest.json
hermes slack manifest --slashes-only  # just the features.slash_commands array

该工具会生成一个 Slack 应用清单文件，将 COMMAND_REGISTRY 中的所有网关命令（如 /btw、/stop、/model 等）都注册为一级 Slack 斜杠命令——从而实现与 Discord 和 Telegram 的功能对等。只需将生成的输出内容粘贴到您的 Slack 应用配置页面：https://api.slack.com/apps → 所选应用 → Features → App Manifest → Edit，最后点击 Save 即可。如果权限范围或斜杠命令发生变更，Slack 会提示您重新安装应用。

在执行 hermes update 后，建议再次运行 hermes slack manifest --write，以便获取新增的命令。

hermes send

hermes send --to <target> "message text"
hermes send --to <target> --file <path>
echo "message" | hermes send --to <target>
hermes send --list [platform]

无需启动代理或网关循环，即可向已配置的消息平台发送一次性消息。该功能会复用网关中已配置的凭证（~/.hermes/.env 和 ~/.hermes/config.yaml），因此操作脚本、定时任务、CI 钩子以及监控进程都无需为每个平台重新实现 REST 客户端，即可发送状态更新。

对于基于机器人令牌的平台（Telegram、Discord、Slack、Signal、短信、WhatsApp-CloudAPI），无需运行网关——hermes send 直接与这些平台的 REST 接口通信。而那些需要持久适配器的插件平台则仍需运行中的网关。

如果既未提供位置参数 message，也未使用 --file，则当输入端不是 TTY 时，hermes send 会从标准输入读取内容。退出码含义：0 表示成功，1 表示发送或后端处理失败，2 表示用法错误。

发送图片及其他媒体文件

--file 仅用于文本类型的消息内容。若要将图片、文档、视频或音频文件作为平台原生附件发送，可在消息文本中使用 MEDIA:<本地路径> 指令来引用该文件：

hermes send --to telegram "MEDIA:/tmp/screenshot.png"
hermes send --to telegram "Build chart for today MEDIA:/tmp/chart.png"   # with caption
hermes send --to discord:#ops "MEDIA:/tmp/report.pdf"

默认情况下，图片文件会以照片形式发送（如 Telegram 等平台会对这些图片进行重新压缩）。若希望以未压缩的文件附件形式发送，可在消息中添加 [[as_document]] 标签。

hermes send --to telegram "[[as_document]] MEDIA:/tmp/screenshot.png"

示例：

hermes send --to telegram "deploy finished"
echo "RAM 92%" | hermes send --to telegram:-1001234567890
hermes send --to discord:#ops --file /tmp/report.md
hermes send --to slack:#eng --subject "[CI]" --file build.log
hermes send --list                  # all platforms
hermes send --list telegram         # filter by platform

hermes secrets

hermes secrets bitwarden <subcommand>
hermes secrets bw <subcommand>          # short alias

在进程启动时，可从外部密钥管理器获取 API 密钥，而无需将其存储在 ~/.hermes/.env 文件中。目前支持 Bitwarden Secrets Manager。完整指南请参阅：Bitwarden 集成。

bitwarden（别名 bw）子命令：

hermes migrate

hermes migrate <type>

诊断当前有效的 config.yaml 文件，并（可选地）重新编写该文件，以替换那些已停止使用的模型或过时的设置。在进行任何重写操作之前，系统会先创建原始 config.yaml 的带时间戳备份（如需跳过此步骤，请使用 --no-backup 参数）。

迁移子命令的常用参数：

请注意，此命令与 hermes claw migrate（将 OpenClaw 配置一次性导入 Hermes）不同——hermes migrate 才是用于重写配置文件的高级命令。

hermes proxy

hermes proxy <subcommand>

运行一个本地版的 OpenAI 兼容 HTTP 服务器，该服务器可将请求转发至经过 OAuth 认证的上游服务提供商（例如 Nous Portal、xAI）。外部应用可使用任意承载令牌指向此代理；在数据传出时，代理会自动附加您的真实 OAuth 凭证。详细指南请参阅 订阅代理。

hermes security

hermes security <subcommand>

可针对 OSV.dev 执行按需漏洞扫描。扫描范围包括 Hermes 虚拟环境（通过 PyPI 安装的版本）、位于 ~/.hermes/plugins/ 下由插件声明的 Python 依赖项，以及 config.yaml 中指定的固定 npx/uvx MCP 服务器。不会扫描全局安装的包或编辑器/浏览器扩展程序。

audit 的标志选项：

hermes login / hermes logout (已废弃)

:::caution hermes login 已被移除。如需管理 OAuth 凭证，请使用 hermes auth；选择提供方则可使用 hermes model；如需进行完整交互式设置，则可使用 hermes setup。

::

hermes auth

用于管理同一提供方的凭证池以实现密钥轮换。详细文档请参阅 凭证池。

hermes auth                                              # Interactive wizard
hermes auth list                                         # Show all pools
hermes auth list openrouter                              # Show specific provider
hermes auth add openrouter --api-key sk-or-v1-xxx        # Add API key
hermes auth add anthropic --type oauth                   # Add OAuth credential
hermes auth remove openrouter 2                          # Remove by index
hermes auth reset openrouter                             # Clear cooldowns
hermes auth status anthropic                             # Show auth status for a provider
hermes auth logout anthropic                             # Log out and clear stored auth state
hermes auth spotify                                      # Authenticate Hermes with Spotify via PKCE

子命令包括：add、list、remove、reset、status、logout、spotify。若未指定任何子命令，则会启动交互式管理向导。

hermes status

hermes status [--all] [--deep]

hermes cron

hermes cron <list|create|edit|pause|resume|run|remove|status|tick>

Cron 触发器可通过 cron.provider 配置键进行插件化扩展。保持该值为空（即默认值）时，将使用内置的进程内计时器。若将其设置为 chronos（一种由 NAS 管理、适用于零扩展规模托管网关的提供者），则需通过 cron.chronos.* 相关键值（如 portal_url、callback_url、expected_audience、nas_jwks_url）进行配置；或者可以在 plugins/cron/<名称>/ 或 $HERMES_HOME/plugins/<名称>/ 下自定义提供者名称。如果指定的提供者未知或不可用，系统会回退到内置触发器，因此始终不会出现没有触发器的状况。详情请参阅 Cron 内部机制 文档。

hermes kanban

hermes kanban [--board <slug>] <action> [options]

支持多配置文件、多项目的协作看板功能。每次安装均可创建多个看板（每个项目、仓库或域名对应一个看板）；每个看板均为独立的队列，拥有自己的 SQLite 数据库及调度器作用域。新安装时会自动生成一个名为 default 的看板，为兼容旧版本，其数据库位于 ~/.hermes/kanban.db；其他看板的数据库则存放在 ~/.hermes/kanban/boards/<slug>/kanban.db 中。内置在网关中的调度器会定期遍历所有看板。

全局标志（适用于以下所有操作）：

这是供人类操作或脚本使用的接口。 由调度器生成的 Agent 工作进程会通过专用的 kanban_* 工具集（如 kanban_show、kanban_complete、kanban_block、kanban_create、kanban_link、kanban_comment、kanban_heartbeat；编排型配置文件还包含 kanban_list 和 kanban_unblock）来操作看板，而无需直接调用 hermes kanban 命令。这些工作进程的环境中会固定设置 HERMES_KANBAN_BOARD，因此它们无法看到其他看板。

示例：

# Create a second board and put a task on it without switching away.
hermes kanban boards create atm10-server --name "ATM10 Server" --icon 🎮
hermes kanban --board atm10-server create "Restart server" --assignee ops

# Switch the active board for subsequent calls.
hermes kanban boards switch atm10-server
hermes kanban list                  # shows atm10-server tasks

# Archive a board (recoverable) or hard-delete it.
hermes kanban boards rm atm10-server
hermes kanban boards rm atm10-server --delete

看板决议顺序（优先级从高到低）为：--board <slug> 参数 → HERMES_KANBAN_BOARD 环境变量 → ~/.hermes/kanban/current 文件 → 默认值。

所有操作均可在网关中以斜杠命令的形式执行（如 /kanban …），支持的参数完全一致——包括 boards 子命令以及 --board 参数。

有关完整设计细节，包括与 Cline Kanban / Paperclip / NanoClaw / Gemini Enterprise 的对比、八种协作模式、四种用户场景以及并发正确性证明，可查阅仓库中的 docs/hermes-kanban-v1-spec.pdf 文件或 看板用户指南。

hermes project

hermes project <create|list|show|add-folder|remove-folder|rename|set-primary|use|archive|restore|bind-board>

项目是由用户命名的工作空间，可涵盖多个文件夹或代码仓库。它们是桌面会话分组的基准，而当与看板绑定后，还能为任务提供规范的工作树结构与分支命名规则。项目状态会针对不同用户配置独立保存。

hermes webhook

hermes webhook <subscribe|list|remove|test>

用于管理基于事件驱动的智能体激活所需的动态 Webhook 订阅功能。首先需要在配置中启用 Webhook 功能——若未配置，则会输出相应的设置指引。

hermes webhook subscribe

hermes webhook subscribe <name> [options]

订阅信息会保存在 ~/.hermes/webhook_subscriptions.json 文件中，通过 webhook 适配器可实现热加载，无需重启网关。

hermes doctor

hermes doctor [--fix]

hermes dump

hermes dump [--show-keys]

会输出关于您整个Hermes配置的简洁纯文本摘要。该格式专为在Discord、GitHub问题帖或Telegram中寻求帮助时复制粘贴而设计——不包含ANSI颜色，也无特殊格式，仅有原始数据。

包含的内容

示例输出

--- hermes dump ---
version:          0.8.0 (2026.4.8) [af4abd2f]
os:               Linux 6.14.0-37-generic x86_64
python:           3.11.14
openai_sdk:       2.24.0
profile:          default
hermes_home:      ~/.hermes
model:            anthropic/claude-opus-4.6
provider:         openrouter
terminal:         local

api_keys:
  openrouter           set
  openai               not set
  anthropic            set
  nous                 not set
  firecrawl            set
  ...

features:
  toolsets:           all
  mcp_servers:        0
  memory_provider:    built-in
  gateway:            running (systemd)
  platforms:          telegram, discord
  cron_jobs:          3 active / 5 total
  skills:             42

config_overrides:
  agent.max_turns: 250
  compression.threshold: 0.85
  display.streaming: True
--- end dump ---

适用场景

• 在 GitHub 上报告错误——将输出内容粘贴到问题描述中
• 在 Discord 中寻求帮助——以代码块形式分享该内容
• 对比自己的配置与他人的配置
• 当程序出现异常时进行快速排查

:::提示 hermes dump 是专为内容共享而设计的工具。如需进行交互式诊断，请使用 hermes doctor；若需要可视化概览，则可使用 hermes status。

::

hermes debug

hermes debug share [options]

将调试报告（系统信息+近期日志）上传至粘贴服务后，即可获取一个可分享的链接。此功能非常适合快速提交支持请求——报告中包含了辅助人员诊断问题所需的所有信息。

该报告包含系统信息（操作系统、Python版本、Hermes版本），以及近期来自代理、网关、GUI/控制台和桌面端的日志（每个文件大小上限为512 KB），还会显示经过遮蔽处理的API密钥状态。默认情况下，上传内容会进行遮蔽处理，以避免包含敏感信息。

默认情况下，系统会按顺序尝试使用公共粘贴服务：paste.rs、dpaste.com。而使用--nous选项时，会将相同的调试数据包上传至Nous私有的诊断存储系统中；此时返回的查看链接仅供Nous团队使用，并且在14天后会自动删除。

示例

hermes debug share              # Upload debug report, print URL
hermes debug share --lines 500  # Include more log lines
hermes debug share --expire 30  # Keep paste for 30 days
hermes debug share --nous       # Upload a private diagnostics bundle for Nous support
hermes debug share --local      # Print report to terminal (no upload)

hermes backup 命令

hermes backup [options]

将您的 Hermes 配置、技能、会话及数据打包为 ZIP 压缩文件。此备份不会包含 hermes-agent 代码库本身。

该备份采用 SQLite 的 backup() API 进行安全复制，因此即使在 Hermes 正在运行时也能正常工作（支持 WAL 模式下的安全操作）。

ZIP 文件中不包含的内容：

• *.db-wal、*.db-shm、*.db-journal — SQLite 的 WAL/共享内存/日志辅助文件。*.db 文件已通过 sqlite3.backup() 生成了完整快照；若同时传输这些实时辅助文件，恢复时可能会导致状态不完整。
• checkpoints/ — 每个会话的轨迹缓存。这些缓存以哈希值标识，并且会随会话重新生成；无论如何也无法干净地移植到其他安装环境中。
• hermes-agent 代码本身（这是用户数据备份，而非代码库快照）。

示例

hermes backup                           # Full backup to ~/hermes-backup-*.zip
hermes backup -o /tmp/hermes.zip        # Full backup to specific path
hermes backup --quick                   # Quick state-only snapshot
hermes backup --quick --label "pre-upgrade"  # Quick snapshot with label

hermes checkpoints

hermes checkpoints [COMMAND]

您可以查看并管理位于 ~/.hermes/checkpoints/ 的影子 Git 存储空间——该空间是会话内 /rollback 命令背后的存储层。随时均可运行此命令，且无需 Agent 正在运行。

选项

示例

hermes checkpoints                                  # status overview
hermes checkpoints prune --retention-days 3         # aggressive cleanup
hermes checkpoints prune --max-size-mb 200          # tighten size cap once
hermes checkpoints clear-legacy -f                  # drop v1 archive dirs
hermes checkpoints clear -f                         # wipe everything

有关完整的架构说明及会话内可用命令的详细内容，请参阅检查点与/回滚。

hermes import

hermes import <zipfile> [options]

将之前创建的 Hermes 备份恢复到您的 Hermes 主目录中。归档文件中的所有内容都会覆盖主目录中已有的文件；而 --force 选项仅用于跳过在目标目录已存在 Hermes 安装时的确认提示。

:::warning 在导入之前请先停止网关，以避免与正在运行的进程发生冲突。

::

示例

hermes import ~/hermes-backup-20260423.zip           # Prompts before overwriting existing config
hermes import ~/hermes-backup-20260423.zip --force   # Overwrite without prompting

hermes logs 命令

hermes logs [log_name] [options]

查看、跟踪并筛选 Hermes 日志文件。所有日志均存储在 ~/.hermes/logs/ 目录中（非默认配置文件的日志则存储在 <profile>/logs/ 目录中）。

日志文件

参数选项

使用示例

# View the last 50 lines of agent.log (default)
hermes logs

# Follow agent.log in real time
hermes logs -f

# View the last 100 lines of gateway.log
hermes logs gateway -n 100

# Show only warnings and errors from the last hour
hermes logs --level WARNING --since 1h

# Filter by a specific session
hermes logs --session abc123

# Follow errors.log, starting from 30 minutes ago
hermes logs errors --since 30m -f

# List all log files with their sizes
hermes logs list

过滤

多个过滤规则可以组合使用。当有多个过滤规则生效时，只有同时满足所有规则的日志行才会被显示出来：

# WARNING+ lines from the last 2 hours containing session "tg-12345"
hermes logs --level WARNING --since 2h --session tg-12345

当启用 --since 参数时，即使行中不存在可解析的时间戳，该行也会被包含在内（这些行可能是多行日志条目的延续部分）；而当启用 --level 参数时，即使行中无法识别日志级别，该行同样会被纳入统计。

日志轮转

Hermes 使用 Python 的 RotatingFileHandler 功能来实现自动日志轮转——系统中会生成诸如 agent.log.1、agent.log.2 等格式的旧日志文件。通过 hermes logs list 子命令即可查看所有日志文件，包括已轮转过的那些。

hermes prompt-size

hermes prompt-size [--platform <name>] [--json]

该功能会显示新会话的固定提示词预算，即在任何对话内容之前、每次API调用时都会发送的提示词内容。当下游适配器或代理的提示词预算低于模型的上下文窗口大小时，或者您想了解哪些部分（技能索引、内存、用户档案）占据了最大比例时，此功能非常有用。

它会生成与智能体所使用的完全相同的系统提示词，然后对其进行分析拆解：

• 系统提示词总量——完整的组合提示词（包括身份信息、使用指南、技能索引、上下文文件、内存数据、用户档案以及时间戳）。
• 技能索引——即<available_skills>部分。当安装了众多技能时，这部分通常会是占比最大的单一模块。
• 内存数据与用户档案——对应您的MEMORY.md/USER.md文件中的内容快照。
• 提示词层级——稳定型/上下文型/易变型，反映了Hermes为优化缓存性能而对提示词进行的层次划分。
• 工具结构定义——所有已启用工具的JSON格式描述（即每次调用时固定传输内容的另一半）。

该功能完全在离线状态下运行，无需进行任何API调用，也无需配置任何凭证信息。

# Human-readable breakdown for the CLI platform (default)
hermes prompt-size

# Simulate a messaging platform's prompt (different platform hint)
hermes prompt-size --platform telegram

# Machine-readable output for scripts
hermes prompt-size --json

:::提示 技能指数与工具结构体规模会随着您启用的技能和工具数量而变化。若希望缩小提示词长度，可禁用未使用的工具集（hermes tools），或卸载不需要的技能（hermes skills）。当前目录下的上下文文件（如 AGENTS.md、.cursorrules）也会计入总规模中。

::

hermes config

hermes config <subcommand>

子命令：

hermes pairing

hermes pairing <list|approve|revoke|clear-pending>

hermes skills

hermes skills <subcommand>

子命令：

常见示例：

hermes skills browse
hermes skills browse --source official
hermes skills search react --source skills-sh
hermes skills search https://mintlify.com/docs --source well-known
hermes skills inspect official/security/1password
hermes skills inspect skills-sh/vercel-labs/json-render/json-render-react
hermes skills install official/migration/openclaw-migration
hermes skills install skills-sh/anthropics/skills/pdf --force
hermes skills install https://sharethis.chat/SKILL.md                     # Direct URL (single-file SKILL.md)
hermes skills install https://example.com/SKILL.md --name my-skill        # Override name when frontmatter has none
hermes skills check
hermes skills update
hermes skills config
hermes skills reset google-workspace
hermes skills reset google-workspace --restore --yes
hermes skills opt-out                  # stop future bundled-skill seeding (nothing deleted)
hermes skills opt-out --remove --yes   # also delete UNMODIFIED bundled skills
hermes skills opt-in --sync            # undo: remove marker and re-seed now

备注：

• --force 可用于覆盖第三方或社区技能中非危险级别的策略限制。
• --force 无法更改被标记为“危险”的扫描结果。
• --source skills-sh 会从公共的 skills.sh 目录中搜索技能。
• --source well-known 允许将 Hermes 指向暴露 /.well-known/skills/index.json 文件的网站。
• --source browse-sh 会从 browse.sh 提供的包含200多种针对特定网站的浏览器自动化技能的目录中搜索。这些技能的标识符格式为 browse-sh/airbnb.com/search-listings-ddgioa。
• 若提供 http(s)://…/*.md 格式的网址，可直接安装单文件形式的 SKILL.md。当前端数据中未包含 name: 字段且该网址的标识符无效时，交互式终端会提示用户输入名称；而非交互式界面（如 TUI 内的 /skills install 命令或网关平台）则需使用 --name <x> 参数指定名称。

hermes bundles

hermes bundles <subcommand>

技能包将多个技能整合在同一个 /<bundle-name> 格式的命令下。调用该技能包时，所有关联的技能都会被合并到一条统一的用户消息中。存储路径为：~/.hermes/skill-bundles/<slug>.yaml。有关 YAML 结构及相关行为说明，请参阅 技能包。

子命令：

示例：

hermes bundles create backend-dev \
  --skill github-code-review \
  --skill test-driven-development \
  --skill github-pr-workflow \
  -d "Backend feature work"

hermes bundles list
hermes bundles show backend-dev
hermes bundles delete backend-dev

在聊天会话中，使用 /bundles 可查看已安装的插件包，而 /<bundle-name> 用于加载指定的插件包。

hermes curator

hermes curator <subcommand>

Curator是一个辅助模型后台任务，它会定期检查由Agent生成的技能，删除过时的技能，合并重复的技能，并将不再使用的技能归档。已打包或通过Hub安装的技能则不会被触碰。归档的技能可以恢复，绝不会被自动删除。

在首次安装后，第一次 scheduled的检查任务会延迟一个完整的interval_hours时间（默认为7天）——在执行hermes update后的第一个计时周期内，Gateway不会立即进行技能检查。建议在此之前使用hermes curator run --dry-run来预览功能。

有关其行为及配置详情，请参阅Curator文档。

hermes moa

用于配置命名化的Mixture of Agents预设。这些预设会作为可选模型显示在每个模型选择器中的“Mixture of Agents”提供者下；使用/moa <prompt>命令则可通过默认预设处理对应提示词。

hermes moa list
hermes moa configure [name]
hermes moa delete <name>

hermes moa configure 会复用 Hermes 的提供者→模型选择器，用于处理各个参考模型以及聚合器。预设仅属于执行模式配置，并非核心模型或提供者。

hermes fallback

hermes fallback <subcommand>

管理备用提供者链。当主模型因速率限制、过载或连接错误而失效时，系统会按顺序尝试这些备用提供者。

详情请参阅 备用提供者。

hermes hooks

hermes hooks <subcommand>

检查 ~/.hermes/config.yaml 中声明的 shell 脚本钩子，使用合成测试载荷对它们进行测试，并在 ~/.hermes/shell-hooks-allowlist.json 中管理首次使用授权白名单。

有关事件签名和载荷格式的详细信息，请参阅 Hooks。

hermes memory

hermes memory <subcommand>

设置并管理外部内存提供程序插件。目前支持的提供程序包括：honcho、openviking、mem0、hindsight、holographic、retaindb、byterover、supermemory。同一时间仅能有一个外部提供程序处于激活状态，而内置内存（MEMORY.md/USER.md）则始终处于激活状态。

子命令：

:::info 提供程序专属子命令 当某个外部内存提供程序处于激活状态时，它可能会注册自己的顶级 hermes <provider> 命令，以便进行针对该提供程序的专用管理操作（例如在 Honcho 处于激活状态时使用 hermes honcho）。未激活的提供程序则不会显示其子命令。运行 hermes --help 可查看当前已配置的提供程序。

::

hermes acp

hermes acp

以 ACP（Agent Client Protocol）标准输入输出服务器模式启动 Hermes，从而实现与编辑器的集成。

相关入口点：

hermes-acp
python -m acp_adapter

请先安装支持组件：

cd ~/.hermes/hermes-agent && uv pip install -e '.[acp]'

请参阅 ACP 编辑器集成 以及 ACP 内部机制。

hermes mcp

hermes mcp <subcommand>

管理 MCP（模型上下文协议）服务器配置，并将 Hermes 作为 MCP 服务器运行。

更多详情请参阅 MCP 配置参考、在 Hermes 中使用 MCP 以及 MCP 服务器模式。

hermes plugins

hermes plugins [subcommand]

统一的插件管理功能——所有通用插件、内存提供器以及上下文引擎均集中于此。运行 hermes plugins 且不指定子命令时，会打开一个包含两个区域的综合交互界面：

• 通用插件——通过多选复选框来启用或禁用已安装的插件；
• 提供器插件——针对内存提供器和上下文引擎提供单选配置。在某一类别上按下 ENTER 键即可打开单选下拉菜单。

提供器插件的选择结果会保存在 config.yaml 文件中：

• memory.provider——当前使用的内存提供器（留空则表示仅使用内置提供器）；
• context.engine——当前使用的上下文引擎（"compressor" 表示默认内置引擎）。

通用插件的禁用列表则存储在 config.yaml 的 plugins.disabled 字段中。

更多详情请参阅 插件 以及 构建 Hermes 插件 文档。

hermes tools

hermes tools [--summary]

若不使用 --summary，则会启动针对不同平台的交互式工具配置界面。

hermes computer-use

hermes computer-use <subcommand>

子命令：

hermes computer-use install 是安装 computer_use 工具集所使用的 cua-driver 二进制文件的稳定入口命令。它使用的正是你在首次启用“计算机使用”功能时 hermes tools 所调用的上游安装程序，因此即便工具集开关未触发安装流程（例如在用户重新登录后），使用该命令重新安装也是安全的。

如果 cua-driver 已存在于 PATH 环境变量中，hermes update 会在更新过程结束时自动重新运行上游安装程序，因此大多数用户无需手动调用 --upgrade 参数。当上游版本发布了你急需的修复补丁，而你不想等待下一次 Hermes 更新时，可使用此命令。

hermes pets

hermes pets <list|install|select|show|off|scale|remove|doctor>

Petdex 是一个面向编程智能体的动画精灵宠物公共展示库。安装任意一个宠物后，Hermes 就能在 CLI、TUI 以及桌面应用中展示该宠物对智能体操作的响应。

您还可以使用 /hatch 命令，根据文本描述生成全新的宠物。详情请参阅 Pets 文档。

hermes sessions

hermes sessions <subcommand>

子命令：

hermes insights

hermes insights [--days N] [--source platform]

hermes claw

hermes claw migrate [options]

将您的 OpenClaw 配置迁移至 Hermes。该工具会读取 ~/.openclaw（或自定义路径）中的配置，并将其写入 ~/.hermes。同时能自动识别旧版本的目录名称（如 ~/.clawdbot、~/.moltbot）以及配置文件名（如 clawdbot.json、moltbot.json）。

有哪些内容会被迁移？

此次迁移涵盖角色设定、记忆功能、技能、模型提供方、消息平台、智能体行为、会话策略、MCP 服务器、文本转语音等功能，共涉及 30 多个类别。相关配置要么直接导入到 Hermes 的对应组件中，要么被归档以便人工审核。

直接导入的内容包括： SOUL.md、MEMORY.md、USER.md、AGENTS.md、各类技能配置（来自 4 个源目录）、默认模型、自定义模型提供方、MCP 服务器、消息平台的相关令牌及允许列表（Telegram、Discord、Slack、WhatsApp、Signal、Matrix、Mattermost）、智能体默认参数（推理耗时、压缩设置、人工响应延迟、时区、沙箱模式）、会话重置规则、审批规则、文本转语音配置、浏览器设置、工具设置、命令执行超时时间、命令允许列表、网关配置，以及来自 3 个来源的 API 密钥。

被归档以供人工审核的内容包括： 定时任务脚本、插件、钩子/Webhook 配置、记忆功能后端（QMD）、技能注册表配置、用户界面/身份相关设置、日志记录功能、多智能体配置、频道绑定设置、IDENTITY.md、TOOLS.md、HEARTBEAT.md、BOOTSTRAP.md 等文件。

API 密钥解析会按优先级依次检查三个来源：配置文件中的值 → ~/.openclaw/.env 文件 → auth-profiles.json 文件。所有令牌字段都支持普通字符串、环境变量模板（${VAR}）以及 SecretRef 对象。

如需查看完整的配置键映射表、SecretRef 处理细节以及迁移后的检查清单，请参阅 完整迁移指南。

示例

# Preview what would be migrated
hermes claw migrate --dry-run

# Full migration (all compatible settings, no secrets)
hermes claw migrate --preset full

# Full migration including API keys
hermes claw migrate --preset full --migrate-secrets

# Migrate user data only (no secrets), overwrite conflicts
hermes claw migrate --preset user-data --overwrite

# Migrate from a custom OpenClaw path
hermes claw migrate --source /home/user/old-openclaw

hermes serve 命令

hermes serve [options]

启动 Hermes 后端服务器——即 桌面应用 与远程客户端所连接的 JSON-RPC/WebSocket 网关。该服务器与 hermes dashboard 运行的服务器相同，但为无界面模式：不会打开任何浏览器界面。桌面应用会自行启动其自身的 hermes serve 后端；若希望在远程主机上使用无界面后端，则可直接使用此命令。它支持与下方 hermes dashboard 相同的 --host / --port / --insecure / --skip-build / --stop / --status 参数（非回环绑定会启用相同的认证机制）。该命令需要安装 [web] 插件；而在 POSIX 系统主机上，内置的聊天套接字还需额外配置 [pty]。

hermes dashboard

hermes dashboard [options]

启动 Web 控制面板——这是一个基于浏览器的用户界面，用于管理配置、API 密钥以及监控会话。（对于没有浏览器界面的无头后端环境，例如桌面应用程序启动的后端，可使用上文提到的 hermes serve 命令。）使用该功能需要执行 cd ~/.hermes/hermes-agent && uv pip install -e ".[web]"（基于 FastAPI 和 Uvicorn）。内置的浏览器聊天标签页始终可用，但还需额外安装 pty 组件（需执行 `cd ~/.hermes/hermes-agent && uv pip install -e “.[web,pty]”》），并且要求操作系统具备 POSIX PTY 环境，如 Linux、macOS 或 WSL2。详细文档请参阅 Web 控制面板。

hermes dashboard register

将该安装项注册为您 Nous Portal 账户下的自托管控制面板。该命令会创建一个 OAuth 客户端，将 HERMES_DASHBOARD_OAUTH_CLIENT_ID 写入 ~/.hermes/.env 文件，并说明如何接入登录验证流程。使用时需已登录账户（需先执行 hermes setup）。

# Default — opens browser to http://127.0.0.1:9119
hermes dashboard

# Custom port, no browser
hermes dashboard --port 8080 --no-open

# From a profile alias — routes to the machine dashboard with the
# profile preselected in the sidebar switcher (attach if running)
worker dashboard

hermes profile

hermes profile <subcommand>

管理配置文件——支持多个独立的 Hermes 实例，每个实例拥有独立的配置、会话、技能及主目录。

示例：

hermes profile list
hermes profile create work --clone
hermes profile use work
hermes profile alias work --name h-work
hermes profile export work -o work-backup.tar.gz
hermes profile import work-backup.tar.gz --name restored
hermes profile install github.com/user/my-distro --alias
hermes profile update work
hermes -p work chat -q "Hello from work profile"

hermes completion 功能

hermes completion [bash|zsh|fish]

将 Shell 自动补全脚本输出到标准输出。将该输出引入您的 Shell 配置文件中，即可实现对 Hermes 命令、子命令以及配置文件名称的 Tab 键自动补全。

示例：

# Bash
hermes completion bash >> ~/.bashrc

# Zsh
hermes completion zsh >> ~/.zshrc

# Fish
hermes completion fish > ~/.config/fish/completions/hermes.fish

hermes update 命令

hermes update [--gateway] [--check] [--no-backup] [--backup] [--yes]

该命令会获取最新的 hermes-agent 代码，并在管理的虚拟环境中重新安装依赖项，随后再次运行安装后的钩子程序（如 MCP 服务器、技能同步及补全功能安装）。即便在已实际安装的环境中运行也安全。若想在不进行实际安装的情况下查看当前版本是否落后于 origin/main，可使用 --check 参数。

hermes update 会获取配置好的更新分支（默认为 main）。如果当前检出代码位于其他分支，Hermes 可能会在拉取之前先切换到该更新分支。若希望将某些分支上的修改排除在自动更新流程之外，建议在更新前先提交这些修改。

其他相关行为：

• 网关重启：成功完成更新后，Hermes 会自动尝试重启所有正在运行的网关实例，以便它们能使用到最新代码。若仅需重启网关而不进行更新，可使用 hermes gateway restart 命令。
• 本地源代码变更：对于通过 git 安装的项目，在切换分支或拉取代码之前，系统会自动将已修改但未暂存的文件以及未被跟踪的文件暂存起来（使用 git stash push --include-untracked 命令）。交互式终端更新会在恢复暂存内容前询问用户确认；非交互式更新则默认直接恢复暂存内容。仅在管理型安装环境中，且希望在拉取成功后丢弃所有本地修改时，才可将 updates.non_interactive_local_changes 设置为 discard。如果恢复暂存时出现冲突或拉取失败，暂存内容将保持原样，以便用户手动处理。
• npm lockfile 变更清理：在暂存代码或切换分支之前，Hermes 会尽力清理由 npm install/build 过程产生的已跟踪 package-lock.json 文件的差异内容。在运行 hermes update 命令之前，请先将有意修改的 lockfile 内容提交或手动暂存。
• 配对数据快照：即使关闭了 --backup 参数，hermes update 也会在执行 git pull 之前，对 ~/.hermes/pairing/ 目录以及飞书评论规则生成轻量级的快照。如果拉取操作覆盖了您正在编辑的文件，可使用 hermes backup restore --state pre-update 命令将其恢复。
• 旧版 hermes.service 警告：如果 Hermes 检测到系统上存在更名前的 hermes.service systemd 单元（而非当前的 hermes-gateway.service），它会一次性提示用户进行迁移操作，以避免出现循环问题。
• 退出码说明：成功时返回 0；拉取、安装或安装后步骤出错时返回 1；工作目录发生意外变化导致无法执行 git pull 时返回 2。

维护命令

参见

• Slash 命令参考
• CLI 接口
• 会话管理
• 技能系统
• 皮肤与主题