1. AI应用
AboAI
中文
  • 中文
  • English
  • 首页
  • AboAi-API
    • 模型Model
      • 原生OpenAI格式
      • 原生Gemini格式
    • 聊天Chat
      • 原生OpenAI格式
      • 原生Gemini格式
      • 原生Claude格式
      • Responses 请求(openai)
    • 音频Audio
      • Gemini Live
      • 原生OpenAI格式 TTS
      • 原生Gemini格式 TTS
    • 图像Images
      • 原生OpenAI格式 图像生成
      • 原生Gemini格式 图像生成
      • 原生OpenAI格式 图像编辑（JSON）
      • 原生OpenAI格式 图像编辑（Multipart）
    • 视频Video
      • Seedance2.0格式
        • 创建视频生成任务
        • 查询视频生成任务状态
    • 向量 Vector
      • Embeddings
        • 创建 Embedding
    • 翻译Translation
      • 语音翻译
  • AI应用
    • AboAI API 对接Claude Code
    • AboAI API 对接Cursor
    • AboAI API 对接Codex-cli
    • AboAi API 对接Codex Desktop
    • AboAI API 对接 Hermes-Agent
  1. AI应用

AboAI API 对接 Hermes-Agent

适用于：
Hermes Agent（Nous Research）
AboAI API
Claude / GPT-5
macOS
Windows
Linux
WSL2

一、什么是 Hermes Agent#

Hermes Agent 是 Nous Research 开源的 AI Agent 框架。
主要特性：
自主执行任务
Tool Calling
MCP 支持
浏览器自动化
文件系统操作
长期记忆
多模型支持
官方项目：
Hermes Agent GitHub
官方文档：
Hermes Agent Docs

二、准备工作#

需要准备：
项目说明
AboAI API Keysk-xxxx
Git推荐安装
网络环境可访问 GitHub
操作系统macOS / Windows / Linux

三、macOS 安装教程#

1. 安装 Git#

验证：
如果未安装：

2. 安装 Hermes Agent#

官方推荐一键安装：
安装器会自动安装：
uv
Python 3.11
Node.js 22
ripgrep
ffmpeg
Playwright
无需手动安装 Python 或 Node.js。

3. 重载终端#

Zsh：
Bash：

4. 验证安装#

检查环境：

image.png#

四、Windows 安装教程#

推荐方案：WSL2#

官方推荐 Windows 用户优先使用 WSL2，当然也可以采用原生方案 原因：
稳定性最好
功能最完整
与 Linux 版保持一致
安装 WSL：
管理员 PowerShell：
wsl --install
重启电脑。
安装 Ubuntu。
打开 Ubuntu：
安装完成：
验证：

Windows 原生安装（Beta）#

PowerShell：
iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)
安装器自动安装：
uv
Python 3.11
Node.js 22
ripgrep
ffmpeg
PortableGit
安装完成后重新打开 PowerShell。
验证：
hermes doctor

五、使用 pipx 安装（可选）#

如果不想使用安装脚本：
Mac：
Windows：
python -m pip install --user pipx

python -m pipx ensurepath
安装 Hermes：
验证：

六、获取 aboai API 信息#

前往 AboAI 开放平台申请 sk。
aboai 开放平台
image-20260514140602533.png
image-20260514140819323.png
获取以下内容：
配置项示例
Base URLhttps://api.aboai.ai
API Keysk-xxxx
ModelClaude Opus 4.6 / GPT 5.2 ...

七、配置 AboAI#

打开配置文件目录（一般为安装用户目录）：
编辑“config.yaml”文件，添加如下配置：

八、启动 Hermes & 验证#

启动交互模式：
或者：
默认模型：
image.png
切换配置模型:
image.png
切换AboAi提供的任意模型：
image.png
回车
image.png
回车，上下任意选择AboAi提供的模型
image.png
测试是否正常使用：

image.png#

九、常用命令#

查看模型：
配置工具：
重新执行配置向导：
查看配置：
诊断环境：
升级：

十、常见问题#

hermes: command not found#

执行：
或者：

API Key 无效#

检查：
sk-xxxx
是否：
已开通额度
未过期
无空格

模型无法识别？#

配置模型报错：
✗ Model GPT‑5.2‑Chat was not found in this provider's model listing. Similar models: GPT-5.2-Chat, GPT-5.2, GPT-5.5
可能是复制编码报错导致，一样的字符串无法匹配模型，手动在配置文件输入模型名称即可

安装异常#

执行：
查看诊断结果。

十一、总结#

官方推荐安装方式：
macOS / Linux / WSL2：
Windows：
iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)
安装完成后，通过 Hermes 配置向导接入 AboAI，即可使用：
Claude
GPT-5
以及：
MCP
Browser Tool
Tool Calling
Agent Workflow
至此 Hermes Agent + AboAI 接入完成。
Modified at 2026-06-05 09:22:52
Previous
AboAi API 对接Codex Desktop
Built with