在 Hermes 中使用 aicentos

项目简介

Hermes Agent 是 Nous Research 推出的通用 AI Agent，支持 CLI 对话、工具调用、记忆、技能、网关和定时任务。它既可以连接官方支持的云服务，也可以接入任意 OpenAI 兼容端点。

• 官方网站：https://hermes-agent.nousresearch.com
• 文档：https://hermes-agent.nousresearch.com/docs
• GitHub：https://github.com/NousResearch/hermes-agent
• Web3Hermes：https://web3hermes.com

前提条件

• 已获取 aicentos API Key（控制台获取）
• 本机可用 git
• 本机可用 python3

安装 Hermes

环境要求

• macOS / Linux / WSL2
• Windows 可通过 PowerShell 直接安装，但仍推荐优先使用 WSL2
• 安装器会自动处理 Python、Node.js、ripgrep、ffmpeg 等依赖，无需手动预装

推荐：安装 Web3Hermes

如果你希望使用更适合中国大陆用户的桌面浏览器界面，推荐优先安装 Web3Hermes。它是基于 Hermes Agent 的轻量级 Web 界面，官方 README 见：Web3CZ/Web3Hermes。

git clone https://github.com/Web3CZ/Web3Hermes.git
cd Web3Hermes
python3 bootstrap.py

也可以在项目目录内使用启动脚本：

./start.sh

服务默认会在 http://127.0.0.1:8787 启动。

安装 Hermes Agent CLI

中国大陆镜像（推荐）

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

官方安装器

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Windows PowerShell

irm https://res1.hermesagent.org.cn/install.ps1 | iex

安装完成后重新加载终端配置：

source ~/.zshrc

如果你使用的是 bash，请改为：

source ~/.bashrc

如果你使用 Windows PowerShell，关闭并重新打开终端即可。

提示

如果你在中国大陆网络环境下安装，优先使用 https://hermesagent.org.cn 提供的镜像入口，成功率通常更高。

配置 aicentos

Hermes 官方推荐优先使用 hermes model 进行交互式配置。对于 aicentos，这里选择 Custom endpoint 即可，因为 aicentos 提供 OpenAI 兼容接口。

如果你想在安装后一次性完成初始化，也可以运行：

hermes setup

如果只想补配工具权限，可以运行：

hermes tools

方式一：使用 hermes model 交互式配置（推荐）

运行：

hermes model

按提示填写以下内容：

• Provider：Custom endpoint (self-hosted / VLLM / etc.)
• API base URL：https://www.aicentos.com/v1
• API key：你的 aicentos Token
• Model name：gpt-5.4
• Context length：建议至少填写 65536

配置完成后，Hermes 会把模型、提供商和地址写入 ~/.hermes/config.yaml。

重要

Hermes 对可工作的模型上下文有最低要求。自定义端点下请优先选择上下文窗口不低于 64K 的模型，否则多步工具调用和长上下文任务可能直接被拒绝或表现异常。

方式二：手动编辑配置文件

Hermes 的主配置文件位于 ~/.hermes/config.yaml。如果目录不存在，可以先创建：

mkdir -p ~/.hermes
touch ~/.hermes/config.yaml
touch ~/.hermes/.env

然后在 ~/.hermes/.env 中写入你的 Token：

OPENAI_API_KEY=sk-你的Aicentos-Token

再把以下内容写入 ~/.hermes/config.yaml：

model:
  default: gpt-5.4
  provider: custom
  base_url: https://www.aicentos.com/v1

提示

Hermes 对自定义端点会优先读取 config.yaml 中的 provider、default、base_url，API Key 则可以直接写在 config.yaml，也可以像上面这样放到 ~/.hermes/.env 的 OPENAI_API_KEY 中。为了避免明文写密钥，推荐使用 .env。

切换模型

如果你想使用其他 aicentos 支持的模型，只需要修改 model.default，或者重新运行 hermes model。

例如：

model:
  default: claude-sonnet-4-5-20250929
  provider: custom
  base_url: https://www.aicentos.com/v1

注意

这里的前提是该模型可以通过 aicentos 的 OpenAI 兼容入口访问，并且上下文窗口满足 Hermes 的最低要求。如果你不确定具体模型 ID，先参考 支持的模型 页面，再填入 default 字段。

启动使用

直接进入对话：

hermes

也可以直接发起一条测试消息：

hermes chat -q "用一句话回复：https://www.aicentos.com/ 已连接"

如果你已经配置成功，在会话内还可以用 /model 切换到已经接入过的模型。

验证配置

优先做这三个检查：

hermes doctor

hermes config check

hermes chat -q "请只回复 ok" -Q

如果最后一条命令能正常返回内容，说明 aicentos 接入已经生效。

常见问题

为什么要选 Custom endpoint？

因为 Hermes 官方把任意 OpenAI 兼容接口统一归类为 provider: custom。aicentos 的接入方式正符合这个模式，所以不需要额外写 Hermes 专用适配器。

OPENAI_BASE_URL 或 LLM_MODEL 为什么不生效？

Hermes 官方已经移除了这两个旧环境变量的读取逻辑。现在模型、提供商和端点地址以 ~/.hermes/config.yaml 为准，不应再依赖旧变量。

配置了 Key 但还是认证失败怎么办？

按下面顺序排查：

1. 确认 base_url 写的是 https://www.aicentos.com/v1
2. 确认 Token 来自 aicentos 控制台
3. 确认 model.default 填的是有效模型 ID，例如 gpt-5.4
4. 确认模型上下文不低于 65536
5. 运行 hermes config check 与 hermes doctor 查看具体报错

Windows 能直接安装吗？

可以通过 PowerShell 安装，但从稳定性和兼容性看，仍然推荐优先使用 WSL2。对于浏览器自动化、依赖管理和类 Unix 工作流，WSL2 的体验通常更稳。