Hermes Agent CLI 与 Slash 命令离线总表

本文分为两个部分：

CLI 命令参考

本页涵盖你在 shell 中运行的终端命令。

关于聊天内斜杠命令，见本文后半部分。

全局入口点

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

全局选项

顶层命令

hermes chat

hermes chat [options]

常用选项：

示例：

hermes
hermeschat-q"Summarize the latest PRs"
hermeschat--provideropenrouter--modelanthropic/claude-sonnet-4.6
hermeschat--toolsetsweb,terminal,skills
hermeschat--quiet-q"Return only JSON"
hermeschat--worktree-q"Review this repo and open a PR"
hermeschat--ignore-user-config--ignore-rules-q"Repro without my personal setup"

hermes -z <prompt> — 脚本化一次性调用

对于程序化调用者（shell 脚本、CI、cron、通过管道传入提示的父进程），hermes -z 是最纯粹的一次性入口点：单次提示输入，最终响应文本输出，stdout 和 stderr 上无其他内容。 没有横幅、没有旋转动画、没有工具预览、没有 Session: 行——只有 Agent 的最终回复作为纯文本。

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

# 父脚本可以干净地捕获响应：
answer=$(hermes -z "summarize this" < /path/to/file.txt)

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

hermes -z "…" --provider openrouter --model openai/gpt-5.5
# 或者：
HERMES_INFERENCE_MODEL=anthropic/claude-sonnet-4.6 hermes -z "…"

相同的 Agent、相同的工具、相同的技能——只是去掉了所有交互/装饰层。如果你也需要在记录中看到工具输出，请改用 hermes chat -q；-z 明确用于“我只想要最终答案”。

hermes model

交互式提供商 + 模型选择器。这是用于添加新提供商、设置 API 密钥以及运行 OAuth 流程的命令。 从终端运行它——而不是在活跃的 Hermes 聊天会话内部。

hermes model

在以下情况下使用此命令：

WARNING: 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

hermes gateway <子命令>

子命令：

选项：

TIP: WSL 用户

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

hermes setup

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

首次运行： 启动首次使用向导。

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

直接跳转到某个部分而不是完整的向导：

选项：

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 → 你的应用 → Features → App Manifest → Edit，然后点击Save。如果作用域或斜杠命令发生变化，Slack 会提示重新安装。

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

hermes login / hermes logout(已弃用)

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

hermes auth

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

hermes auth# 交互式向导
hermesauthlist# 显示所有池
hermesauthlistopenrouter# 显示特定提供商
hermesauthaddopenrouter--api-keysk-or-v1-xxx# 添加 API 密钥
hermesauthaddanthropic--typeoauth# 添加 OAuth 凭据
hermesauthremoveopenrouter2# 按索引移除
hermesauthresetopenrouter# 清除冷却状态

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

hermes status

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

hermes cron

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

hermes kanban

hermes kanban <action> [options]

多配置文件协作看板。任务存储在 ~/.hermes/kanban.db（WAL 模式 SQLite）；所有配置文件读写同一个看板。由 cron 驱动的调度器（hermes kanban dispatch）原子性地认领就绪任务，并将分配的配置文件作为独立进程启动，拥有隔离的工作空间。

完整设计（包括与 Cline Kanban / Paperclip / NanoClaw / Gemini Enterprise 的对比、八种协作模式、四个用户故事、并发正确性证明）请参见仓库中的 docs/hermes-kanban-v1-spec.pdf 或 Kanban 用户指南。

hermes webhook

hermes webhook <subscribe|list|remove|test>

管理动态 webhook 订阅，用于事件驱动的 Agent 激活。需要在配置中启用 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 issue 或 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 ---

何时使用

TIP:**hermes dump**** 是专为分享而设计的。如需交互式诊断，请使用****hermes doctor**。如需可视化概览，请使用**hermes status**。

hermes debug

hermes debug share [options]

将调试报告（系统信息 + 近期日志）上传到粘贴服务，并获取一个可分享的 URL。适用于快速支持请求 —— 包含助手诊断你的问题所需的一切信息。

报告包含系统信息（操作系统、Python 版本、Hermes 版本）、最近的 agent 和 gateway 日志（每个文件限制 512 KB），以及脱敏后的 API 密钥状态。密钥始终会被脱敏 —— 不会上传任何秘密信息。

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

示例

hermes debugshare# 上传调试报告，打印 URL
hermesdebugshare--lines500# 包含更多日志行
hermesdebugshare--expire30# 让粘贴保留 30 天
hermesdebugshare--local# 在终端打印报告（不上传）

hermes backup

hermes backup [options]

将你的 Hermes 配置、技能、会话和数据创建成一个 zip 归档。备份不包含 hermes-agent 的代码库本身。

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

