hermes教程-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 是最纯粹的一次性入口点：单个提示输入，最终响应文本输出，stdout 和 stderr 上无其他内容。 无横幅、无旋转器、无工具预览、无 Session: 行 — 只有代理的最终回复作为纯文本。

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 "…"

相同的代理、相同的工具、相同的技能 — 只是去掉了所有交互/装饰层。如果您还需要记录中的工具输出，请改用 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：

信息 — 如果我只看到 OpenRouter 模型怎么办？

如果您只配置了 OpenRouter，/model 将只显示 OpenRouter 模型。要添加其他提供商（Anthropic、DeepSeek、Copilot 等），请退出会话并从终端运行 hermes model。

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

hermes gateway

hermes gateway <subcommand>

子命令：

选项：

提示 — 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 工作区检测限制 — LSP 仅在当前工作目录或编辑的文件位于 git 工作树内时运行。

子命令：

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

hermes setup

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

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

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

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

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

选项：

hermes portal

hermes portal [status|open|tools]

检查 Nous Portal 认证、工具网关路由并访问订阅页面。无子命令调用运行 status。

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

hermes whatsapp

hermes whatsapp

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

hermes slack

hermes slack manifest              # 将清单打印到 stdout
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 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），因此运维脚本、cron 作业、CI 钩子和监控守护进程可以发布状态更新，而无需重新实现每个平台的 REST 客户端。

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

如果既没有提供位置参数 message 也没有提供 --file，则当 stdin 不是 TTY 时，hermes send 从 stdin 读取。退出代码：0 成功，1 投递/后端失败，2 使用错误。

发送图像和其他媒体

--file 仅用于文本正文。要将图像、文档、视频或音频文件作为原生平台附件投递，请在消息文本中使用 MEDIA:<local_path> 指令引用它：

hermes send --to telegram "MEDIA:/tmp/screenshot.png"
hermes send --to telegram "Build chart for today MEDIA:/tmp/chart.png"   # 带标题
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                  # 所有平台
hermes send --list telegram         # 按平台过滤

hermes secrets

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

在进程启动时从外部密钥管理器拉取 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 venv（已安装的 PyPI 发行版）、~/.hermes/plugins/ 下插件声明的 Python 依赖项，以及 config.yaml 中固定的 npx/uvx MCP 服务器。不扫描全局安装的包或编辑器/浏览器扩展。

audit 标志：

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]

hermes cron

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

hermes kanban

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

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

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

这是人类/脚本接口。 由调度器生成的工作代理通过专用的 kanban_* 工具集（kanban_show、kanban_complete、kanban_block、kanban_create、kanban_link、kanban_comment、kanban_heartbeat；编排器配置文件还获得 kanban_list 和 kanban_unblock）驱动看板，而不是 shell 到 hermes kanban。工作代理在其环境中固定了 HERMES_KANBAN_BOARD，因此它们物理上无法看到其他看板。

示例：

## 创建第二个看板并在其上放置任务，无需切换。
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 平台 — 如果未配置，则打印设置说明。

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]

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

报告包括系统信息（操作系统、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 代码库本身。

备份使用 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 命令背后的存储层。随时安全运行；不需要代理正在运行。

选项

示例

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 安装时触发的确认提示。

警告

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

示例

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.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 prompt-size

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

报告新会话的固定提示预算 — 在任何对话内容之前每次 API 调用发送的内容。当下游适配器或代理的提示预算比模型的上下文窗口更紧，或者当您想查看哪个块（技能索引、内存、配置文件）占主导地位时很有用。

它构建与代理相同的系统提示，然后分解：

• 系统提示总计 — 完整组装的提示（身份、指导、技能索引、上下文文件、内存、配置文件、时间戳）。
• 技能索引 — <available_skills> 块。当安装了许多技能时，这通常是最大的单个块。
• 内存和用户配置文件 — 您的 MEMORY.md / USER.md 快照。
• 提示层级 — 稳定 / 上下文 / 易失，匹配 Hermes 为缓存友好性分层提示的方式。
• 工具模式 — 所有启用工具的 JSON（固定每次调用负载的另一半）。

完全离线运行 — 无 API 调用，无需配置凭据即可工作。

## CLI 平台的人类可读分解（默认）
hermes prompt-size
## 模拟消息平台的提示（不同的平台提示）
hermes prompt-size --platform telegram
## 脚本的机器可读输出
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                     # 直接 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
hermes skills opt-out                  # 停止未来的捆绑技能种子（不删除任何内容）
hermes skills opt-out --remove --yes   # 同时删除未修改的捆绑技能
hermes skills opt-in --sync            # 撤销：删除标记并立即重新种子

