CLI 命令参考

本页涵盖了您从 shell 运行的终端命令。

关于聊天中的斜杠命令，请参见斜杠命令参考。

全局入口点

hermes [全局选项] <命令> [子命令/选项]

全局选项

选项	描述
`--version`, `-V`	显示版本并退出。
`--profile <名称>`, `-p <名称>`	选择本次调用要使用的 Hermes 配置文件。会覆盖由 `hermes profile use` 设置的默认固定配置。
`--resume <会话>`, `-r <会话>`	通过 ID 或标题恢复先前的会话。
`--continue [名称]`, `-c [名称]`	恢复最近的一次会话，或恢复标题匹配的最近会话。
`--worktree`, `-w`	在一个隔离的 git 工作树中启动，用于并行智能体工作流。
`--yolo`	跳过危险命令的批准提示。
`--pass-session-id`	在智能体的系统提示中包含会话 ID。
`--ignore-user-config`	忽略 `~/.hermes/config.yaml` 并回退到内置默认值。`.env` 文件中的凭据仍会加载。
`--ignore-rules`	跳过自动注入 `AGENTS.md`、`SOUL.md`、`.cursorrules`、记忆和预加载技能。
`--tui`	启动 TUI 而不是经典的 CLI。等同于 `HERMES_TUI=1`。
`--dev`	配合 `--tui` 使用时：直接通过 `tsx` 运行 TypeScript 源码，而不是预构建的包（供 TUI 贡献者使用）。

顶级命令

命令	用途
`hermes chat`	与智能体进行交互式或单次聊天。
`hermes model`	交互式选择默认提供商和模型。
`hermes fallback`	管理主模型出错时尝试的备用提供商。
`hermes gateway`	运行或管理消息网关服务。
`hermes proxy`	本地兼容 OpenAI 的代理，附加 OAuth 提供商凭据。参见订阅代理。
`hermes lsp`	管理语言服务器协议集成（write_file/patch 的语义诊断）。
`hermes setup`	针对全部或部分配置的交互式设置向导。
`hermes whatsapp`	配置并连接 WhatsApp 桥接。
`hermes slack`	Slack 辅助工具（当前：为每个命令生成原生斜杠命令的应用清单）。
`hermes auth`	管理凭据——添加、列出、删除、重置、设置策略。处理 Codex/Nous/Anthropic 的 OAuth 流程。
`hermes login` / `logout`	已弃用 — 请改用 `hermes auth`。
`hermes send`	向已配置的消息平台（Telegram、Discord、Slack、Signal、短信等）发送单次消息。适用于 shell 脚本、定时任务、CI 钩子和监控守护进程——无智能体循环，无 LLM。
`hermes secrets`	管理外部密钥源（当前为 Bitwarden 密钥管理器），用于在进程启动时拉取 API 密钥，而非从 `~/.hermes/.env` 获取。
`hermes migrate`	诊断并（可选地）重写 `config.yaml`，以替换对已退役模型或已弃用设置的引用（例如 `migrate xai`）。
`hermes status`	显示智能体、认证和平台状态。
`hermes cron`	检查并触发定时任务调度器。
`hermes kanban`	多配置文件协作看板（任务、链接、调度器）。
`hermes webhook`	管理用于事件驱动激活的动态 webhook 订阅。
`hermes hooks`	检查、批准或删除在 `config.yaml` 中声明的 shell 脚本钩子。
`hermes doctor`	诊断配置和依赖项问题。
`hermes security audit`	按需进行供应链审计（OSV.dev），针对虚拟环境、插件需求和固定的 MCP 服务器。
`hermes dump`	用于支持/调试的可复制粘贴的设置摘要。
`hermes debug`	调试工具——上传日志和系统信息以获取支持。
`hermes backup`	将 Hermes 主目录备份到 zip 文件。
`hermes checkpoints`	检查/清理/删除 `~/.hermes/checkpoints/`（`/rollback` 使用的影子存储）。不带参数运行以查看状态概览。
`hermes import`	从 zip 文件恢复 Hermes 备份。
`hermes logs`	查看、尾部追踪和过滤智能体/网关/错误日志文件。
`hermes config`	显示、编辑、迁移和查询配置文件。
`hermes pairing`	批准或撤销消息配对码。
`hermes skills`	浏览、安装、发布、审计和配置技能。
`hermes bundles`	将多个技能组合到一个 `/<name>` 斜杠命令下。参见技能包。
`hermes curator`	后台技能维护——状态、运行、暂停、固定。参见策展人。
`hermes memory`	配置外部记忆提供商。当提供商激活时，插件特定的子命令（例如 `hermes honcho`）会自动注册。
`hermes acp`	作为 ACP 服务器运行 Hermes，用于编辑器集成。
`hermes mcp`	管理 MCP 服务器配置，并将 Hermes 作为 MCP 服务器运行。
`hermes plugins`	管理 Hermes 智能体插件（安装、启用、禁用、删除）。
`hermes portal`	Nous 门户状态、订阅链接和工具网关路由。参见工具网关。
`hermes tools`	按平台配置启用的工具。
`hermes computer-use`	安装或检查 cua-driver 后端（macOS 电脑使用）。
`hermes sessions`	浏览、导出、清理、重命名和删除会话。
`hermes insights`	显示令牌/成本/活动分析。
`hermes claw`	OpenClaw 迁移辅助工具。
`hermes dashboard`	启动用于管理配置、API 密钥和会话的 Web 仪表板。
`hermes profile`	管理配置文件——多个隔离的 Hermes 实例。
`hermes completion`	打印 shell 补全脚本（bash/zsh/fish）。
`hermes version`	显示版本信息。
`hermes update`	拉取最新代码并重新安装依赖项（git 安装），或检查 PyPI 并执行 `pip install --upgrade`（pip 安装）。`--check` 仅预览不安装；`--backup` 在拉取前创建 `HERMES_HOME` 快照。
`hermes uninstall`	从系统中移除 Hermes。

`hermes chat`

hermes chat [选项]

常用选项：

选项	描述
`-q`, `--query "..."`	单次、非交互式提示。
`-m`, `--model <model>`	覆盖此次运行的模型。
`-t`, `--toolsets <csv>`	启用一组以逗号分隔的工具集。
`--provider <provider>`	强制指定提供商：`auto`、`openrouter`、`nous`、`openai-codex`、`copilot-acp`、`copilot`、`anthropic`、`gemini`、`google-gemini-cli`、`huggingface`、`novita`、`zai`、`kimi-coding`、`kimi-coding-cn`、`minimax`、`minimax-cn`、`minimax-oauth`、`kilocode`、`xiaomi`、`arcee`、`gmi`、`alibaba`、`alibaba-coding-plan`（别名 `alibaba_coding`）、`deepseek`、`nvidia`、`ollama-cloud`、`xai`（别名 `grok`）、`xai-oauth`（别名 `grok-oauth`）、`qwen-oauth`、`bedrock`、`opencode-zen`、`opencode-go`、`azure-foundry`、`lmstudio`、`stepfun`、`tencent-tokenhub`（别名 `tencent`、`tokenhub`）。
`-s`, `--skills <name>`	为会话预加载一个或多个技能（可重复或逗号分隔）。
`-v`, `--verbose`	详细输出。
`-Q`, `--quiet`	程序化模式：抑制横幅/旋转指示器/工具预览。
`--image <path>`	为单次查询附加本地图片。
`--resume <session>` / `--continue [name]`	直接从 `chat` 恢复会话。
`--worktree`	为此次运行创建隔离的 git 工作树。
`--checkpoints`	在破坏性文件更改前启用文件系统检查点。
`--yolo`	跳过批准提示。
`--pass-session-id`	将会话 ID 传递到系统提示中。
`--ignore-user-config`	忽略 `~/.hermes/config.yaml` 并使用内置默认值。`.env` 中的凭据仍会加载。适用于隔离的 CI 运行、可复现的错误报告和第三方集成。
`--ignore-rules`	跳过自动注入 `AGENTS.md`、`SOUL.md`、`.cursorrules`、持久记忆和预加载的技能。与 `--ignore-user-config` 结合使用以获得完全隔离的运行。
`--source <tag>`	用于过滤的会话源标签（默认：`cli`）。对于不应出现在用户会话列表中的第三方集成，使用 `tool`。
`--max-turns <N>`	每次对话轮次的最大工具调用迭代次数（默认：90，或配置中的 `agent.max_turns`）。

