Hermes Agent CLI 参考

Hermes Agent CLI 命令手册:从聊天、模型到 Gateway

按日常任务整理 Hermes Agent v2026.9.24 的核心终端命令,覆盖 CLI/TUI、模型、工具、会话、Skills、Gateway、诊断与更新。

v2026.9.24更新:2026-10-05

启动聊天与 TUI

`hermes` 启动经典交互界面;`hermes --tui` 启动支持模态窗口、鼠标选择和非阻塞输入的现代 TUI。两种界面共用会话、配置、Skills 与记忆。

hermes
hermes --tui
hermes chat -q "总结当前目录"
hermes --continue
hermes --resume <session_id>

模型与工具配置

`hermes model` 是终端外的完整 Provider 配置向导,可添加 Provider、OAuth 登录、录入 API Key 和选择默认模型。会话内的 `/model` 只能切换已经配置好的模型。

hermes setup --portal
hermes model
hermes tools
hermes portal info

新增 Provider 时必须先退出当前会话,再运行 hermes model;不要把会话内 /model 当成配置向导。

会话管理

会话命令适合查找、恢复和整理长期积累的对话。

hermes sessions list
hermes sessions rename <id> "项目名称"
hermes sessions export <id>
hermes sessions prune

Skills 管理

Hermes 使用开放的 Skills 格式。安装时会先进行安全扫描;Skill 可来自 Skills Hub、公开目录或直接 SKILL.md URL。

hermes skills browse
hermes skills search kubernetes
hermes skills install openai/skills/k8s
hermes skills list
hermes skills reset <name> --restore

Gateway 与消息平台

Gateway 统一承载 Telegram、Discord、Slack、钉钉、飞书、企业微信、Teams 等 20+ 平台。先完成交互式配置,再启动服务。

hermes gateway setup
hermes gateway start
hermes gateway status
hermes gateway restart
hermes gateway list

WSL 环境中 systemd 不稳定时,可使用 hermes gateway run,并用 tmux 或进程管理器保持运行。

诊断与维护

出现配置、依赖或 Provider 问题时先运行 doctor;升级前可先预检。

hermes doctor
hermes doctor --fix
hermes status
hermes version
hermes update --check
hermes update --backup