Hermes Agent 在 Linux 上的安装与首次配置

Hermes Agent 是 Nous Research 开源的 AI Agent，**同一套 agent 核心**同时跑在 CLI、TUI、Electron Desktop、以及 20 多个消息平台（Telegram、Discord、Slack、飞书等）。它通过 memory 和 skills 跨 session 学习，能跑定时任务、把任务派给子 agent、能驱动真正的终端和浏览器。本文按 Ubuntu 22.04 / 24.04 的步骤走一遍安装 + `hermes doctor` 通过之后头三件该做的事。

## 你实际得到的是什么

Hermes 是「单 Python CLI + 一套共享的 `agent/` 核心，Electron Desktop 也调它」。运行时冷启动很快，把一个项目目录传进去，它改完文件后等你审批再写回。CLI 是 agent 上面薄薄一层包装——每个有趣的子系统（memory、skills、plugins、gateway、schedulers）都是独立子命令，`hermes –help` 就是你最常翻的文档页。

项目有两条设计铁律。**Per-conversation prompt caching 是神圣的**——agent 每个回合都复用缓存前缀，凡是中途改动过往 context 的行为都会翻倍你的 API 花费，所以一律不做。**核心是一条窄腰**——大部分能力放在边沿（plugins / skills / services），不进核心 prompt。

## Ubuntu 22.04 / 24.04 安装

官方装法是一行 curl-pipe，会自动装上你需要的全部依赖：`uv`、Python 3.11、Node.js 22、`ripgrep`、`ffmpeg`（语音用）。脚本会自动识别发行版并挑对应的二进制镜像。

“`bash
sudo apt update && sudo apt install -y curl xz-utils git
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
“`

**没动你的东西**：系统 Python 没换、已装的 Node 没替换、`~/.bashrc` 只多了一行 `PATH` 指向 `~/.local/bin`。刷新 shell 或开新终端即可：

“`bash
hermes –version

hermes doctor
“`

`hermes doctor` 会检查 Python、API key、网关、磁盘空间。哪里缺一行告诉你修哪里。

## 首次配置

Hermes 有个 setup 向导，一路选 provider、channel、默认 workspace：

“`bash
hermes setup
“`

可以选模型 provider（Anthropic、OpenAI、Google Gemini、xAI、本地 Ollama），每个 provider 贴一个 API key。Hermes **没有任何遥测、没有强制账户**，完全听你 config 调。如果想纯本地：

“`bash
ollama serve &
ollama pull qwen3:30b-a3b
hermes config set default_provider ollama
hermes config set default_model qwen3:30b-a3b
“`

消息 gateway（Telegram / Discord / Slack / 飞书 / WhatsApp）每个平台都有自己的 `hermes ` 子命令，会一步步告诉你 bot token 在哪儿贴。Telegram 最简单，五分钟搞定。

## 头一天值得做的三件事

**Skills。** 一个 skill 是放在 `~/.hermes/skills//` 下的 Markdown 文件 + 可选脚本。Agent 按 description 自动加载。把任何你会反复要的事（`weekly standup notes`、`pr-review`、`翻译流水线`）变成一个 skill。`hermes skills` 看已装的。

**Memory。** Hermes 写到一个按主题切片的紧凑 memory store。跑几个 session 后问 `what do you remember about ` 会发现它记住的东西远超你预期。`hermes memory` 列主题，`hermes memory add ““` 写一条。

**子 agent。** 长跑、占 context 的活儿，用 `hermes delegate` 开一个 leaf 子 agent 在自己的 context 里跑。父 agent 保持廉价，子 agent 干重活。研究类任务特别合适——否则容易烧父 agent 的 prompt cache。

## 可选：Desktop

`hermes desktop`（或 `hermes gui`）启动 Electron app——聊天、文件预览、provider 设置、定时任务。Desktop 调的是同一套 `agent/` 核心，所以会话是共用的。想开聊天窗时有用，但如果你本身就在终端里，用 CLI 就够了。

## 下一步看什么

– `hermes config` 列每一个 config 旋钮（多数不用动）
– `~/.hermes/skills/` 你自己的 skill 都住这里——安装包里带样例
– `hermes insights` 出你 agent 每天/每周干过什么、学到什么
– https://hermes-agent.nousresearch.com/docs 完整参考

Hermes 是写这个系列用的 agent——上面所有东西在干净 Ubuntu VM 上十分钟内全部跑通。