⌨️ 02-CLI 命令参考LCP

这页查的是你在终端 shell 里运行的 hermes ... 命令。 如果你要查聊天窗口里的 /help、/tools、/model，请看 03-Slash Commands 参考。

🎯 1. 页面用途

这一页只做一件事：

帮你快速查 Hermes 的 CLI 命令，也就是你在终端里直接输入的 hermes ...。

它适合用来查：

• Hermes 的全局入口长什么样
• 常用 global options 是什么
• hermes chat、hermes model、hermes setup、hermes gateway 这些主命令分别干什么
• profile、config、tools、skills、mcp、sessions、dashboard 这些命令该在什么时候用
• 哪些命令只是查状态，哪些命令会真的改配置

这页不负责：

• slash commands 排查
• 命令报错排查
• provider / model 连接失败排查
• gateway 平台接入失败排查

如果你已经不是“查命令”，而是“命令不工作”，请直接跳到文末的“出问题了去哪”。

🔹 2. 官方来源

• 官方页面：https://hermes-agent.nousresearch.com/docs/reference/cli-commands
• 官方页面标题：CLI Commands Reference
• 官方页面定位：记录从 shell / terminal 里运行的 Hermes CLI 命令

中文站这一页遵循官方 Reference 的命令边界与分组思路，但会把过于专业的表述改成更容易扫读的中文说明。

🧭 3. 什么时候查这页

你遇到下面这些场景时，就该来这页：

• 你想确认 Hermes 的主入口命令怎么写
• 你知道要用 CLI，但记不清具体子命令
• 你想分清 hermes model 和 /model 的边界
• 你想查 profile、gateway、cron、logs、config、backup 这些命令的用途
• 你想知道某个命令是“交互式配置”，还是“脚本式调用”

如果你只是刚入门，还没建立 Hermes 使用心智，建议先看：

• 01-从这开始 / 02-开始上手 / 02-认识 Hermes 的基本使用方式
• 01-从这开始 / 02-开始上手 / 03-常用斜杠命令与会话管理

🧠 4. 核心概念中文解释

4.1 CLI 命令和 Slash Commands 不是一回事

先记住最重要的一条：

• CLI 命令：你在终端里输入 hermes ...
• Slash Commands：你已经进入 Hermes 对话后，在会话里输入 /...

例如：

hermes model
hermes chat --continue
hermes gateway status

这些都属于 CLI 命令。

而下面这些：

/model
/tools
/help
/new

属于会话中的 slash commands，不属于这页。

4.2 Hermes 的 CLI 总入口长这样

官方的总入口格式是：

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

可以把它理解成三层：

• hermes：主入口
• global-options：这次调用的全局选项
• command / subcommand：你要执行的具体能力

4.3 Global options 是“这一次怎么运行”

global options 决定的是“这次运行方式”，不是某个子命令自己的内部参数。

例如：

• 这次用哪个 profile：--profile
• 这次恢复哪个会话：--resume / --continue
• 这次是不是要开 worktree：--worktree
• 这次是否跳过审批：--yolo
• 这次是否忽略本地 config：--ignore-user-config

4.4 Top-level commands 是“你到底要做什么”

当你写：

hermes chat
hermes model
hermes setup
hermes gateway status

真正决定你在干什么的，是 chat、model、setup、gateway 这些主命令。

所以阅读 CLI Reference 时，最好的方式不是死背全量命令，而是先分清命令族：

• 聊天与会话
• 模型与鉴权
• 配置与维护
• 网关与自动化
• 工具与技能
• 数据、日志与备份
• profile 与环境隔离

⚡ 5. 常用项速查

5.1 最常查的入口命令

5.2 最常用的 global options

5.3 最容易混淆的一组命令

🗂️ 6. 完整参考结构

6.1 Global entrypoint

官方总格式：

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

如果你不知道某个命令该放哪，先回到这个格式理解：

• 先决定这次 Hermes 要做什么：chat / model / gateway / config / profile ...
• 再决定是否要加本次全局行为：--profile / --resume / --worktree
• 最后再填各自子命令和参数

6.2 聊天与模型相关命令

hermes chat

hermes chat [options]

常用参数：

中文站补充理解：

• 想“马上开始聊天”，用 hermes 或 hermes chat
• 想“一次问完就退出”，用 hermes chat -q
• 想“接着上次干”，优先记住 --continue
• 想“这次先限制工具权限”，看 --toolsets

hermes model

这是终端里的完整 provider + model 配置入口。

它适合：

• 新增 provider
• 跑 OAuth 登录
• 填 API Key
• 选默认模型
• 配自定义 endpoint

最重要的边界：

• hermes model：终端里做完整配置
• /model：会话里切换已经配置好的模型

