终端优先
经典 CLI 和现代 TUI 共用同一套 runtime、session 和 slash commands,适合长期在 terminal 里工作的人。
它更像一个能持续积累经验的 Agent 框架,而不是一次性问答工具。
经典 CLI 和现代 TUI 共用同一套 runtime、session 和 slash commands,适合长期在 terminal 里工作的人。
支持预加载 skills、动态斜杠命令、历史经验检索和自我改进回路,适合沉淀流程型能力。
同一个 Hermes 既能作为本地 Agent,也能接消息平台、接 IDE、接 OpenAI 兼容前端。
把 Hermes 拆成这 4 层来理解,后面看命令会更顺。
本地终端交互、单次任务、恢复会话、切换模型,是最基础的入口。
把经验沉淀为技能,按场景加载工具集,并通过记忆与历史会话形成上下文延续。
把 Hermes 接到 Telegram、Discord、Slack 等平台,让它变成长期运行的 bot 或服务。
把 Hermes 接进 IDE 或 OpenAI 兼容前端,变成可编排、可接入的后端能力。
官方的思路很明确:先把“正常聊天”跑通,再叠加 gateway、cron、voice 和 routing。
# 1) 用 Nous Portal 走最快的首次配置路径
hermes setup --portal
# 2) 如果需要,重新交互式选择 provider 和模型
hermes model
# 3) 启动默认交互式会话
hermes
# 4) 或者直接进入更现代的终端界面
hermes --tui
hermes setup --portal 是官方最推荐的一条命令。hermes model 检查 provider、模型和认证。这里按“初始化、聊天、会话、扩展能力”来组织,适合平时快速翻看。
setup / model / tools首次配置# 启动完整初始化向导
hermes setup
# 使用 Nous Portal 完成最快可用配置
hermes setup --portal
# 调整 agent 相关设置
hermes setup agent
# 交互式选择 provider 和模型
hermes model
# 配置不同平台可用的工具集
hermes tools
hermes / chat / --tui日常交互# 直接启动交互式会话
hermes
# 显式进入 chat 子命令
hermes chat
# 单次提问,不进入长期交互
hermes chat -q "Hello"
# 从文件读取 prompt
hermes chat --query-file prompt.txt
# 强制指定模型
hermes chat --model "anthropic/claude-sonnet-4"
# 强制指定 provider
hermes chat --provider nous
# 启动现代 TUI 界面
hermes --tui
skills / toolsets技能与工具# 启动时预加载一个或多个技能
hermes -s hermes-agent-dev,github-auth
# 在 chat 中只启用指定工具集
hermes chat --toolsets "web,terminal,skills"
# 预加载技能后执行一次任务
hermes chat -s github-pr-workflow -q "open a draft PR"
resume / continue会话恢复# 恢复最近一次会话
hermes --continue
# 按 session ID 恢复指定会话
hermes --resume <session_id>
# 恢复最近会话
hermes --resume latest
# 在指定目录中恢复最近会话
hermes --resume latest --in ./dir
# 在 TUI 中恢复最近会话
hermes --tui --continue
-w / doctor / update维护与隔离# 在独立 worktree 中进入交互式模式
hermes -w
# 在独立 worktree 中执行一次性任务
hermes -w -z "Fix issue #123"
# 排查安装、配置和网络问题
hermes doctor
# 更新 Hermes 到最新版本
hermes update
acp / api server外部接入# 启动 ACP 适配层,供 IDE 或客户端接入
hermes acp
# 在环境变量中启用 API Server
API_SERVER_ENABLED=true
API_SERVER_KEY=change-me-local-dev
# 启动 gateway,同时带起 API Server
hermes gateway
Hermes 的 Gateway 不只是转发消息,它还统一管理平台连接、会话、定时作业和平台级 slash commands。
# 在前台运行 Hermes Gateway
hermes gateway
# 交互式配置消息平台
hermes gateway setup
# 安装为用户服务
hermes gateway install
# Linux 下安装为系统级服务
sudo hermes gateway install --system
# 启动默认服务
hermes gateway start
# 停止默认服务
hermes gateway stop
# 查看默认服务状态
hermes gateway status
Hermes 的交互态里,斜杠命令非常重要。很多会话管理和模型切换动作并不是去 shell 里做,而是在会话内部直接完成。
会话与帮助基础交互# 查看帮助信息
/help
# 查看当前身份或权限
/whoami
# 开启一个全新 session,并可选命名
/new my-experiment
# /new 的别名
/reset
# 恢复已有命名会话
/resume my-experiment
# 退出 CLI
/quit
# /quit 的别名
/exit
模型 / 目标 / 技能会话内控制# 在会话内查看或切换当前模型
/model claude-sonnet-4
# 切换到 provider:model 形式的模型
/model provider:model
# 使用已定义别名切换模型
/model fav
# 设置一个持续目标,让 Hermes 跨轮次推进
/goal write a release plan
# 查看持续目标状态
/goal status
# 暂停或恢复持续目标
/goal pause
/goal resume
# 显式调用技能,或查看技能列表
/skill github-pr-workflow
/skills list
如果从实际动作来选入口,下面这三种场景最常见。
适合第一次安装,目标是先完成 provider 配置并拿到一次正常回复。
# 用最快路径完成初始化
hermes setup --portal
# 检查模型与 provider 配置
hermes model
# 启动默认交互式会话
hermes
适合想用更现代交互界面,又希望保留同一套会话和配置的场景。
# 启动现代 TUI
hermes --tui
# 恢复最近会话
hermes --tui --continue
# 在指定项目目录中恢复会话
hermes --tui --resume latest --in ./my-project
适合接消息平台,或者作为 OpenAI 兼容后端供其他前端调用。
# 先配置消息平台
hermes gateway setup
# 启动消息网关
hermes gateway
# 启动 ACP 支持,供 IDE 接入
hermes acp
把文档真正落地到机器或服务器上时,下面这几件事最值得先记住。
hermes setup --portal、hermes model、hermes 这三步跑通。只有基础聊天已经稳定,后面的 Gateway、Voice、Cron、API Server 才更容易排障。
hermes model 复查 provider、模型和认证,而不是先去怀疑网关或技能层。
以下是整理 Hermes Markdown 和 HTML 页面时使用的主要官方资料。