作为当下轻量化、高灵活度的 AI 智能体工具，Hermes Agent 凭借强大的本地交互、任务自动化、多模型适配能力，成为开发者、效率爱好者的常用工具。熟练掌握其命令体系，能彻底释放它的自动化潜力，告别低效的手动交互。
本文将从零梳理 Hermes Agent 全套核心命令，区分终端 CLI 命令、会话内斜杠命令，搭配实操示例、场景用法和避坑要点，新手可直接上手，老手可查漏补缺，一站式搞定所有常用操作。
一、前置认知：Hermes 命令两大核心体系
Hermes Agent 的命令分为两类，使用场景完全不同，新手最容易混淆，先分清再实操：
1. 终端 CLI 命令（外层命令）
在电脑终端/Shell 中直接执行，用于环境配置、模型管理、服务启停、脚本自动化，无需进入 Hermes 聊天会话，是全局级操作。
通用入口格式：
hermes [全局选项] <主命令> [子命令/参数]2. 会话斜杠命令（内层命令）
进入 Hermes 聊天会话后，输入 / 触发，用于会话管理、临时切换模型、任务操控，仅对当前会话生效，轻量化、即时生效。
二、全局通用选项（所有命令通用）
全局选项可搭配任意主命令使用，快速适配不同使用场景，高频实用选项如下：
| 选项 | 作用说明 |
|---|---|
--version / -V |
查看 Hermes Agent 版本，快速校验安装是否成功 |
--profile / -p |
指定本次调用的配置文件，临时覆盖默认配置 |
--resume / -r |
通过会话ID/标题恢复历史会话 |
--continue / -c |
快速恢复最近一次会话，无需手动查找 |
--ignore-user-config |
忽略本地自定义配置，使用默认原生配置，用于问题排查 |
--yolo |
跳过危险操作审批弹窗，适合脚本自动化执行 |
三、核心终端 CLI 命令（高频必学）
这部分是日常使用最多的核心命令，覆盖启动、聊天、模型配置、环境检测、服务管理全场景。
1. 启动与聊天命令
基础启动
# 直接进入交互式聊天会话
hermes
# 单次问答（简洁模式，无多余输出）
hermes chat -q "帮我整理前端性能优化方案"
# 纯净脚本模式（仅输出最终答案，适配CI/脚本调用）
hermes -z "总结以下文本内容" < test.txt关键区别：hermes chat 保留工具执行日志，hermes -z 仅输出结果，适合程序化调用。
2. 模型与服务商管理
模型配置是 Hermes 的核心，区分终端全局配置和会话临时切换：
终端全局配置（首次配置必用）
# 交互式添加/切换模型服务商、配置API密钥、OAuth授权
hermes model适用场景：新增 OpenRouter、Anthropic、DeepSeek 等模型，更新密钥、配置自定义端点。
会话内临时切换（无需退出会话）
# 查看当前可用模型
/model
# 切换指定模型
/model claude-sonnet-4
# 全局保存模型配置（永久生效）
/model gpt-5 --global3. 环境检测与初始化
# 初始化配置，校验服务商、插件、内存、网关状态
hermes setup
# 环境体检，排查依赖、配置、权限问题
hermes doctor新手必做：安装完成后先执行hermes setup + hermes doctor，确保环境无异常。
4. 网关服务管理
用于搭建后台服务、对接第三方平台（微信、Discord 等），核心子命令：
# 前台启动网关服务
hermes gateway run
# 后台启动/停止/重启服务
hermes gateway start
hermes gateway stop
hermes gateway restart
# 查看服务运行状态
hermes gateway status5. 版本与维护命令
# 查看版本
hermes version
# 一键更新到最新版本
hermes update
# 卸载（--full 清空所有配置数据）
hermes uninstall --full四、会话内斜杠高频命令（高效提效）
进入 Hermes 聊天界面后，输入 / 即可使用，主打会话操控、任务微调、状态管理，轻量化且即时生效。
| 命令 | 功能说明 | 使用场景 |
|---|---|---|
/new [会话名] |
新建自定义会话 | 开启全新任务，清空上下文 |
/reset |
重置当前会话上下文 | 上下文混乱，无需新建会话直接重置 |
/resume [会话名] |
恢复指定历史会话 | 继续未完成的任务 |
/sessions |
列出所有历史会话 | 查找、管理历史任务 |
/clear |
清屏并刷新会话 | 界面杂乱，快速清理 |
/rollback [N] |
回退N步会话状态 | 指令出错，撤销上几步操作 |
/snapshot |
创建会话状态快照 | 关键任务节点，保存进度防丢失 |
/quit |
退出当前会话 | 结束交互，返回终端 |
五、高阶能力：看板任务管理命令
Hermes 支持可视化看板任务编排，适合复杂任务拆分、多任务管理，核心高频命令：
# 列出所有看板
hermes kanban boards list
# 创建新看板
hermes kanban boards create work-task --name "工作任务看板"
# 切换活跃看板
hermes kanban boards switch work-task
# 在当前看板创建任务
hermes kanban create "完成项目文档编写"
# 查看所有任务
hermes kanban list
# 标记任务完成
hermes kanban complete [任务ID]六、场景化命令组合（直接套用）
整理 4 个高频实操场景，新手可直接复制使用，快速落地高效工作流。
场景1：首次初始化环境
hermes setup # 初始化配置
hermes doctor # 检测环境
hermes model # 配置模型密钥
hermes # 启动交互会话场景2：脚本自动化批量处理
# 纯净模式读取文件并总结，无多余日志
hermes -z "精简总结以下内容" < article.md场景3：会话中途切换模型优化输出
/model claude-sonnet-4 --global # 切换高质量模型并全局保存
/reset # 重置上下文，重新生成答案场景4：后台常驻服务运行
hermes gateway install # 安装后台服务
hermes gateway start # 启动服务
hermes gateway status # 校验运行状态七、新手避坑核心要点
- 命令层级不混淆：
hermes model是终端全局配置（加服务商/密钥），/model是会话内临时切换，不可混用。 - 会话修改默认临时生效：会话内切换模型、调整配置，重启会话后失效，需加
--global永久保存。 - 自动化必用 -z 参数：脚本、CI 场景优先用
hermes -z，避免多余日志干扰结果解析。 - 环境异常优先排查：配置出错、模型调用失败，先执行
hermes doctor检测，再重置配置。
八、总结
Hermes Agent 的命令体系逻辑清晰，分为终端全局CLI命令、会话斜杠命令、看板任务命令三大模块：
- 新手掌握 启动、模型配置、会话管理 基础命令，即可满足日常 AI 交互需求；
- 进阶掌握 自动化脚本、网关服务、看板编排 命令，可实现复杂任务自动化落地；
熟练这套命令体系，能最大化发挥 Hermes Agent 的自动化、轻量化优势，大幅提升内容创作、代码开发、任务管理效率。