示例：

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"
hermes chat --ignore-user-config --ignore-rules -q "不使用我的个人设置进行复现"

`hermes -z <prompt>` — 脚本化的单次调用

对于程序化调用者（shell 脚本、CI、定时任务、父进程通过管道传入提示），hermes -z 是最纯粹的单次调用入口：单个提示输入，最终响应文本输出，标准输出或标准错误上没有其他内容。 没有横幅，没有旋转指示器，没有工具预览，没有 Session: 行——只有智能体的最终回复作为纯文本。

hermes -z "法国的首都是哪里？"
# → 巴黎。

# 父脚本可以清晰地捕获响应：
answer=$(hermes -z "总结这个" < /path/to/file.txt)

按次运行的覆盖（不修改 ~/.hermes/config.yaml）：

标志	等效的环境变量	用途
`-m` / `--model <model>`	`HERMES_INFERENCE_MODEL`	覆盖此次运行的模型
`--provider <provider>`	（无）	覆盖此次运行的提供商

hermes -z "…" --provider openrouter --model openai/gpt-5.5
# 或：
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 密钥
从提供商特定的模型列表中选择
配置自定义/自托管端点
将新的默认设置保存到配置文件中

hermes model 与 /model —— 区分清楚

hermes model（从终端运行，在任何 Hermes 会话之外）是完整的提供商设置向导。它可以添加新提供商、运行 OAuth 流程、提示输入 API 密钥以及配置端点。

/model（在活跃的 Hermes 聊天会话中输入）只能在已设置好的提供商和模型之间进行切换。它无法添加新提供商、运行 OAuth 或提示输入 API 密钥。

如果需要添加新提供商： 首先退出你的 Hermes 会话（Ctrl+C 或 /quit），然后在终端提示符下运行 hermes model。

`/model` 斜杠命令（会话中）

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

/model                              # 显示当前模型和可用选项
/model claude-sonnet-4              # 切换模型（自动检测提供商）
/model zai:glm-5                    # 切换提供商和模型
/model custom:qwen-2.5              # 使用自定义端点上的模型
/model custom                       # 从自定义端点自动检测模型
/model custom:local:qwen-2.5        # 使用命名的自定义提供商
/model openrouter:anthropic/claude-sonnet-4  # 切换回云端

默认情况下，/model 的更改仅应用于当前会话。添加 --global 可将更改持久化到 config.yaml：

/model claude-sonnet-4 --global     # 切换并保存为新的默认设置
:::

:::info[如果我只看到 OpenRouter 模型怎么办？]
如果你只配置了 OpenRouter，`/model` 将只显示 OpenRouter 模型。要添加另一个提供商（Anthropic、DeepSeek、Copilot 等），请退出会话并在终端中运行 `hermes model`。
:::

提供商和基础 URL 的更改会自动持久化到 `config.yaml`。当切换离开自定义端点时，陈旧的基础 URL 会被清除，以防止其泄露到其他提供商。

## `hermes gateway`

```bash
hermes gateway <subcommand>

子命令：

子命令	描述
`run`	在前台运行网关。推荐用于 WSL、Docker 和 Termux。
`start`	启动已安装的 systemd/launchd 后台服务。
`stop`	停止服务（或前台进程）。
`restart`	重启服务。
`status`	显示服务状态。
`list`	列出所有配置文件及其网关当前是否正在运行（如果有 PID 则显示）。当你并行运行多个配置文件并想要一个总览时非常方便。
`install`	安装为 systemd（Linux）或 launchd（macOS）后台服务。
`uninstall`	移除已安装的服务。
`setup`	交互式消息平台设置。

选项：

选项	描述
`--all`	对于 `start` / `restart` / `stop`：对每个配置文件的网关执行操作，而不仅仅是当前活跃的 `HERMES_HOME`。当你并行运行多个配置文件并希望在 `hermes update` 后重启所有网关时很有用。
`--no-supervise`	对于 `run`：在 s6-overlay Docker 镜像内，选择退出自动监督并使用 pre-s6 前台语义——网关作为容器的主进程运行，没有自动重启。在 s6 镜像外无效。等同于设置 `HERMES_GATEWAY_NO_SUPERVISE=1`。

WSL 用户

请使用 hermes gateway run 而不是 hermes gateway start —— WSL 的 systemd 支持不稳定。可以将其包裹在 tmux 中以保持持久性：tmux new -s hermes 'hermes gateway run'。详情请参见 WSL 常见问题。

`hermes lsp`

hermes lsp <子命令>

管理语言服务器协议集成。LSP 在后台运行实际的语言服务器（pyright、gopls、rust-analyzer 等），并将其诊断信息馈送到 write_file 和 patch 使用的写入后检查中。受 Git 工作空间检测限制 —— 仅当当前工作目录或编辑的文件位于 Git 工作树内时，LSP 才会运行。

子命令：

子命令	描述
`status`	显示服务状态、已配置的服务器、安装状态。
`list`	打印支持的服务器注册表。传递 `--installed-only` 可跳过未安装的服务器。
`install <id>`	立即安装一个服务器的二进制文件。
`install-all`	安装所有已知自动安装脚本的服务器。
`restart`	终止正在运行的客户端，以便下次编辑时重新生成。
`which <id>`	打印一个服务器的已解析二进制路径。

完整指南、支持的语言和配置选项请参阅 LSP — 语义诊断。

`hermes setup`

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

最简路径： hermes setup --portal —— 通过 OAuth 登录 Nous Portal，并一次性选择加入工具网关。

首次运行： 启动首次设置向导。

回归用户（已配置）： 直接进入完整重新配置向导 —— 每个提示都会显示您当前的值作为默认值，按 Enter 保留或输入新值。无菜单。

跳过完整向导，直接进入特定部分：

部分	描述
`model`	供应商和模型设置。
`terminal`	终端后端和沙箱设置。
`gateway`	消息平台设置。
`tools`	按平台启用/禁用工具。
`agent`	智能体行为设置。

选项：

选项	描述
`--quick`	对于回归用户运行：仅提示缺失或未设置的项。跳过您已配置的项。
`--non-interactive`	使用默认值/环境变量，无需提示。
`--reset`	在设置前将配置重置为默认值。
`--reconfigure`	向后兼容别名 —— 现有安装上直接运行 `hermes setup` 默认即执行此操作。
`--portal`	一次性 Nous Portal 设置：通过 OAuth 登录，将 Nous 设置为推理提供程序，并选择加入工具网关。跳过向导的其余部分。

`hermes portal`

hermes portal [status|open|tools]

检查 Nous Portal 身份验证、工具网关路由，并访问订阅页面。不带子命令的调用运行 status。

子命令	描述
`status` (默认)	Portal 身份验证状态 + 每个工具的工具网关路由摘要。未提供子命令时也会显示。
`open`	在默认浏览器中打开 `portal.nousresearch.com/manage-subscription`。
`tools`	列出每个工具网关合作伙伴（Firecrawl、FAL、OpenAI TTS、Browser Use、Modal）以及哪些通过 Nous 进行路由。

关于网关本身的配置，请参阅工具网关。关于一次性设置路径，请参阅上面的 hermes setup --portal。

`hermes whatsapp`

hermes whatsapp

运行 WhatsApp 配对/设置流程，包括模式选择和二维码配对。

`hermes slack`

hermes slack manifest              # 将清单打印到标准输出
hermes slack manifest --write      # 写入 ~/.hermes/slack-manifest.json
hermes slack manifest --slashes-only  # 仅包含 features.slash_commands 数组

生成一个 Slack 应用清单，将 COMMAND_REGISTRY 中的每个网关命令（/btw、/stop、/model 等）注册为一流的 Slack 斜杠命令 —— 与 Discord 和 Telegram 保持一致。将输出粘贴到您的 Slack 应用配置中 https://api.slack.com/apps → 您的应用 → 功能 → 应用清单 → 编辑，然后保存。如果范围或斜杠命令发生更改，Slack 会提示重新安装。

标志	默认值	用途
`--write [PATH]`	stdout	写入文件而非标准输出。单独使用 `--write` 会写入 `$HERMES_HOME/slack-manifest.json`。
`--name NAME`	`Hermes`	在 Slack 中的机器人显示名称。
`--description DESC`	默认描述	在 Slack 应用目录中显示的机器人描述。
`--slashes-only`	关闭	仅发出 `features.slash_commands` 以便合并到手动维护的清单中。

在 hermes update 之后再次运行 hermes slack manifest --write 以获取任何新命令。

`hermes send`

hermes send --to <目标> "消息文本"
hermes send --to <目标> --file <路径>
echo "消息" | hermes send --to <目标>
hermes send --list [平台]

向已配置的消息平台发送一次性消息，无需启动智能体或网关循环。复用网关已配置的凭据（~/.hermes/.env + ~/.hermes/config.yaml），以便运维脚本、定时任务、CI 钩子和监控守护程序可以发布状态更新，而无需重新实现每个平台的 REST 客户端。

对于使用机器人令牌的平台（Telegram、Discord、Slack、Signal、SMS、WhatsApp-CloudAPI），不需要运行网关 —— hermes send 直接与平台的 REST 端点通信。需要持久适配器的插件平台仍需要一个活跃的网关。

选项	描述
`-t`, `--to <目标>`	投递目标。格式：`platform`（使用主频道）、`platform:chat_id`、`platform:chat_id:thread_id` 或 `platform:#channel-name`。示例：`telegram`、`telegram:-1001234567890`、`discord:#ops`、`slack:C0123ABCD`、`signal:+15551234567`。
`-f`, `--file <路径>`	从 `路径` 读取消息正文。传递 `-` 可强制从标准输入读取。
`-s`, `--subject <行>`	在消息正文前添加主题/标题行。
`-l`, `--list [平台]`	列出所有平台（或仅给定平台）的已配置目标。
`-q`, `--quiet`	成功时抑制标准输出 —— 在脚本中很有用（仅依赖退出码）。
`--json`	发出原始 JSON 结果，而非人类可读的输出。

