Hermes Agent

图片教程（新手看这里）

安装（Mac/Linux）：curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Windows（PowerShell）：iex (irm https://hermes-agent.nousresearch.com/install.ps1)

买的什么模型的卡，就只能用什么模型

比如 kimi 时长卡只能用 kimi-k3.1-pro。向导会自动识别你卡里的模型。

1. 装好后输入 hermes --version，显示版本号就对了

2. 输入 hermes setup，按 ↓ 选 Full setup，回车

3. 拉到最下面，选 Custom endpoint (enter URL manually)

不要选上面那个「custom (direct API)」。

4. 填 https://api.jichuanai.com/v1

5. 粘贴 sk- 开头的密钥（显示成 * 号是正常的）

6. 出现 Verified 说明地址和密钥都对了，输入 2 选 Chat Completions

7. 自动识别出你卡里的模型，输入 Y，后面的问题一路回车

8.（可选）检查配置：provider 是 custom，地址带 /v1

9. 输入 hermes -z "你好"，有回复就成功了

---

文字版（会配置的看这里）

Hermes 安装好之后用 hermes setup 进配置向导。

协议：OpenAI 兼容。地址要带 /v1。

hermes setup

向导里怎么选

1. 安装方式选 Full setup — configure everything（快速设置里没有自定义端点）
2. 供应商列表拉到最下面，选 Custom endpoint（enter URL manually）
3. 填完地址和密钥后，API compatibility mode 输入 2（Chat Completions）

模式一定要选 2 Chat Completions

它的供应商列表里也有 Anthropic、OpenAI Codex 这些条目， 那些走的是各家自己的协议，不是我们这边该走的那条。 选错的典型症状是请求发得出去但返回结构对不上。

4. 然后依次填：

它问什么	填什么
API base URL	https://api.jichuanai.com/v1
API key	你的 sk-xxx
Model name	从 模型清单 逐字复制
Context length	不填，或填一个不超过该模型实际窗口的值

上下文长度填大了是有害的

填 200000 不会让模型真的能吃 200K。 它只会让 Hermes 不触发压缩，把超出部分照样送上去，超出的那截被静默丢掉 —— 表现为「前面说过的话它突然不记得了」。拿不准就留空。

配置文件在哪

向导写完之后，配置在 ~/.hermes/config.yaml。 后面要改地址或模型名，直接改这个文件比重跑向导快：

model:
  default: "kimi-k3.1-pro"          # 换成你卡里的模型名，比如 deepseek-v4-flash-0731
  provider: "custom"
  base_url: "https://api.jichuanai.com/v1"
  api_key: "sk-替换成你的key"

已实测（2026-10-27）

Hermes Agent 最新版按上面这段配置，hermes -z "你好" 正常回复。DeepSeek 系列同样这么填，只改 default 的模型名。

改完要重启 Hermes 的网关进程

跑着的进程拿的是启动时读到的那份配置，改文件不会自动生效。

不要带方括号

deepseek-v4-flash-0731[1M] 只有 Anthropic 协议能用，这里会原样发上去 → 404。

检查清单

• [ ] API mode 选的是 2 Chat Completions
• [ ] API base URL = https://api.jichuanai.com/v1
• [ ] 模型名逐字复制，不带方括号
• [ ] Context length 留空或填得保守
• [ ] 改过配置文件的话，重启了进程
• [ ] 真的发了一条消息拿到回复