Hermes Agent

Nous Research 开源的自主 Agent：CLI / TUI / Telegram 等多端运行，带持久记忆与技能系统，原生支持 自定义 OpenAI 兼容端点，接入本站只需一个向导。

没碰过命令行？先看命令行入门（3 分钟）。本页只需要：打开终端 → 复制安装命令 → 粘贴回车。

装好了的标志：执行 hermes --version 有版本号输出。若提示 command not found，关掉终端重新开一个再试。

前置要求。Linux / macOS / WSL2，或 Windows 原生（见下方 PowerShell 命令）；本站创建一把 API 密钥（形如 sk-xxx）。

Hermes Agent 是 Nous Research 开源的自主 Agent（不是 Anthropic / OpenAI 的官方工具）。安装器会自动帮你装好 Python、Node.js、ripgrep 等依赖，所以第一次会花几分钟。

第一步：安装

macOS / Linux / WSL2：

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

Windows PowerShell：

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

确认装上了（记得先关掉终端重新开一个）：

hermes --version

第二步：配置向导（推荐）

hermes model

按提示依次：

Provider 列表往下选 Custom endpoint（自带/自建服务那一项）
API base URL：https://api.juheai.shop/v1
API key：你的 sk-xxxxxxxx
Model name：deepseek-v4-flash（或其他站内模型）
上下文长度：直接回车留空，让它自动探测

看到 Verified endpoint … (N model(s) visible) 即接入成功。向导自动把密钥写入 ~/.hermes/.env、端点与模型写入 ~/.hermes/config.yaml。

命令行配置（等价方式）

hermes config set OPENAI_API_KEY sk-xxxxxxxx
hermes config set model.provider custom
hermes config set model.base_url https://api.juheai.shop/v1
hermes config set model.api_mode chat_completions
hermes config set model.default deepseek-v4-flash

或直接编辑 ~/.hermes/config.yaml：

model:
  provider: custom
  default: deepseek-v4-flash
  base_url: https://api.juheai.shop/v1
  api_mode: chat_completions

base_url 必须带 /v1；provider 必须是 custom（不要用 openai-api，否则会连到 OpenAI 官方）。OPENAI_BASE_URL 环境变量只对 openai-api provider 生效——推荐用 hermes config set 的方式。

第三步：启动与验证

命令	说明
`hermes --tui`	现代终端界面（推荐）
`hermes chat`	经典聊天模式；`--oneshot -q "任务"` 执行单任务即退出
`hermes -c`	恢复最近会话
`hermes doctor`	体检配置，排障首选

启动后输入 who are you，正常回复即接入成功。

常见问题

401 / 403

401：~/.hermes/.env 里 OPENAI_API_KEY 未设置或错误 → 重新 hermes config set OPENAI_API_KEY …。
403：密钥被禁用/删除 → 回「API 密钥」页确认状态。

请求没走本站

同时检查 model.provider: custom 与 model.base_url 两项；跑 hermes doctor 排查。控制台「使用日志」能逐笔看到调用明细，可用于确认流量确实经过本站。

费用提示

自主 Agent 会长时运行、多轮调用，建议在控制台给密钥单独设置额度上限；模型单价见模型广场。

启动后显示 `Context limit: 2048 tokens` 或明显偏小

说明上下文长度没探测到（官方建议至少 64000）。在 ~/.hermes/config.yaml 里显式写死：

model:
  default: deepseek-v4-flash
  provider: custom
  base_url: https://api.juheai.shop/v1
  api_key: sk-xxxxxxxx
  context_length: 64000

提示 `hermes: command not found`

安装成功但当前终端还没加载新路径。关掉终端重开一个；macOS/Linux 也可以执行 source ~/.bashrc（或 source ~/.zshrc）后重试。

提示 `API key not set`

重跑一次向导 hermes model，把密钥填进去即可。

还是搞不定？把这三样发给客服，基本一看就知道问题在哪：① 终端里最后 5～10 行文字（可截图，注意别拍到密钥）② 你在本页做到第几步 ③ 报错的原文或截图。密钥属于隐私，发送前可以先给后几位打码。

Hermes Agent 由 Nous Research 开发（不是 Anthropic / OpenAI 的官方工具）。官网：hermes-agent.nousresearch.com，源码：github.com/NousResearch/hermes-agent。本站不代为分发安装包。