如果既未提供位置参数 message 也未提供 --file，当标准输入不是 TTY 时，hermes send 将从标准输入读取。退出码：成功为 0，投递/后端失败为 1，用法错误为 2。

示例：

hermes send --to telegram "部署完成"
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                  # 所有平台
hermes send --list telegram         # 按平台筛选

`hermes secrets`

hermes secrets bitwarden <subcommand>
hermes secrets bw <subcommand>          # 短别名

在进程启动时从外部密钥管理器拉取 API 密钥，而不是将它们存储在 ~/.hermes/.env 中。目前支持 Bitwarden Secrets Manager。完整指南参见：Bitwarden 集成。

bitwarden（别名 bw）子命令：

子命令	描述
`setup`	交互式向导：安装固定的 `bws` 二进制文件，存储访问令牌，并选择一个项目。接受 `--project-id`、`--access-token` 和 `--server-url` 用于非交互式使用。
`status`	显示当前配置、二进制文件路径/版本以及上次获取信息。
`sync`	立即获取密钥并报告更改内容。添加 `--apply` 可将密钥实际导出到当前 shell 环境中（默认为模拟运行）。
`install`	下载并验证固定的 `bws` 二进制文件。`--force` 会强制重新下载，即使已存在托管副本。
`disable`	关闭 Bitwarden 集成。

`hermes migrate`

hermes migrate <type>

诊断并（可选）重写活动的 config.yaml，以替换已退役模型或已弃用设置的引用。在重写之前会对原始 config.yaml 进行带时间戳的备份（可通过 --no-backup 跳过）。

子命令	描述
`xai`	扫描 `config.yaml` 中对计划于 2026 年 5 月 15 日退役的 xAI 模型的引用，并（使用 `--apply`）根据 xAI 迁移指南就地将其重写为官方替换项。默认为模拟运行。

迁移子命令的通用标志：

标志	描述
`--apply`	就地重写 `config.yaml`（默认：模拟运行，不写入）。
`--no-backup`	应用时跳过 `config.yaml` 的带时间戳备份。

注意不要与 hermes claw migrate（将 OpenClaw 配置一次性导入 Hermes）混淆——hermes migrate 是顶层配置重写命令。

`hermes proxy`

hermes proxy <子命令>

运行一个本地兼容 OpenAI 的 HTTP 服务器，该服务器将请求转发到经过 OAuth 认证的上游提供商（例如 Nous Portal、xAI）。外部应用可以使用任何 Bearer 令牌指向该代理；代理会在转发请求时附加您的真实 OAuth 凭据。完整指南请参阅订阅代理。

子命令	描述
`start`	在前台运行代理。标志：`--provider <nous\|xai>`（默认为 `nous`）、`--host <地址>`（默认为 `127.0.0.1`；使用 `0.0.0.0` 以在局域网暴露）、`--port <整数>`（默认为 `8645`）。
`status`	显示哪些代理上游已就绪（凭据存在，OAuth 有效）。
`providers`	列出可用的代理上游提供商。

`hermes security`

hermes security <子命令>

针对 OSV.dev 的按需漏洞扫描。覆盖 Hermes 的 Python 虚拟环境（已安装的 PyPI 发行版）、~/.hermes/plugins/ 下插件声明的 Python 依赖项，以及 config.yaml 中固定的 npx/uvx MCP 服务器。不扫描全局安装的包或编辑器/浏览器扩展。

子命令	描述
`audit`	运行一次性供应链审计。

audit 标志：

标志	默认值	描述
`--json`	关闭	输出机器可读的 JSON，而非人类可读的文本。
`--fail-on <级别>`	`critical`	当任何发现达到此严重性级别（`low`、`moderate`、`high`、`critical`）时，以非零状态退出。
`--skip-venv`	关闭	跳过扫描 Hermes Python 虚拟环境。
`--skip-plugins`	关闭	跳过扫描插件需求文件。
`--skip-mcp`	关闭	跳过扫描 `config.yaml` 中固定的 MCP 服务器。

`hermes login` / `hermes logout` (已弃用)

警告

hermes login 已被移除。请使用 hermes auth 管理 OAuth 凭据，使用 hermes model 选择提供商，或使用 hermes setup 进行完整的交互式设置。

`hermes auth`

管理同一提供商密钥轮换的凭据池。完整文档请参阅凭据池。

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 auth status anthropic                             # 显示提供商的认证状态
hermes auth logout anthropic                             # 注销并清除存储的认证状态
hermes auth spotify                                      # 通过 PKCE 认证 Hermes 与 Spotify 的连接

子命令：add、list、remove、reset、status、logout、spotify。调用时不带子命令将启动交互式管理向导。

`hermes status`

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

选项	描述
`--all`	以可共享的脱敏格式显示所有详细信息。
`--deep`	运行可能耗时更长的深度检查。

`hermes cron`

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