zip 中排除的内容：

示例

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

hermes import

hermes import <zipfile> [options]

将之前创建的 Hermes 备份恢复到你的 Hermes 主目录中。

hermes logs

hermes logs [log_name] [options]

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

日志文件

选项

示例

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

# 实时跟踪 agent.log
hermeslogs-f

# 查看 gateway.log 的最后 100 行
hermeslogsgateway-n100

# 仅显示过去一小时的警告和错误
hermeslogs--levelWARNING--since1h

# 按特定会话过滤
hermeslogs--sessionabc123

# 跟踪 errors.log，从 30 分钟前开始
hermeslogserrors--since30m-f

# 列出所有日志文件及其大小
hermeslogslist

过滤

过滤器可以组合使用。当多个过滤器同时生效时，日志行必须通过所有过滤器才会显示：

# 最近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 <子命令>

子命令：

hermes pairing

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

hermes skills

hermes skills <子命令>

子命令：

常见示例：

hermes skillsbrowse
hermesskillsbrowse--sourceofficial
hermesskillssearchreact--sourceskills-sh
hermesskillssearchhttps://mintlify.com/docs--sourcewell-known
hermesskillsinspectofficial/security/1password
hermesskillsinspectskills-sh/vercel-labs/json-render/json-render-react
hermesskillsinstallofficial/migration/openclaw-migration
hermesskillsinstallskills-sh/anthropics/skills/pdf--force
hermesskillsinstallhttps://sharethis.chat/SKILL.md# 直接 URL（单文件 SKILL.md）
hermesskillsinstallhttps://example.com/SKILL.md--namemy-skill# 当 frontmatter 中没有名称时覆盖名称
hermesskillscheck
hermesskillsupdate
hermesskillsconfig

注意：

hermes curator

hermes curator <子命令>

策展人是一个辅助模型后台任务，它会定期审查 Agent 创建的技能、清理过时的技能、合并重叠的技能，并归档废弃的技能。捆绑安装和从中心安装的技能永远不会被触及。归档的技能可以恢复，不会自动删除。

在全新安装时，第一次计划执行会延迟一个完整的 interval_hours（默认 7 天）——网关不会在 hermes update 后的第一个 tick 立即执行策展。在此之前，可以使用 hermes curator run --dry-run 进行预览。

有关行为和配置，请参见策展人。

hermes fallback

hermes fallback <子命令>

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

请参见回退提供者。

hermes hooks

hermes hooks <子命令>

检查在 ~/.hermes/config.yaml 中声明的 shell 脚本钩子，用模拟负载测试它们，并管理位于 ~/.hermes/shell-hooks-allowlist.json 的首次使用同意白名单。

有关事件签名和负载格式，请参见钩子。

hermes memory

hermes memory <子命令>

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

子命令：

INFO: 提供者专属子命令

当外部记忆提供者处于激活状态时，它可能会注册自己的顶级 hermes <provider> 命令，用于提供者专属管理（例如，当 Honcho 激活时使用 hermes honcho）。未激活的提供者不会暴露其子命令。运行 hermes --help 查看当前已接入的命令。

hermes acp

hermes acp

将 Hermes 作为 ACP（Agent 客户端协议）stdio 服务器启动，用于编辑器集成。

相关入口点：

hermes-acp
python -m acp_adapter

首先安装支持：

pip install -e '.[acp]'

参见 ACP 编辑器集成 和 ACP 内部机制。

hermes mcp

hermes mcp <子命令>

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

参见 MCP 配置参考、将 MCP 与 Hermes 结合使用 和 MCP 服务器模式。

hermes plugins

hermes plugins [子命令]

统一插件管理——通用插件、记忆提供者和上下文引擎集中管理。运行 hermes plugins 而不带子命令会打开一个复合交互式屏幕，包含两个部分：

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

参见 插件 和 构建 Hermes 插件。

hermes tools

hermes tools [--summary]

不带 --summary 时，会启动交互式按平台工具配置界面。

hermes sessions

hermes sessions <子命令>

子命令：

hermes insights

hermes insights [--days N] [--source 平台]

hermes claw

hermes claw migrate [选项]

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

迁移内容

迁移涵盖 30 多个类别，包括角色、记忆、技能、模型提供商、消息平台、Agent 行为、会话策略、MCP 服务器、TTS 等。项目要么直接导入到 Hermes 的对应项中，要么归档以供手动审查。