注意：

• --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 slug 不是有效标识符时，交互式终端会提示输入名称；非交互式界面（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>

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

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

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

hermes fallback

hermes fallback <subcommand>

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

请参阅回退提供商。

hermes hooks

hermes hooks <subcommand>

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

请参阅钩子了解事件签名和负载形状。

hermes memory

hermes memory <subcommand>

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

子命令：

信息 — 特定提供商的子命令

当外部内存提供商处于活动状态时，它可能会注册自己的顶级 hermes <provider> 命令，用于提供商特定的管理（例如，当 Honcho 处于活动状态时，hermes honcho）。非活动提供商不会暴露其子命令。运行 hermes --help 查看当前连接的内容。

hermes acp

hermes acp

将 Hermes 作为 ACP（Agent Client Protocol）stdio 服务器启动，用于编辑器集成。

相关入口点：

hermes-acp
python -m acp_adapter

首先安装支持：

pip install -e '.[acp]'

请参阅ACP 编辑器集成和ACP 内部。

hermes mcp

hermes mcp <subcommand>

管理 MCP（Model Context Protocol）服务器配置，并将 Hermes 作为 MCP 服务器运行。

请参阅MCP 配置参考、将 MCP 与 Hermes 一起使用和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 时，启动交互式按平台工具配置 UI。

hermes computer-use

hermes computer-use <subcommand>

子命令：

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

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

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）。

迁移的内容

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

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

归档以供手动审查： cron 任务、插件、钩子/webhook、内存后端（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 [options]

启动 Web 仪表板 — 一个基于浏览器的 UI，用于管理配置、API 密钥和监控会话。需要 pip install hermes-agent[web]（FastAPI + Uvicorn）。嵌入式浏览器聊天选项卡始终可用，并且还需要 pty 额外依赖（pip install 'hermes-agent[web,pty]'）以及 POSIX PTY 环境，例如 Linux、macOS 或 WSL2。请参阅Web 仪表板获取完整文档。

## 默认 — 打开浏览器到 http://127.0.0.1:9119
hermes dashboard
## 自定义端口，无浏览器
hermes dashboard --port 8080 --no-open
## 从配置文件别名 — 路由到机器仪表板，并在侧边栏切换器中预选配置文件（如果正在运行则附加）
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 补全脚本打印到 stdout。将输出源到您的 shell 配置文件中，以获得 Hermes 命令、子命令和配置文件名称的制表符补全。

示例：

## 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 代码并在您的 venv 中重新安装依赖项，然后重新运行安装后钩子（MCP 服务器、技能同步、补全安装）。在实时安装上安全运行。

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

git 安装： hermes update 拉取配置的更新分支（默认：main）。如果您的检出在另一个分支上，Hermes 可能会在拉取前检出更新分支。在更新前提交分支工作，如果您想将其保留在更新自动暂存流之外。

其他行为：

• 网关重启。 成功更新后，Hermes 会尝试自动重启所有正在运行的网关配置文件，以便它们获取新代码。当您想重启网关而不应用更新时，请使用 hermes gateway restart。
• 本地源更改。 对于 git 安装，脏跟踪文件和未跟踪文件会在分支检出或拉取前自动暂存（git stash push --include-untracked）。交互式终端更新会在恢复暂存前询问。非交互式更新默认恢复暂存；仅在托管安装上设置 updates.non_interactive_local_changes: discard，其中本地源编辑应在成功拉取后丢弃。如果暂存恢复冲突或拉取失败，暂存会保留在原位以供手动恢复。
• npm 锁文件变动。 在暂存或切换分支之前，Hermes 会尽力清理由 npm install/build 步骤产生的跟踪 package-lock.json 差异。在运行 hermes update 之前，提交或手动暂存有意的锁文件编辑。
• 配对数据快照。 即使 --backup 关闭，hermes update 也会在 git pull 之前创建 ~/.hermes/pairing/ 和飞书评论规则的轻量级快照。如果拉取重写了您正在编辑的文件，您可以使用 hermes backup restore --state pre-update 回滚。
• 旧版 hermes.service 警告。 如果 Hermes 检测到重命名前的 hermes.service systemd 单元（而不是当前的 hermes-gateway.service），它会打印一次性迁移提示，以便您避免 flap-loop 问题。
• 退出代码。 0 成功，1 拉取/安装/安装后错误，2 阻止 git pull 的意外工作树更改。

维护命令

另请参阅

• 斜杠命令参考
• CLI 界面
• 会话
• 技能系统
• 皮肤和主题