子命令	描述
`list`	显示已计划的作业。
`create` / `add`	从提示词创建一个计划作业，可选择通过重复使用 `--skill` 来附加一个或多个技能。
`edit`	更新作业的计划、提示词、名称、投递方式、重复次数或附加的技能。支持 `--clear-skills`、`--add-skill` 和 `--remove-skill`。
`pause`	暂停一个作业而不删除它。
`resume`	恢复一个已暂停的作业，并计算其下一次未来运行时间。
`run`	在下一个调度器 tick 时触发一个作业。
`remove`	删除一个计划作业。
`status`	检查 cron 调度器是否正在运行。
`tick`	运行一次到期作业然后退出。

`hermes kanban`

hermes kanban [--board <slug>] <操作> [选项]

多配置文件、多项目协作看板。每个安装可以托管多个看板（每个项目、仓库或域一个）；每个看板都是一个独立的队列，拥有自己的 SQLite 数据库和调度器作用域。新安装时会从一个名为 default 的看板开始，其数据库为 ~/.hermes/kanban.db 以保持向后兼容；其他看板位于 ~/.hermes/kanban/boards/<slug>/kanban.db。网关内嵌的调度器在每个 tick 会扫描所有看板。

全局标志（适用于以下每个操作）：

标志	用途
`--board <slug>`	对特定看板进行操作。默认为当前看板（通过 `hermes kanban boards switch`、`HERMES_KANBAN_BOARD` 环境变量或 `default` 设置）。

这是供人类/脚本使用的界面。 由调度器生成的智能体工作者通过专门的 kanban_* 工具集（kanban_show、kanban_complete、kanban_block、kanban_create、kanban_link、kanban_comment、kanban_heartbeat；编排器配置文件还包括 kanban_list 和 kanban_unblock）来驱动看板，而不是直接调用 hermes kanban 命令。工作者的环境变量中固定了 HERMES_KANBAN_BOARD，因此它们在物理上无法看到其他看板。

操作	用途
`init`	如果缺少则创建 `kanban.db`。幂等操作。
`boards list` / `boards ls`	列出所有看板及其任务数量。支持 `--json`、`--all`（包含已归档）。
`boards create <slug>`	创建一个新看板。标志：`--name`、`--description`、`--icon`、`--color`、`--switch`（设为活动看板）。Slug 应为 kebab-case 格式，自动转为小写。
`boards switch <slug>` / `boards use`	将 `<slug>` 持久化为活动看板（写入 `~/.hermes/kanban/current`）。
`boards show` / `boards current`	打印当前活动看板的名称、数据库路径和任务数量。
`boards rename <slug> "<名称>"`	更改看板的显示名称。Slug 不可变。
`boards rm <slug>`	归档（默认）或硬删除看板。`--delete` 跳过归档步骤。归档的看板移动到 `boards/_archived/<slug>-<ts>/`。对 `default` 看板无效。
`create "<标题>"`	在活动看板上创建一个新任务。标志：`--body`、`--assignee`、`--parent`（可重复）、`--workspace scratch\|worktree\|dir:<路径>`、`--tenant`、`--priority`、`--triage`、`--idempotency-key`、`--max-runtime`、`--max-retries`、`--skill`（可重复）。
`list` / `ls`	列出活动看板上的任务。使用 `--mine`、`--assignee`、`--status`、`--tenant`、`--archived`、`--json` 进行过滤。
`show <id>`	显示任务及其评论和事件。使用 `--json` 进行机器输出。
`assign <id> <配置文件>`	分配或重新分配。使用 `none` 取消分配。任务运行时无法操作。
`link <父任务> <子任务>`	添加依赖关系。会检测循环依赖。两个任务必须在同一看板上。
`unlink <父任务> <子任务>`	移除依赖关系。
`claim <id>`	原子性地认领一个就绪任务。打印解析后的工作区路径。
`comment <id> "<文本>"`	追加一条评论。下一个认领任务的工作者会将其作为 `kanban_show()` 响应的一部分读取。
`complete <id>`	标记任务完成。标志：`--result`、`--summary`、`--metadata`。
`block <id> "<原因>"`	标记任务因需要人工输入而阻塞。同时将原因作为评论追加。
`schedule <id> "<原因>"`	将延迟/后续工作停放在 `scheduled` 状态，这样它不会显示为人工阻塞项。
`unblock <id>`	将阻塞或计划的任务返回就绪状态（如果依赖项仍开放则返回 `todo`）。
`archive <id>`	从默认列表中隐藏。`gc` 将移除临时工作区。
`tail <id>`	跟踪任务的事件流。
`dispatch`	在活动看板上执行一次调度器传递。标志：`--dry-run`、`--max N`、`--failure-limit N`、`--json`。
`context <id>`	打印工作者将看到的完整上下文（标题 + 正文 + 父任务结果 + 评论）。
`specify <id>` / `specify --all`	通过辅助 LLM 将分诊栏任务细化为具体规格（标题 + 正文，包含目标、方法、验收标准），然后将其提升到 `todo` 状态。标志：`--tenant`（将 `--all` 的范围限定为一个租户）、`--author`、`--json`。在 `config.yaml` 的 `auxiliary.triage_specifier` 下配置模型。
`decompose <id>` / `decompose --all`	将分诊栏任务拆分为一个子任务图，根据描述路由到专业配置文件（编排器驱动路径）。当 LLM 判断任务不适合拆分时，回退到指定式的单任务提升。标志与 `specify` 相同。在 `config.yaml` 的 `auxiliary.kanban_decomposer` 下配置模型。当 `kanban.auto_decompose: true`（默认）时，每个调度器 tick 也会自动运行。参见自动 vs 手动编排。
`gc`	移除已归档任务的临时工作区。

示例：

# 创建第二个看板并在不切换的情况下在上面放置任务。
hermes kanban boards create atm10-server --name "ATM10 Server" --icon 🎮
hermes kanban --board atm10-server create "Restart server" --assignee ops

# 为后续调用切换活动看板。
hermes kanban boards switch atm10-server
hermes kanban list                  # 显示 atm10-server 的任务

# 归档一个看板（可恢复）或硬删除它。
hermes kanban boards rm atm10-server
hermes kanban boards rm atm10-server --delete

看板解析顺序（优先级从高到低）：--board <slug> 标志 → HERMES_KANBAN_BOARD 环境变量 → ~/.hermes/kanban/current 文件 → default。

所有操作也可在网关中作为斜杠命令使用（/kanban ...），具有相同的参数界面——包括 boards 子命令和 --board 标志。

有关完整设计——与 Cline Kanban / Paperclip / NanoClaw / Gemini Enterprise 的比较、八种协作模式、四个用户故事、并发正确性证明——请参阅仓库中的 docs/hermes-kanban-v1-spec.pdf 或看板用户指南。

`hermes webhook`

hermes webhook <subscribe|list|remove|test>

管理用于事件驱动智能体激活的动态 Webhook 订阅。需要配置中启用 webhook 平台 — 若未配置，将打印设置说明。

子命令	描述
`subscribe` / `add`	创建一个 webhook 路由。返回用于在您的服务上进行配置的 URL 和 HMAC 密钥。
`list` / `ls`	显示所有由智能体创建的订阅。
`remove` / `rm`	删除一个动态订阅。来自 config.yaml 的静态路由不受影响。
`test`	发送一个测试 POST 请求以验证订阅是否正常工作。

`hermes webhook subscribe`

hermes webhook subscribe <name> [options]

