🧠 个人知识库

HermesAgent命令速查

Properties1
tagsvps, hermes

15 min read

Hermes Agent 命令行与指令全集速查 SOP

本卡片整理自 Hermes Agent 官方最新权威文档与源码（Docs 与 GitHub），全量汇总了包含 高频常用命令、终端 CLI 全量命令行 与 会话内斜杠指令 (Slash Commands) 的全集规范。

🔥 常用高频命令 (Quick Reference)

1. 版本查询与健康诊断 (Version & Doctor)

# 1. 简易版本号查询
hermes --version
# 或调用 CLI 内部版本输出 (含代码 Commit、Python 版本、安装路径与升级状态)
hermes version
 
# 2. 全局环境与链路健康度总览 (包含模型、API 密钥、Gateway 状态、定时任务与会话)
hermes status
 
# 3. 系统级深度诊断自检 (自动校验依赖包、数据库、权限与 API 连通性)
hermes doctor
 
# 4. 执行健康自检并自动修复发现的配置/权限缺陷
hermes doctor --fix
 
# 5. 查看底层 Git 源码分支与最近一次 Commit ID
git -C /usr/local/lib/hermes-agent log -1 --oneline

2. 升级与安装管理 (Update & Maintenance)

# 1. 检查官方远程仓库是否有新版本及更新日志
hermes update --check
 
# 2. 执行一键平滑升级（自动拉取 Git 最新代码、重构 Python venv 虚拟环境与依赖包）
hermes update

3. 配置模型与终端执行后端 (Model & Terminal Backend)

# 1. 交互式菜单更换模型
hermes model
 
# 2. 命令行一键设置默认模型与 Provider
hermes config set model.default gemini-3.6-flash-high --provider custom
 
# 3. 恢复本地 Terminal 执行后端 (用于从 SSH 模式切回本地)
hermes config set terminal.backend local && hermes config reload
 
# 4. 查看当前使用的模型与终端后端配置
hermes config get model.default
hermes config get terminal.backend

4. 网关守护进程管理 (Gateway Control)

# 1. 查看 Gateway 运行状态与端口
hermes gateway status
 
# 2. 重启 Gateway 网关进程 (重载飞书/平台适配器)
hermes gateway restart
 
# 3. 停止与启动 Gateway
hermes gateway stop
hermes gateway start

5. 定时任务管理 (Cron Jobs)

# 1. 列出系统当前所有定时任务
hermes cron list
 
# 2. 跑一次特定定时任务 (以 ID 测试)
hermes cron run <job_id>

6. Docker 容器更新一键短别名 (VPS 运维)

up-cli    # 一键平滑更新 CLIProxyAPI 网关容器
up-ignis  # 一键平滑更新 Ignis 知识库看板
up-cf     # 一键平滑更新 Cloudflare Tunnel 隧道
up-all    # 一键更新服务器上的所有 Docker 容器并自动清理垃圾镜像

一、 终端 CLI 全量命令行 (Terminal CLI Commands)

入口命令：hermes [flags] [subcommand]（若不加 subcommand 默认启动交互式 Chat）。

1. 全局标志与参数 (Global Flags)

标记 (Flag)说明
--version, -V查看版本信息
-z, --oneshot PROMPT单次非交互模式：发送 Prompt 并仅输出最终文本（适合脚本/管道，自动跳过审批）
--usage-file PATH单次模式专用：运行后向指定路径输出 JSON 消耗报告（Token、费用、模型、API 调用数）
-m MODEL, --provider PROVIDER本次调用的临时模型与 Provider 覆盖
--reasoning LEVEL本次调用的思考强度覆盖（none ~ max / ultra）
-t TOOLSETS本次调用的工具集限制（逗号分隔）
-r SESSION, --resume SESSION根据 ID 或名称恢复历史会话
-c [NAME], --continue恢复最近一次或指定名称的会话
-w, --worktree隔离 Git Worktree 模式：为 Agent 分配独立的 Git 隔离分支，防止多 Agent 代码冲突
-s SKILLS, --skills本次会话预加载指定技能（可重复或逗号分隔）
--profile, -p NAME指定运行的 Hermes 隔离 Profile
--yoloYOLO 模式：跳过所有危险命令的人工审批提示（谨慎使用）
--tui / --cli强制使用 Ink 现代 TUI 界面 或 经典 REPL 交互
--accept-hooks无 TTY 模式下自动接受未见过的 Shell 钩子
--ignore-rules跳过 AGENTS.md / SOUL.md / Memory / 预加载技能的自动注入
--safe-mode故障排查模式：禁用所有自定义配置、插件、MCP 服务器及规则
--pass-session-id在 System Prompt 中附带当前会话 ID

2. 子命令全集分类 (Subcommands Catalog)

核心与环境 (Core & Environment)