如果你要“新增 provider”，不要在会话里折腾 /model，直接退出会话后运行：

hermes model

6.3 配置、状态与维护命令

hermes setup

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

适合第一次配置，或者你知道自己只想补某个配置块时使用。

hermes config

hermes config <subcommand>

常见子命令：

hermes status

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

适合快速看：

• 当前模型 / provider
• 认证状态
• 平台状态
• 是否要做更深的检查

hermes doctor

hermes doctor [--fix]

适合：

• 不知道哪里坏了
• 更新后状态怪异
• 想先做一次系统性体检

输出按层分段，每段对应一个故障层。完整字段对照表见 02-安装更新与环境问题 — hermes doctor 输出字段对照表。

最常见三种判断：

--fix 参数会尝试自动修复部分常见问题（例如 linger 没开、shell PATH 没生效等），但不会动你的 config.yaml。

维护相关命令

6.4 Gateway、自动化与平台相关命令

hermes gateway

hermes gateway <subcommand>

常见子命令：

官方特别提醒：

• WSL 用户优先用 hermes gateway run
• 不要默认把 start 当成 WSL 的标准方案

其他自动化 / 平台命令

6.5 数据、日志、备份与调试命令

6.6 工具、技能、MCP 与扩展命令

hermes skills 子命令速查（高频使用）

hermes skills 是 skills 系统的总入口，下面 7 个子命令覆盖浏览、搜索、安装、检查、卸载、源管理全流程。

--source 选项：install 和 browse 支持 --source 指定来源：

• --source official：只看 Hermes 官方内置 skill
• --source skills-sh：从社区聚合站 skills.sh 装
• --source <custom-github>：从你 tap 过的自定义仓库装

三种 skill 来源层级：

更多 skill 系统说明：09-内置 Skills 目录、10-可选 Skills 目录、15-自定义 Skills。

来源：官方文档 — User Guide: Skills；runoob — Hermes Agent Skills；SegmentFault — 必装 10 个 skill。

6.7 Profile、环境隔离与迁移命令

其中 hermes profile 常见子命令包括：

• list
• use <name>
• create <name>
• delete <name>
• show <name>
• alias <name>
• rename <old> <new>
• export <name>
• import <archive>

⚠️ 7. 注意事项

7.1 不要把 CLI Commands 和 Slash Commands 混成一页脑内模型

这是新手最容易乱的地方：

• hermes model 是终端命令
• /model 是会话命令
• hermes tools 是终端命令
• /tools 是会话命令

它们有关联，但不是一个入口。

7.2 不是每个命令都适合“先背下来”

先记最常用的一层就够：

• hermes
• hermes chat --continue
• hermes model
• hermes setup
• hermes doctor
• hermes gateway status
• hermes profile

剩下的查表即可，不需要一上来全记住。

7.3 hermes auth 已经替代旧的 hermes login / logout

官方现在已明确提示：

• hermes login 已移除 / 废弃
• 认证管理优先看 hermes auth
• provider 和 model 的交互式设置入口优先看 hermes model

7.4 这页是“查命令”，不是“查为什么失败”

比如：

• 你想知道 hermes gateway install 是什么，这页能解决
• 你想知道为什么 gateway 装了但 Telegram 不通，这页不解决

后者请直接去故障页。

🚦 8. 出问题了去哪

如果你已经进入“命令会跑，但结果不对 / 命令根本不工作”的阶段，直接按这里跳：

🌐 9. 官方原文链接

• 官方 CLI Commands Reference：https://hermes-agent.nousresearch.com/docs/reference/cli-commands
• 官方 Slash Commands Reference：https://hermes-agent.nousresearch.com/docs/reference/slash-commands

如果你需要逐项核对完整参数、完整子命令或最新变更，以官方原文为准。

📚 10. 相关中文站页面

• 01-总览｜Reference 参考手册
• 01-从这开始 / 02-开始上手 / 02-认识 Hermes 的基本使用方式
• 01-从这开始 / 02-开始上手 / 03-常用斜杠命令与会话管理
• 05-遇到问题 / 04-CLI TUI 与会话问题
• 05-遇到问题 / 07-配置 Profiles 与环境隔离问题

➡️ 下一步

完成后进入：

• 03-Slash Commands 参考

如果你想先回到上一阶段入口重新确认位置：

• 01-总览｜Reference 参考手册

🔗 Reference 相关入口

• 第一次使用 Hermes：先看从这开始，不要直接从参考表硬啃。
• 查命令：看CLI 命令参考和Slash Commands 参考。
• 查 Profiles / Tools / Skills / MCP：分别看Profile 命令参考、Built-in Tools 参考、内置 Skills 目录和MCP 配置参考。
• 配置报错：回到遇到问题，按模型、Gateway、Tools、Profiles 或远程环境分类排查。