选项	描述
`--prompt`	包含 `{dot.notation}` 负载引用的提示模板。
`--events`	逗号分隔的事件类型（例如 `issues,pull_request`）。留空 = 接受所有。
`--description`	人类可读的描述。
`--skills`	为智能体运行加载的逗号分隔技能名称。
`--deliver`	交付目标：`log`（默认）、`telegram`、`discord`、`slack`、`github_comment`。
`--deliver-chat-id`	用于跨平台交付的目标聊天/频道 ID。
`--secret`	自定义 HMAC 密钥。如果省略则自动生成。
`--deliver-only`	跳过智能体 — 将渲染后的 `--prompt` 作为原始消息交付。零 LLM 成本，亚秒级交付。要求 `--deliver` 为真实目标（非 `log`）。

订阅会持久化到 ~/.hermes/webhook_subscriptions.json，并由 webhook 适配器热重载，无需重启网关。

`hermes doctor`

hermes doctor [--fix]

选项	描述
`--fix`	尝试在可能的地方进行自动修复。

`hermes dump`

hermes dump [--show-keys]

输出您整个 Hermes 设置的紧凑纯文本摘要。设计用于在 Discord、GitHub issues 或 Telegram 中请求支持时直接复制粘贴——无 ANSI 颜色，无特殊格式，仅包含数据。

选项	描述
`--show-keys`	显示经过脱敏处理的 API 密钥前缀（前4个和后4个字符），而非仅显示 `set`/`not set`。

包含内容

部分	详情
头部	Hermes 版本、发布日期、git 提交哈希值
环境	操作系统、Python 版本、OpenAI SDK 版本
身份	当前活动配置名称、HERMES_HOME 路径
模型	已配置的默认模型和提供者
终端	后端类型（本地、docker、ssh 等）
API 密钥	检查所有 22 个提供商/工具 API 密钥是否存在
功能	已启用的工具集、MCP 服务器数量、记忆提供者
服务	网关状态、已配置的消息平台
工作负载	定时任务数量、已安装技能数量
配置覆盖	任何与默认值不同的配置值

示例输出

--- 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 上报告错误 —— 将 dump 信息粘贴到您的 issue 中
在 Discord 中寻求帮助 —— 在代码块中分享它
将您的设置与他人的设置进行比较
当出现问题时快速进行合理性检查

提示

hermes dump 专为分享而设计。要进行交互式诊断，请使用 hermes doctor。要获得可视化概览，请使用 hermes status。

`hermes debug`

hermes debug share [options]

上传调试报告（系统信息 + 最近日志）到粘贴服务并获取一个可分享的 URL。对于快速支持请求非常有用——包含了帮助者诊断您的问题所需的一切信息。

选项	描述
`--lines <N>`	每个日志文件包含的日志行数（默认：200）。
`--expire <days>`	粘贴内容过期天数（默认：7）。
`--local`	在本地打印报告而不上传。

报告包含系统信息（操作系统、Python 版本、Hermes 版本）、最近的智能体和网关日志（每个文件 512 KB 限制）以及经过脱敏处理的 API 密钥状态。密钥始终被脱敏——不会上传任何密钥。

按顺序尝试的粘贴服务：paste.rs, dpaste.com。

示例

hermes debug share              # 上传调试报告，打印 URL
hermes debug share --lines 500  # 包含更多日志行
hermes debug share --expire 30  # 保留粘贴内容 30 天
hermes debug share --local      # 将报告打印到终端（不上传）

`hermes backup`

hermes backup [options]

创建一个包含您的 Hermes 配置、技能、会话和数据的 zip 压缩包。备份不包括 hermes-agent 代码库本身。

选项	描述
`-o`, `--output <path>`	zip 文件的输出路径（默认：`~/hermes-backup-<timestamp>.zip`）。
`-q`, `--quick`	快速快照：仅包含关键状态文件（config.yaml, state.db, .env, auth, 定时任务）。比完整备份快得多。
`-l`, `--label <name>`	快照的标签（仅与 `--quick` 一起使用）。

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

zip 中排除的内容：

*.db-wal, *.db-shm, *.db-journal —— SQLite 的 WAL / 共享内存 / 日志附属文件。*.db 文件已通过 sqlite3.backup() 获得一致快照；将活动的附属文件与它一起打包会让恢复操作看到一个半提交的状态。
checkpoints/ —— 每会话轨迹缓存。基于哈希键且按会话重新生成；无论如何都无法干净地移植到另一个安装。
hermes-agent 代码本身（这是用户数据备份，不是仓库快照）。

示例

hermes backup                           # 完整备份到 ~/hermes-backup-*.zip
hermes backup -o /tmp/hermes.zip        # 完整备份到指定路径
hermes backup --quick                   # 仅状态的快速快照
hermes backup --quick --label "pre-upgrade"  # 带标签的快速快照

`hermes checkpoints`

hermes checkpoints [COMMAND]

检查和管理 ~/.hermes/checkpoints/ 处的阴影 git 存储——这是会话内 /rollback 命令背后的存储层。可随时安全运行；不需要智能体正在运行。

子命令	描述
`status` (默认)	显示总大小、项目数量以及每个项目的详细信息。裸命令 `hermes checkpoints` 等效。
`list`	`status` 的别名。
`prune`	强制执行清理扫描——删除孤立和过时的项目，垃圾回收存储，强制执行大小上限。忽略 24 小时的幂等性标记。
`clear`	删除整个检查点库。不可逆；除非使用 `-f`，否则会请求确认。
`clear-legacy`	仅删除由 v1→v2 迁移产生的 `legacy-<timestamp>/` 存档。

选项

选项	适用于子命令	描述
`--limit N`	`status`, `list`	要列出的最大项目数（默认 20）。
`--retention-days N`	`prune`	丢弃 `last_touch` 早于 N 天的项目（默认 7）。
`--max-size-mb N`	`prune`	在孤立/过时项目清理后，丢弃每个项目中最早的提交，直到总存储大小 ≤ N MB（默认 500）。
`--keep-orphans`	`prune`	跳过删除工作目录已不存在的项目。
`-f`, `--force`	`clear`, `clear-legacy`	跳过确认提示。

示例

hermes checkpoints                                  # 状态概览
hermes checkpoints prune --retention-days 3         # 激进清理
hermes checkpoints prune --max-size-mb 200          # 单次收紧大小上限
hermes checkpoints clear-legacy -f                  # 删除 v1 存档目录
hermes checkpoints clear -f                         # 清除所有内容

有关完整架构和会话内命令，请参阅检查点和 /rollback。

`hermes import`

hermes import <zipfile> [options]

将先前创建的 Hermes 备份恢复到您的 Hermes 主目录。存档中的所有文件会覆盖您 Hermes 主目录中的现有文件；--force 仅在目标已有 Hermes 安装时跳过确认提示。

选项	描述
`-f`, `--force`	跳过已有安装的确认提示。

注意

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

示例

hermes import ~/hermes-backup-20260423.zip           # 覆盖现有配置前会提示
hermes import ~/hermes-backup-20260423.zip --force   # 覆盖而不提示

`hermes logs`

hermes logs [log_name] [options]

查看、跟踪和筛选 Hermes 日志文件。所有日志存储在 ~/.hermes/logs/（对于非默认配置，则为 <profile>/logs/）。

日志文件

名称	文件	记录内容
`agent` (默认)	`agent.log`	所有智能体活动——API 调用、工具分发、会话生命周期（INFO 及以上级别）
`errors`	`errors.log`	仅警告和错误——agent.log 的过滤子集
`gateway`	`gateway.log`	消息网关活动——平台连接、消息分发、Webhook 事件

选项

选项	描述
`log_name`	要查看的日志：`agent`（默认）、`errors`、`gateway` 或 `list` 以显示可用文件及其大小。
`-n`, `--lines <N>`	要显示的行数（默认：50）。
`-f`, `--follow`	实时跟踪日志，类似 `tail -f`。按 Ctrl+C 停止。
`--level <LEVEL>`	要显示的最低日志级别：`DEBUG`、`INFO`、`WARNING`、`ERROR`、`CRITICAL`。
`--session <ID>`	筛选包含会话 ID 子字符串的行。
`--since <TIME>`	显示从相对时间前开始的行：`30m`、`1h`、`2d` 等。支持 `s`（秒）、`m`（分钟）、`h`（小时）、`d`（天）。
`--component <NAME>`	按组件筛选：`gateway`、`agent`、`tools`、`cli`、`cron`。

