Nous Research / Terminal-First AI Agent

一个以终端为核心,同时支持技能、记忆、网关与 API 接入的 AI Agent

Hermes Agent 不是只会对话的命令行工具。它把 CLI、TUI、skills、memory、Gateway、 ACP 和 OpenAI 兼容 API 放在一套体系里,适合从本地交互一路扩展到消息平台和前端接入。

Hermes 的核心价值

它更像一个能持续积累经验的 Agent 框架,而不是一次性问答工具。

终端优先

经典 CLI 和现代 TUI 共用同一套 runtime、session 和 slash commands,适合长期在 terminal 里工作的人。

CLI TUI Session

技能与记忆

支持预加载 skills、动态斜杠命令、历史经验检索和自我改进回路,适合沉淀流程型能力。

Skills Memory Refine

可扩展为服务

同一个 Hermes 既能作为本地 Agent,也能接消息平台、接 IDE、接 OpenAI 兼容前端。

Gateway ACP API Server

4 层使用形态

把 Hermes 拆成这 4 层来理解,后面看命令会更顺。

01

CLI / TUI

本地终端交互、单次任务、恢复会话、切换模型,是最基础的入口。

02

Skills / Memory

把经验沉淀为技能,按场景加载工具集,并通过记忆与历史会话形成上下文延续。

03

Gateway

把 Hermes 接到 Telegram、Discord、Slack 等平台,让它变成长期运行的 bot 或服务。

04

API / ACP

把 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、模型和认证。
  • CLI 和 TUI 共用会话与配置,所以可以放心切换使用。
  • 只有在普通对话已经稳定后,再去配置 Gateway、Voice、Cron 和 API Server 会更稳妥。

常用命令速查

这里按“初始化、聊天、会话、扩展能力”来组织,适合平时快速翻看。

setup / model / tools首次配置

先把 provider、模型和工具集配置对,是后面所有能力能否正常工作的前提。
# 启动完整初始化向导
hermes setup

# 使用 Nous Portal 完成最快可用配置
hermes setup --portal

# 调整 agent 相关设置
hermes setup agent

# 交互式选择 provider 和模型
hermes model

# 配置不同平台可用的工具集
hermes tools

hermes / chat / --tui日常交互

既可以长期交互,也可以做一次性提问、指定模型或 provider,还能切到现代 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 的一个强项就是按场景预加载能力,把“会做”变成“能复用”。
# 启动时预加载一个或多个技能
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 把 session 当成一等公民,所以恢复历史会话是高频操作之一。
# 恢复最近一次会话
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外部接入

适合让 Hermes 进入 IDE 或变成 OpenAI 兼容后端。
# 启动 ACP 适配层,供 IDE 或客户端接入
hermes acp

# 在环境变量中启用 API Server
API_SERVER_ENABLED=true
API_SERVER_KEY=change-me-local-dev

# 启动 gateway,同时带起 API Server
hermes gateway

Gateway 与消息平台

Hermes 的 Gateway 不只是转发消息,它还统一管理平台连接、会话、定时作业和平台级 slash commands。

Gateway 常用命令

# 在前台运行 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

可接入的平台

Telegram Discord Slack WhatsApp Signal Feishu/Lark Matrix Teams LINE Email
建议顺序: 先把本地 CLI 或 TUI 对话跑通,再接消息平台。这样一旦平台层出问题,更容易判断是网关问题还是模型/provider 问题。

常见 Slash Commands

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

常见使用场景

如果从实际动作来选入口,下面这三种场景最常见。

Scene 01

先把本地 Hermes 跑通

适合第一次安装,目标是先完成 provider 配置并拿到一次正常回复。

# 用最快路径完成初始化
hermes setup --portal

# 检查模型与 provider 配置
hermes model

# 启动默认交互式会话
hermes
Scene 02

想长期在终端里工作

适合想用更现代交互界面,又希望保留同一套会话和配置的场景。

# 启动现代 TUI
hermes --tui

# 恢复最近会话
hermes --tui --continue

# 在指定项目目录中恢复会话
hermes --tui --resume latest --in ./my-project
Scene 03

想把 Hermes 变成服务

适合接消息平台,或者作为 OpenAI 兼容后端供其他前端调用。

# 先配置消息平台
hermes gateway setup

# 启动消息网关
hermes gateway

# 启动 ACP 支持,供 IDE 接入
hermes acp

本地落地注意点

把文档真正落地到机器或服务器上时,下面这几件事最值得先记住。

优先级建议: 先把 hermes setup --portal、hermes model、hermes 这三步跑通。只有基础聊天已经稳定,后面的 Gateway、Voice、Cron、API Server 才更容易排障。
易错点: 如果 Hermes 打开后回复为空、异常或不稳定,官方建议第一时间回到 hermes model 复查 provider、模型和认证,而不是先去怀疑网关或技能层。
本页基于当前目录下的 Hermes Markdown 文档重组而成,适合作为本地浏览版介绍页,也适合继续扩成更完整的命令总览。