直接导入： SOUL.md, MEMORY.md, USER.md, AGENTS.md, skills（4个源代码目录），默认模型，自定义提供者，MCP服务器，消息平台令牌和允许列表（Telegram, Discord, Slack, WhatsApp, Signal, Matrix, Mattermost），agent 默认值（reasoning effort、compression、human delay、timezone、sandbox），会话重置策略，审批规则，TTS配置，浏览器设置，工具设置，执行超时，命令允许列表，网关配置以及来自3个来源的API密钥。

归档供手动审查： Cron任务，插件，hooks/webhooks，记忆后端（QMD），技能注册表配置，UI/身份，日志记录，多 Agent 设置，频道绑定，IDENTITY.md，TOOLS.md，HEARTBEAT.md，BOOTSTRAP.md。

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

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

示例

# Preview what would be migrated
hermesclawmigrate--dry-run

# Full migration (all compatible settings, no secrets)
hermesclawmigrate--presetfull

# Full migration including API keys
hermesclawmigrate--presetfull--migrate-secrets

# Migrate user data only (no secrets), overwrite conflicts
hermesclawmigrate--presetuser-data--overwrite

# Migrate from a custom OpenClaw path
hermesclawmigrate--source/home/user/old-openclaw

hermes dashboard

hermes dashboard [options]

启动 Web 仪表盘——一个基于浏览器的用户界面，用于管理配置、API 密钥和监控会话。需要 pip install hermes-agent[web]（FastAPI + Uvicorn）。完整文档请参见 Web Dashboard。

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

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

hermes profile

hermes profile <subcommand>

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

hermes profilelist
hermesprofilecreatework--clone
hermesprofileusework
hermesprofilealiaswork--nameh-work
hermesprofileexportwork-owork-backup.tar.gz
hermesprofileimportwork-backup.tar.gz--namerestored
hermes-pworkchat-q"Hello from work profile"

hermes completion

hermes completion [bash|zsh|fish]

将 shell 补全脚本输出到标准输出。将输出内容 source 到你的 shell 配置文件中，即可为 Hermes 命令、子命令和配置文件名称启用 Tab 补全。

示例：

# Bash
hermescompletionbash>>~/.bashrc

# Zsh
hermescompletionzsh>>~/.zshrc

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

hermes update

hermes update [--check] [--backup] [--restart-gateway]

拉取最新的 hermes-agent 代码，并在你的 venv 中重新安装依赖，然后重新运行安装后钩子（MCP 服务器、技能同步、补全安装）。可以在正在运行的安装上安全执行。

额外行为：

hermes fallback

hermes fallback           # 交互式管理器

管理回退提供商链（当你的主要提供商遇到速率限制或返回致命错误时使用），无需手动编辑 config.yaml。复用 hermes model 中的提供商选择器——相同的提供商列表、相同的凭据提示、相同的验证。

典型会话：

所有更改都会持久化到 config.yaml 中 model: 下的 fallback_providers:。与凭据池交互：凭据池在一个提供商内部轮换密钥，回退则完全切换到另一个提供商。

关于行为细节以及与 fallback_model（旧版单回退键）的交互，请参见回退提供者。

维护命令

另请参阅

Slash 命令参考

Hermes 有两个斜杠命令界面，两者均由 hermes_cli/commands.py 中的中央 COMMAND_REGISTRY 驱动：

已安装的技能也会作为动态斜杠命令暴露在这两个界面上。这包括内置技能，如 /plan，它会打开计划模式并将 Markdown 计划保存在相对于当前工作区/后端工作目录的 .hermes/plans/ 下。

交互式 CLI Slash 命令

在 CLI 中输入 / 即可打开自动补全菜单。内建命令不区分大小写。

会话（Session）

配置

工具与技能

信息

退出

动态 CLI 斜杠命令

快速命令

用户定义的快速命令将短斜杠命令映射到 shell 命令或其他斜杠命令。在 ~/.hermes/config.yaml 中配置：

quick_commands:
  status:
    type:exec
    command:systemctl status hermes-agent
  deploy:
    type:exec
    command:scripts/deploy.sh
  inbox:
    type:alias
    target:/gmail unread

然后在 CLI 或消息平台中输入 /status、/deploy 或 /inbox。快速命令在调度时解析，可能不会出现在每个内置的自动补全/帮助表中。

纯字符串的提示快捷方式不支持作为快速命令。将较长的可重用提示放入技能中，或使用 type: alias 指向现有的斜杠命令。

别名解析

命令支持前缀匹配：输入 /h 解析为 /help，/mod 解析为 /model。当前缀不明确（匹配多个命令）时，按注册顺序取第一个匹配项。完整命令名称和已注册的别名始终优先于前缀匹配。

消息斜杠命令

消息网关在 Telegram、Discord、Slack、WhatsApp、Signal、Email 和 Home Assistant 聊天中支持以下内置命令：

注意事项