示例

# 查看 agent.log 的最后 50 行（默认）
hermes logs

# 实时跟踪 agent.log
hermes logs -f

# 查看 gateway.log 的最后 100 行
hermes logs gateway -n 100

# 仅显示来自过去一小时的警告和错误
hermes logs --level WARNING --since 1h

# 按特定会话筛选
hermes logs --session abc123

# 跟踪 errors.log，从 30 分钟前开始
hermes logs errors --since 30m -f

# 列出所有日志文件及其大小
hermes logs list

筛选

筛选条件可以组合。当多个筛选条件同时激活时，日志行必须全部通过才会被显示：

# 来自过去 2 小时、包含会话 "tg-12345" 的 WARNING 及以上级别行
hermes logs --level WARNING --since 2h --session tg-12345

当 --since 激活时，没有可解析时间戳的行也会被包含（它们可能是多行日志条目的续行）。当 --level 激活时，没有可检测级别的行也会被包含。

日志轮转

Hermes 使用 Python 的 RotatingFileHandler。旧日志会自动轮转——寻找 agent.log.1、agent.log.2 等。hermes logs list 子命令显示所有日志文件，包括已轮转的文件。

`hermes config`

hermes config <子命令>

子命令：

子命令	描述
`show`	显示当前配置值。
`edit`	在编辑器中打开 `config.yaml`。
`set <键> <值>`	设置一个配置值。
`path`	打印配置文件路径。
`env-path`	打印 `.env` 文件路径。
`check`	检查是否有缺失或过时的配置。
`migrate`	以交互方式添加新引入的选项。

`hermes pairing`

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

子命令	描述
`list`	显示待批准和已批准的用户。
`approve <平台> <代码>`	批准一个配对代码。
`revoke <平台> <用户ID>`	撤销用户的访问权限。
`clear-pending`	清除待处理的配对代码。

`hermes skills`

hermes skills <子命令>

子命令：

子命令	描述
`browse`	分页浏览技能注册表。
`search`	搜索技能注册表。
`install`	安装技能。
`inspect`	预览技能而不安装。
`list`	列出已安装技能。
`check`	检查已安装的中心技能是否有上游更新。
`update`	当有可用更新时，重新安装具有上游更改的中心技能。
`audit`	重新扫描已安装的中心技能。
`uninstall`	移除通过中心安装的技能。
`reset`	通过清除其清单条目，解除被标记为 `user_modified` 的捆绑技能的阻塞状态。使用 `--restore` 时，还会将用户副本替换为捆绑版本。
`publish`	将技能发布到注册表。
`snapshot`	导出/导入技能配置。
`tap`	管理自定义技能源。
`config`	按平台交互式启用/禁用技能配置。

常用示例：

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                     # 直接 URL（单个 SKILL.md 文件）
hermes skills install https://example.com/SKILL.md --name my-skill        # 当前端元数据无名称时覆盖名称
hermes skills check
hermes skills update
hermes skills config
hermes skills reset google-workspace
hermes skills reset google-workspace --restore --yes

说明：

--force 可覆盖第三方/社区技能的非危险策略限制。
--force 不能覆盖 dangerous 的扫描判定结果。
--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 URL 将直接安装单个 SKILL.md 文件。当前端元数据没有 name: 且 URL 段不是有效标识符时，交互式终端会提示输入名称；非交互界面（TUI 内的 /skills install、网关平台）则需要使用 --name <x>。

`hermes bundles`

hermes bundles <子命令>

技能包将多个技能分组到一个 /<bundle-name> 斜杠命令下。调用该包会将所有引用的技能加载到单个组合的用户消息中。存储位置：~/.hermes/skill-bundles/<slug>.yaml。参见技能包了解 YAML 模式和行为。

子命令：

子命令	描述
`list`	列出已安装的包（未指定子命令时的默认行为）
`show <名称>`	显示一个包的名称、描述、技能和文件路径
`create <名称>`	创建一个新包。传递 `--skill <id>`（可重复）或省略以进行交互式输入。可用参数：`--description`、`--instruction`、`--force`。
`delete <名称>`	移除一个包文件
`reload`	重新扫描 `~/.hermes/skill-bundles/` 并报告添加/移除的包

示例：

hermes bundles create backend-dev \
  --skill github-code-review \
  --skill test-driven-development \
  --skill github-pr-workflow \
  -d "后端功能开发"

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

在聊天会话中，/bundles 列出已安装的包，/<bundle-name> 加载一个包。

`hermes curator`

hermes curator <子命令>

策展人是一个辅助模型的后台任务，定期审查由智能体创建的技能，清理过时的技能，整合重叠部分，并归档废弃技能。打包的技能和通过中心安装的技能永远不会被触碰。归档是可恢复的；自动删除永远不会发生。

子命令	描述
`status`	显示策展人状态和技能统计信息
`run`	立即触发一次策展人审查（阻塞直到大语言模型处理完成）
`run --background`	在后台线程启动大语言模型处理并立即返回
`run --dry-run`	仅预览 — 生成审查报告，不做任何修改
`backup`	手动创建 `~/.hermes/skills/` 的 tar.gz 快照（策展人在每次实际运行前也会自动创建快照）
`rollback`	从快照恢复 `~/.hermes/skills/`（默认恢复最新的）
`rollback --list`	列出可用的快照
`rollback --id <时间戳>`	按 ID 恢复特定快照
`rollback -y`	跳过确认提示
`pause`	暂停策展人，直到恢复
`resume`	恢复已暂停的策展人
`pin <技能>`	固定一个技能，使策展人永远不会自动转变它
`unpin <技能>`	取消固定一个技能
`restore <技能>`	恢复一个已归档的技能
`archive <技能>`	手动归档一个技能
`prune`	手动清理策展人通常会清理的技能
`list-archived`	列出已归档的技能（可通过 `restore` 恢复）

新安装后，第一次计划的审查将延迟一个完整的 interval_hours（默认为 7 天）——网关不会在 hermes update 后的第一个时间点立即进行策展。在那之前，使用 hermes curator run --dry-run 进行预览。

参见策展人了解行为和配置。

`hermes fallback`

hermes fallback <子命令>

管理回退提供者链。当主模型因速率限制、过载或连接错误失败时，会按顺序尝试回退提供者。

子命令	描述
`list`（别名：`ls`）	显示当前的回退链（未指定子命令时的默认行为）
`add`	选择一个提供者 + 模型（与 `hermes model` 使用相同的选择器）并添加到链中
`remove`（别名：`rm`）	选择要从链中删除的条目
`clear`	移除所有回退条目

参见回退提供者。

`hermes hooks`

hermes hooks <子命令>

检查在 ~/.hermes/config.yaml 中声明的 shell 脚本钩子，使用合成有效负载测试它们，并管理 ~/.hermes/shell-hooks-allowlist.json 中的首次使用同意允许列表。

子命令	描述
`list`（别名：`ls`）	列出配置的钩子，包括匹配器、超时和同意状态
`test <事件>`	触发所有匹配 `<事件>` 的钩子，使用合成有效负载
`revoke`（别名：`remove`, `rm`）	移除某个命令的允许列表条目（下次重启时生效）
`doctor`	检查每个配置的钩子：执行位、允许列表、修改时间漂移、JSON 有效性和合成运行计时

参见钩子了解事件签名和有效负载结构。

`hermes memory`

hermes memory <子命令>