hermes chat -q "Query" [-m Model] # 单次非交互式查询 (可附带 --image 图片)
hermes setup [section]            # 交互式配置向导 (model|tts|terminal|gateway|tools|agent)
hermes model                      # 交互式切换模型与 Provider 挑选器
hermes fallback [add|remove|list] # 配置多模型熔断降级链 (Primary 失败后自动切换)
hermes config [set|get|edit|show|path|env-path|unset|migrate] # 配置读写与编辑
hermes doctor [--fix]             # 深度系统健康诊断与一键自动修复
hermes status [--all]             # 查看系统组件、网络、网关及模型状态
hermes version                    # 显示详细版本、Commit 哈希及 Python 环境
hermes update [--check]           # 一键自动检查与平滑升级到官方最新 HEAD
hermes uninstall                  # 卸载 Hermes Agent

网关与平台消息 (Gateway & Messaging)

hermes gateway [run|install|start|stop|restart|status|setup] # 网关守护进程管理
hermes send                     # 一次性通过网关向特定平台/用户发送消息
hermes photon setup             # 配置 iMessage/Photon 底层网关
hermes whatsapp / slack / email # 平台特定辅助与配置向导
hermes webhook [list|subscribe|remove|test] # 动态 Webhook 事件订阅管理

工具、技能与 MCP (Tools, Skills & MCP)

hermes tools [list|enable|disable]  # 平台工具集启用/禁用控制
hermes skills [list|browse|search|install|config|check|update|uninstall|publish|tap] # 技能全生命周期管理
hermes bundles                      # 技能组合包管理（一键加载多个技能别名）
hermes mcp [add|remove|list|test|catalog|install|configure|serve] # MCP 服务管理或将 Hermes 作为 MCP 服务运行
hermes computer-use                 # 桌面自动化 Computer Use (CUA) 后端管理

会话、存储与定时任务 (Sessions, Memory & Cron)

hermes sessions [list|browse|rename|delete|export|prune|stats] # 历史会话管理
hermes memory [setup|status|off|reset]                        # 外部记忆 Provider 配置
hermes cron [list|create|edit|pause|resume|run|remove|status]  # Cron 定时任务管理
hermes checkpoints                  # 管理/清理文件系统版本快照
hermes secrets [bitwarden|onepassword]                         # 外部凭证库集成
hermes auth [add|list|remove|reset|status]                     # 轮询 API Key 凭证池管理

界面、应用与进阶功能 (Surfaces, Multi-Agent & Misc)

hermes desktop (或 hermes gui)      # 启动原生 Electron 桌面端应用程序
hermes dashboard                    # 启动 Web 管理面板 (嵌入 TUI 与可视化控件)
hermes proxy                        # 启动本地 OpenAI 兼容代理网关 (复用 OAuth 凭证)
hermes portal                       # 登录/管理 Nous Portal 平台订阅
hermes profile [list|create|use|show|delete|rename|alias|export|import] # 隔离 Profile 多实例管理
hermes kanban                       # 多 Agent 协同看板管理
hermes project                      # 命名多目录项目工作区管理
hermes moa                          # 混合 Agent (Mixture-of-Agents) 预设配置
hermes skin [list|use|set]          # 实时主题与皮肤切换
hermes pets                         # Petdex 桌面/TUI 动态宠物控制
hermes journey (learning, memory-graph) # 技能与记忆时间轴图谱
hermes console                      # 打开安全交互控制台
hermes logs [-f] [errors]           # 日志查看与实时追溯
hermes acp                          # 以 ACP (Agent Client Protocol) 模式运行 (支持 IDE)
hermes completion [bash|zsh|fish]   # 输出 Shell 命令行补全脚本

二、 会话内斜杠指令全集 (In-Session Slash Commands)

在交互式 Chat (CLI/TUI/网关消息平台) 中输入的斜杠指令。会话内输入 /help 始终获取最权威列表。

1. 会话控制 (Session Management)

  • /new (或 /reset) [name]：清空当前上下文，开启全新会话。
  • /clear：清屏并开启新会话 (CLI)。
  • /retry：重新发送上一条消息。
  • /undo [N]：回退 N 个轮次并重新提问。
  • /title [name]：为当前会话设置标题。
  • /prompt (或 /compose)：在外部文本编辑器 $EDITOR 中撰写复杂 Prompt (CLI)。
  • /compress (或 /compact) ['here N'] [--preview]：压缩会话上下文（支持保留最近 N 轮）。
  • /stop：强行终止所有后台正在运行的子任务/进程。
  • /rollback [N]：查看或恢复文件系统版本快照。
  • /diff [mode] [--stat]：查看当前工作区的 Git 修改差异（staged | all | session 模式）。
  • /snapshot [sub]：创建或恢复 Hermes 配置与状态快照。
  • /background (或 /bg) <prompt>：将指定 Prompt 放入后台异步运行。
  • /queue (或 /q) <prompt>：排队 Prompt，在当前 Turn 结束后自动触发。
  • /steer <prompt>：在下一个工具调用结果返回后注入控制消息 (Mid-turn Steering)。
  • /agents (或 /tasks)：显示当前活跃的 Agent 与正在运行的后台任务。
  • /goal [text|sub]：设置跨轮次的长期目标 (status | pause | resume | clear)。
  • /subgoal [text]：为当前目标添加或管理子步骤标准。
  • /branch (或 /fork) [name]：从当前位置衍生（Fork）一条新会话分支。
  • /resume [name]：恢复指定名称的历史会话。
  • /sessions：浏览并恢复历史会话列表。
  • /handoff <platform>：将当前终端会话平滑移交给指定消息平台 (CLI)。
  • /status：查看当前会话状态、模型、Token 使用量及上下文窗口占用。

