Hermes Agent 是 Nous Research 做的自改进 AI 代理。它的特点是会自己造技能：跨会话记忆 + 自动技能创建 + 默认自带 70 多个技能，用久了会积累出针对你工作流的专用能力。

版本基线 v0.40.12，官方 docs.ollama.com/integrations/hermes。

一、一条命令启动

ollama launch hermes

Ollama 自动完成四步：

1. 安装：未安装则提示安装 Hermes 命令行代理
2. 选模型：本地或云端二选一
3. 初始化：配置 Ollama provider，把 Hermes 指向 http://127.0.0.1:11434/v1，并设为默认模型
4. gateway：可选接入消息平台，然后启动 Hermes 对话

二、接消息平台

hermes gateway setup

支持 Telegram、Discord、Slack、WhatsApp、Signal、Email。配好之后就能从任意设备调用自己的模型。

三、之后换模型

hermes model

这是 Hermes 自己的模型选择器，可以改 provider 或模型，不需要重跑 ollama launch。

四、手动安装与配置

不想用 ollama launch、想走 Hermes 自己的向导：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

安装后会自动进入设置向导，选 Quick setup（provider + 模型 + 消息平台，推荐）：

How would you like to set up Hermes?

 →  Quick setup — provider, model & messaging (recommended)
    Full setup — configure everything

接到 Ollama

1. 选 More providers…
2. 选 Custom endpoint (enter URL manually)
3. API base URL 填 Ollama 的 OpenAI 兼容端点：

API base URL [e.g. https://api.example.com/v1]: http://127.0.0.1:11434/v1

1. API Key 留空（本地 Ollama 不需要）：

API key [optional]:

1. Hermes 会自动探测已下载的模型，确认选用：

Verified endpoint via http://127.0.0.1:11434/v1/models (1 model(s) visible)
  Detected model: kimi-k2.5:cloud
  Use this model? [Y/n]:

1. 上下文长度留空让它自动探测：

Context length in tokens [leave blank for auto-detect]:

最后确认启动：

Launch hermes chat now? [Y/n]: Y

五、关键配置项小结

项	值
Base URL	http://127.0.0.1:11434/v1（注意带 /v1）
API Key	留空
上下文	留空自动探测
换模型	hermes model
接消息平台	hermes gateway setup

/v1 不能漏。填成 http://127.0.0.1:11434 会连不上，因为 Hermes 走的是 OpenAI 兼容协议。

六、和 Hermes Desktop 的关系

Hermes Agent 是命令行形态，12.4 Ollama Hermes Desktop 是同一个代理的桌面应用形态。两者共享同一套配置、会话、技能和记忆——用哪个入口都行，在一边积累的技能在另一边可见。

常见问题

现象	原因	处理
连接失败	Base URL 漏了 /v1	补成 http://127.0.0.1:11434/v1
提示 API Key 必填	填了错误格式	本地部署直接留空
探测不到模型	Ollama 未启动，或本地无模型	先 ollama serve + ollama pull
上下文被截断	自动探测值偏小	手动填更大的数值

动手试

## 确认 Ollama 的 OpenAI 兼容端点可用
curl http://127.0.0.1:11434/v1/models

## 启动 Hermes
ollama launch hermes

第一条能返回模型 JSON 列表，说明 base URL 配置正确，Hermes 一定能连上。