设置和管理外部记忆提供者插件。可用提供者：honcho, openviking, mem0, hindsight, holographic, retaindb, byterover, supermemory。一次只能激活一个外部提供者。内置记忆（MEMORY.md/USER.md）始终处于活动状态。

子命令：

子命令	描述
`setup`	交互式提供者选择和配置。
`status`	显示当前的记忆提供者配置。
`off`	禁用外部提供者（仅使用内置功能）。

提供者特定子命令

当一个外部记忆提供者处于活动状态时，它可能会注册自己的顶级 hermes <provider> 命令，用于提供者特定的管理（例如，当 Honcho 活动时为 hermes honcho）。未激活的提供者不会公开其子命令。运行 hermes --help 查看当前连接了哪些提供者。

`hermes acp`

hermes acp

将 Hermes 作为 ACP（智能体客户端协议）标准输入/输出服务器启动，用于编辑器集成。

`hermes mcp`

hermes mcp <子命令>

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

子命令	描述
(无) 或 `picker`	交互式目录选择器 — 浏览 Nous 批准的 MCP 并进行安装/启用/禁用。
`catalog`	列出 Nous 批准的 MCP（纯文本，可脚本化）。
`install <名称>`	安装一个目录条目（例如 `hermes mcp install n8n`）。
`serve [-v\|--verbose]`	将 Hermes 作为 MCP 服务器运行 — 向其他智能体公开对话。
`add <名称> [--url URL] [--command CMD] [--args ...] [--auth oauth\|header]`	添加一个自定义 MCP 服务器，并自动发现工具。
`remove <名称>`（别名：`rm`）	从配置中移除一个 MCP 服务器。
`list`（别名：`ls`）	列出已配置的 MCP 服务器。
`test <名称>`	测试到某个 MCP 服务器的连接。
`configure <名称>`（别名：`config`）	切换服务器的工具选择。
`login <名称>`	强制为基于 OAuth 的 MCP 服务器重新进行身份验证。

参见 MCP 配置参考、在 Hermes 中使用 MCP 和 MCP 服务器模式。

`hermes plugins`

hermes plugins [子命令]

统一插件管理 — 在一个地方管理通用插件、记忆提供器和上下文引擎。不带子命令运行 hermes plugins 将打开一个组合式交互界面，包含两个部分：

通用插件 — 用于启用/禁用已安装插件的多选复选框
提供器插件 — 用于配置记忆提供器和上下文引擎的单选设置。按 ENTER 键可打开单选选择器。

子命令	描述
(无)	组合式交互界面 — 通用插件开关 + 提供器插件配置。
`install <标识符> [--force]`	从 Git URL 或 `所有者/仓库` 安装插件。
`update <名称>`	拉取已安装插件的最新更改。
`remove <名称>` (别名: `rm`, `uninstall`)	移除已安装的插件。
`enable <名称>`	启用已禁用的插件。
`disable <名称>`	禁用插件但不移除它。
`list` (别名: `ls`)	列出已安装的插件及其启用/禁用状态。

提供器插件的配置选择会保存到 config.yaml：

memory.provider — 当前激活的记忆提供器（为空则表示仅使用内置）
context.engine — 当前激活的上下文引擎（"compressor" 为内置默认）

通用插件的禁用列表存储在 config.yaml 的 plugins.disabled 下。

参阅插件和构建 Hermes 插件。

`hermes tools`

hermes tools [--summary]

选项	描述
`--summary`	打印当前已启用工具的摘要并退出。

不带 --summary 参数时，此命令将启动交互式的按平台工具配置界面。

`hermes computer-use`

hermes computer-use <子命令>

子命令：

子命令	描述
`install`	运行上游的 cua-driver 安装程序（仅限 macOS）。
`install --upgrade`	即使 cua-driver 已在 PATH 中，也重新运行安装程序。上游脚本始终拉取最新版本，因此这会执行就地升级。
`status`	打印 `cua-driver` 是否在 `$PATH` 中以及安装的版本号。

hermes computer-use install 是用于安装 computer_use 工具集使用的 cua-driver 二进制文件的稳定入口。它运行的上游安装程序与您首次启用 Computer Use 时 hermes tools 调用的程序相同，因此如果工具集开关未触发安装（例如在用户设置时返回），可以安全地使用它来重新运行安装。

hermes update 在更新结束时会自动重新运行上游安装程序（如果 cua-driver 在 PATH 中），因此大多数用户不需要手动调用 --upgrade。当上游发布了您希望立即使用而不想等待下一个 Hermes 版本更新的修复时，请使用它。

`hermes sessions`

hermes sessions <子命令>

子命令：

子命令	描述
`list`	列出最近的会话。
`browse`	交互式会话选择器，支持搜索和恢复。
`export <output> [--session-id ID]`	将会话导出为 JSONL 格式。
`delete <session-id>`	删除一个会话。
`prune`	删除旧会话。
`stats`	显示会话存储统计信息。
`rename <session-id> <title>`	设置或更改会话标题。

`hermes insights`

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

选项	描述
`--days <n>`	分析最近 `n` 天（默认值：30）。
`--source <platform>`	按来源过滤，例如 `cli`、`telegram` 或 `discord`。

`hermes claw`

hermes claw migrate [选项]

将您的 OpenClaw 设置迁移到 Hermes。从 ~/.openclaw（或自定义路径）读取，并写入 ~/.hermes。自动检测旧目录名（~/.clawdbot、~/.moltbot）和配置文件名（clawdbot.json、moltbot.json）。

选项	描述
`--dry-run`	预览将要迁移的内容而不实际写入。
`--preset <name>`	迁移预设：`full`（所有兼容设置）或 `user-data`（排除基础设施配置）。两种预设都不会导入密钥——请显式传递 `--migrate-secrets`。
`--overwrite`	在冲突时覆盖现有的 Hermes 文件（默认：当计划有冲突时拒绝应用）。
`--migrate-secrets`	在迁移中包含 API 密钥。即使在使用 `--preset full` 时也需要显式指定。
`--no-backup`	跳过迁移前对 `~/.hermes/` 的 zip 快照（默认情况下，在应用前会将单个恢复点归档写入 `~/.hermes/backups/pre-migration-*.zip`；可通过 `hermes import` 恢复）。
`--source <path>`	自定义 OpenClaw 目录（默认：`~/.openclaw`）。
`--workspace-target <path>`	工作区说明（AGENTS.md）的目标目录。
`--skill-conflict <mode>`	处理技能名称冲突：`skip`（默认）、`overwrite` 或 `rename`。
`--yes`	跳过确认提示。

迁移内容

迁移涵盖人格、记忆、技能、模型提供商、消息平台、智能体行为、会话策略、MCP 服务器、TTS 等 30 多个类别。项目要么被直接导入到 Hermes 等效项中，要么被归档以供手动审查。

直接导入的项目： SOUL.md、MEMORY.md、USER.md、AGENTS.md、技能（4 个源目录）、默认模型、自定义提供商、MCP 服务器、消息平台令牌和白名单（Telegram、Discord、Slack、WhatsApp、Signal、Matrix、Mattermost）、智能体默认设置（推理努力度、压缩、人工延迟、时区、沙箱）、会话重置策略、审批规则、TTS 配置、浏览器设置、工具设置、执行超时、命令白名单、网关配置以及来自 3 个来源的 API 密钥。

归档供手动审查的项目： 定时任务、插件、钩子/网络钩子、记忆后端（QMD）、技能注册表配置、UI/身份、日志记录、多智能体设置、渠道绑定、IDENTITY.md、TOOLS.md、HEARTBEAT.md、BOOTSTRAP.md。

API 密钥解析 按优先级顺序检查三个来源：配置值 → ~/.openclaw/.env → auth-profiles.json。所有令牌字段都处理纯字符串、环境模板（${VAR}）和 SecretRef 对象。