2. 系统与个性化配置 (Configuration & Personality)

  • /config：查看当前解析后的系统配置 (CLI)。
  • /model [name] [--global]：切换模型（默认仅作用于当前会话，加 --global 作用于全局）。
  • /personality [name]：切换 Agent 人设与性格提示词。
  • /reasoning [level|show|hide]：设置或查看推理思考强度（none ~ xhigh / max / ultra）。
  • /fast [normal|fast]：切换处理优先级/快速模式。
  • /verbose：循环切换工具执行进度详情级别（off → new → all → verbose → log）。
  • /voice [on|off|tts]：控制语音交互与 TTS 输出。
  • /yolo：快速开关危险命令的人工审批拦截。
  • /skin [name]：实时更改外观主题与皮肤。
  • /indicator [style]：更改 TUI 忙碌指示器样式（kaomoji | emoji | unicode | ascii）。
  • /statusbar (或 /sb)：开关底栏状态条。
  • /battery [on|off]：在状态栏开关电池电量显示。
  • /timestamps (或 /ts) [on|off]：开关消息时间戳。
  • /busy [queue|steer|interrupt]：设置在 Agent 忙碌时按回车键的默认行为。

3. 工具、技能与生态 (Tools, Skills & Ecosystem)

  • /tools [list|enable|disable]：管理启用或禁用的工具 (CLI)。
  • /toolsets：查看启用的工具集 (CLI)。
  • /skills：搜索、安装及管理技能 (CLI)。
  • /bundles：查看技能组合包列表（如用一个 /<name> 载入多个技能）。
  • /learn <source>：从当前对话、本地目录或 URL 中提取并学习为可复用 Skill。
  • /memory [pending|approve|reject]：审查待写入的长期记忆。
  • /pet [toggle|list|<slug>]：控制 Petdex 动态桌宠。
  • /hatch [description]：根据自然语言描述现场孵化生成新的宠物。
  • /cron [sub]：在会话内管理定时任务。
  • /curator [sub]：管理后台技能维护器 Curator (status | run | pin | archive)。
  • /kanban [sub]：协同工作看板管理。
  • /moa <prompt>：通过 Mixture-of-Agents 预设处理单个 Prompt。
  • /reload：重新加载环境变量 .env (CLI)。
  • /reload-mcp：重载所有 MCP 服务器。
  • /reload-skills：重新扫描技能目录。
  • /browser [connect|status]：连接到本地宿主机真实浏览器的 CDP 调试端口 (CLI)。
  • /plugins：查看已安装的桌面/TUI 插件。

4. 网关专属控制 (Gateway Platform Exclusive Commands)

  • /approve [session|always]：审批通过挂起的危险命令（飞书/Telegram 等网关端专用）。
  • /deny [all] [reason]：拒绝挂起的危险命令。
  • /restart：排空当前任务后重启 Gateway 网关。
  • /sethome：将当前对话频道设置为 Agent 的默认 Home Channel。
  • /topic [off|help]：切换 Telegram 话题模式会话。
  • /platform <pause|resume|list>：暂停或恢复指定异常消息平台。
  • /commands [page]：分页浏览网关端支持的所有斜杠指令。

5. 信息与退出 (Info & Exit)

  • /help：显示当前界面支持的指令速查表。
  • /usage [reset]：查看当前会话 Token 消耗与速率限制 (Rate Limits)。
  • /insights [days]：分析近期使用量与统计数据。
  • /whoami：查看当前用户的权限级别 (Admin / User)。
  • /profile：显示当前激活的 Profile 隔离实例信息。
  • /platforms (或 /gateway)：查看所有消息平台的连接状态。
  • /journey (或 /learning)：以时间轴展现已学会的 Skill 和固化的 Memory。
  • /subscription (或 /upgrade)：查看 Nous Portal 订阅计划。
  • /topup：查看 Nous 账户余额与充值信息。
  • /copy [N]：复制上一条回答到剪贴板 (CLI)。
  • /paste：直接粘贴剪贴板中的图片附件 (CLI)。
  • /image <path>：附加本地图片文件 (CLI)。
  • /debug [nous|local]：生成并上传调试报告，获取分享链接。
  • /quit (或 /exit) [--delete]：退出系统；加 --delete 同时物理删除该会话历史。

三、 知识库同步说明

全量命令与斜杠指令汇总已更新至个人知识库：

  • Wiki 卡片：[[HermesAgent命令速查]]
  • GitHub 知识库：yyanxiao/wiki（Commit SHA: fa21a08）

Graph View

Backlinks