有关完整的配置键映射、SecretRef 处理细节和迁移后检查清单，请参阅 完整迁移指南。

示例

# 预览将要迁移的内容
hermes claw migrate --dry-run

# 完整迁移（所有兼容设置，不含密钥）
hermes claw migrate --preset full

# 包含 API 密钥的完整迁移
hermes claw migrate --preset full --migrate-secrets

# 仅迁移用户数据（不含密钥），覆盖冲突
hermes claw migrate --preset user-data --overwrite

# 从自定义 OpenClaw 路径迁移
hermes claw migrate --source /home/user/old-openclaw

`hermes dashboard`

hermes dashboard [选项]

启动 Web 仪表板——一个基于浏览器的界面，用于管理配置、API 密钥和监控会话。需要 pip install hermes-agent[web]（FastAPI + Uvicorn）。内置的浏览器聊天标签页需要 --tui 加上 pty 扩展。完整文档请参阅 Web 仪表板。

选项	默认值	描述
`--port`	`9119`	运行 Web 服务器的端口
`--host`	`127.0.0.1`	绑定地址
`--no-open`	—	不要自动打开浏览器
`--tui`	关闭	通过在 PTY/WebSocket 桥后运行 `hermes --tui` 来启用浏览器内聊天标签页。需要 `pip install 'hermes-agent[web,pty]'` 以及 POSIX PTY 环境，如 Linux、macOS 或 WSL2。
`--insecure`	关闭	允许绑定到非 localhost 主机。会在网络上暴露仪表板凭据；请仅在受信任的网络控制下使用。
`--stop`	—	停止正在运行的 `hermes dashboard` 进程并退出。
`--status`	—	列出正在运行的 `hermes dashboard` 进程并退出。

# 默认 — 打开浏览器访问 http://127.0.0.1:9119
hermes dashboard

# 自定义端口，不打开浏览器
hermes dashboard --port 8080 --no-open

# 启用浏览器聊天标签页
hermes dashboard --tui

`hermes profile`

hermes profile <子命令>

管理配置文件——多个隔离的 Hermes 实例，每个实例都有自己的配置、会话、技能和主目录。

子命令	描述
`list`	列出所有配置文件。
`use <name>`	设置一个粘性默认配置文件。
`create <name> [--clone] [--clone-all] [--clone-from <source>] [--no-alias]`	创建新配置文件。`--clone` 从活动配置文件复制配置、`.env` 和 `SOUL.md`。`--clone-all` 复制所有状态。`--clone-from` 指定源配置文件。
`delete <name> [-y]`	删除配置文件。
`show <name>`	显示配置文件详情（主目录、配置等）。
`alias <name> [--remove] [--name NAME]`	管理用于快速访问配置文件的包装脚本。
`rename <old> <new>`	重命名配置文件。
`export <name> [-o FILE]`	将配置文件导出为 `.tar.gz` 归档文件（本地备份）。
`import <archive> [--name NAME]`	从 `.tar.gz` 归档文件导入配置文件（本地恢复）。
`install <source> [--name N] [--alias] [--force] [-y]`	从 Git URL 或本地目录安装配置文件发行版。
`update <name> [--force-config] [-y]`	重新拉取发行版；保留用户数据（记忆、会话、认证）。
`info <name>`	显示配置文件的发行版清单（版本、要求、来源）。

示例：

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 "来自工作配置文件的问候"

`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 [--check] [--backup] [--restart-gateway]

拉取最新的 hermes-agent 代码并在您的虚拟环境中重新安装依赖项，然后重新运行安装后钩子（MCP 服务器、技能同步、完成安装）。可在正在运行的系统上安全执行。

pip 安装： hermes update 会自动检测基于 pip 的安装——它会查询 PyPI 上的最新版本，并运行 pip install --upgrade hermes-agent，而不是 git pull。PyPI 发布跟踪标记版本（主/次版本），而不是 main 上的每次提交。使用 --check 可查看是否有更新的 PyPI 版本可用，而不进行安装。

选项	描述
`--check`	并排打印当前提交和最新的 `origin/main` 提交，如果同步则退出码为 0，如果落后则为 1。不会进行拉取、安装或重启操作。
`--backup`	在拉取前创建一个标记的更新前 `HERMES_HOME` 快照（配置、认证、会话、技能、配对数据）。默认为关闭——之前的总是备份行为会在大型主目录上为每次更新增加数分钟时间。通过在 `config.yaml` 中设置 `update.backup: true` 可永久开启此功能。
`--restart-gateway`	成功更新后，重启正在运行的网关服务。如果安装了多个配置文件，则隐含 `--all` 语义。

其他行为：

配对数据快照。 即使 --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。

维护命令

命令	描述
`hermes version`	打印版本信息。
`hermes update`	拉取最新更改并重新安装依赖项。
`hermes postinstall`	内部引导程序。在 `pip install hermes-agent`（或 pip 安装的 `hermes update`）后运行一次，用于安装 pip 无法提供的非 Python 依赖项——Node.js 运行时、无头浏览器、ripgrep、ffmpeg——然后在配置文件尚未配置时触发 `hermes setup`。可安全地幂等重复运行。
`hermes uninstall [--full] [--yes]`	移除 Hermes，可选择删除所有配置/数据。

全局入口点​

全局选项​

顶级命令​

hermes chat​

hermes -z <prompt> — 脚本化的单次调用​

hermes model

/model 斜杠命令（会话中）​

hermes lsp​

hermes setup​

hermes portal​

hermes whatsapp​

hermes slack​

hermes send​

hermes secrets​

hermes migrate​

hermes proxy​

hermes security​

hermes login / hermes logout (已弃用)​

hermes auth​

hermes status​

hermes cron​

hermes kanban​

hermes webhook​

hermes webhook subscribe​

hermes doctor​

hermes dump​

包含内容​

示例输出​

使用场景​

hermes debug​

示例​

hermes backup​

示例​

hermes checkpoints​

选项​

示例​

hermes import​

示例​

hermes logs​

日志文件​

选项​

示例​

筛选​

日志轮转​

hermes config​

hermes pairing​

hermes skills​

hermes bundles​

hermes curator​

hermes fallback​

hermes hooks​

hermes memory​

hermes acp​

hermes mcp​

hermes plugins​

hermes tools​

hermes computer-use

hermes sessions

hermes insights

hermes claw

迁移内容​

示例​

hermes dashboard

hermes profile

hermes completion

hermes update​

维护命令​

另请参阅​

全局入口点

全局选项

顶级命令

`hermes chat`

`hermes -z <prompt>` — 脚本化的单次调用

`hermes model`

`/model` 斜杠命令（会话中）

`hermes lsp`

`hermes setup`

`hermes portal`

`hermes whatsapp`

`hermes slack`

`hermes send`

`hermes secrets`

`hermes migrate`

`hermes proxy`

`hermes security`

`hermes login` / `hermes logout` (已弃用)

`hermes auth`

`hermes status`

`hermes cron`

`hermes kanban`

`hermes webhook`

`hermes webhook subscribe`

`hermes doctor`

`hermes dump`

包含内容

示例输出

使用场景

`hermes debug`

示例

`hermes backup`

示例

`hermes checkpoints`

选项

示例

`hermes import`

示例

`hermes logs`

日志文件

选项

示例

筛选

日志轮转

`hermes config`

`hermes pairing`

`hermes skills`

`hermes bundles`

`hermes curator`

`hermes fallback`

`hermes hooks`

`hermes memory`

`hermes acp`

`hermes mcp`

`hermes plugins`

`hermes tools`

`hermes computer-use`

`hermes sessions`

`hermes insights`

`hermes claw`

迁移内容

示例

`hermes dashboard`

`hermes profile`

`hermes completion`

`hermes update`

维护命令

另请参阅