Hermes Agent

手把手教你用 Hermes Agent 通过 OpenAI Hub 接入 GPT-4o、Claude、DeepSeek 等第三方 AI 模型，零编程基础也能跟着命令跑通，一个 API Key 调用所有模型。

这篇教程带你从零开始，用 Hermes Agent 对接 OpenAI Hub 上的第三方 AI 模型，全程不需要写代码，跟着命令复制粘贴就能跑通。

前置准备

你需要准备两样东西：

一台电脑（macOS、Linux 或 Windows 都行）
一个 OpenAI Hub 的 API Key —— 去 openai-hub.com 注册后在后台获取

OpenAI Hub 是一个 AI 模型聚合平台，一个 Key 就能调用市面上几乎所有主流模型（Claude、GPT、Gemini、DeepSeek 等），省去你到处注册账号的麻烦。

第一步：安装 Hermes Agent

打开你电脑的终端（macOS 叫"终端"，Windows 搜索"PowerShell"）。

macOS / Linux 用户，粘贴这条命令然后回车：

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

Windows 用户，打开 PowerShell（右键以管理员身份运行），粘贴：

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

脚本会自动帮你装好 Python、Node.js 等所有依赖，等它跑完就行。

macOS / Linux 装完后多执行一步，让命令生效：

source ~/.zshrc

注意： Windows 安装过程中如果弹出安全提示，选"允许"就好。整个安装大概 3-5 分钟，取决于网速。

第二步：配置 OpenAI Hub 作为模型供应商

这是最关键的一步。Hermes Agent 的设计很聪明——只要是兼容 OpenAI 格式的 API，都能直接接入。OpenAI Hub 完美符合这个条件。

在终端输入：

hermes config

进入配置向导后，选择 AI Provider（模型供应商）相关选项，然后按下面的信息填写：

配置项	填什么
Provider 类型	选 `OpenAI` 或 `OpenAI Compatible`
API Key	`sk-your-api-key`（换成你自己在 OpenAI Hub 拿到的 Key）
Base URL	`https://api.openai-hub.com/v1`

这里容易出问题： Base URL 末尾的 /v1 不能丢，很多人漏掉这个导致请求报错。另外 API Key 前后不要有多余的空格。

如果配置向导里没有直接让你填 Base URL 的地方，你也可以手动编辑配置文件。配置文件位置：

macOS / Linux：~/.hermes/config.yaml
Windows：%USERPROFILE%\.hermes\config.yaml

用任意文本编辑器打开，找到或添加以下内容：

provider:
  type: openai
  api_key: sk-your-api-key
  base_url: https://api.openai-hub.com/v1
  model: gpt-4o

model 字段填你想用的模型名称。OpenAI Hub 支持的模型很多，常用的比如：

gpt-4o — OpenAI 最新多模态模型
claude-sonnet-4-20250514 — Anthropic Claude
deepseek-chat — DeepSeek
gemini-2.5-pro-preview-05-06 — Google Gemini

具体支持哪些模型，登录 OpenAI Hub 后台查看模型列表。

第三步：选择模型并开始对话

配置好之后，在终端运行：

hermes model

这条命令会让你确认或切换当前使用的模型。确认模型名称显示正确后，直接开聊：

hermes

看到对话界面就说明一切正常，你已经通过 OpenAI Hub 成功接入了第三方模型。

注意： 如果启动后发现模型名称显示不对或显示为空，在对话界面里输入 /model 手动指定模型名称即可。这是个已知的小问题，手动设一下就好。

第四步（可选）：接入聊天平台

Hermes Agent 不只能在终端里用，还能接到飞书、Telegram 等平台上，变成你的私人 AI 助手。

以飞书为例，新开一个终端窗口，运行：

hermes gateway setup

选择飞书（feishu），按提示填入你在飞书开放平台创建的机器人应用的 App ID 和 App Secret 就行。

这里容易出问题（Windows 用户注意）： 启动网关时如果报 lark-oapi 缺失的错误，需要把依赖装到 Hermes 自带的虚拟环境里，而不是你系统的 Python 里。找到 Hermes 的 venv 路径后执行：
<hermes-venv-path>/bin/pip install lark-oapi

常见问题速查

Q：报错 401 Unauthorized 检查你的 API Key 是否正确，有没有多余空格，以及 OpenAI Hub 账户里是否还有余额。

Q：报错 404 Not Found 大概率是 Base URL 填错了。确认是 https://api.openai-hub.com/v1，注意 https 和末尾的 /v1。

Q：报错 model not found 你填的模型名称在 OpenAI Hub 上不存在。去后台确认一下模型的准确名称，注意大小写。

Q：想换个模型怎么办？ 随时在对话中输入 /model，或者重新跑 hermes model，或者直接改配置文件里的 model 字段。因为用的是 OpenAI Hub，换模型不需要换 Key，改个名字就行。

接下来你可以试试：用 /skill 命令创建自定义技能让 Agent 自动执行重复任务，或者在 OpenAI Hub 后台切换不同模型对比效果——反正一个 Key 全搞定，多试几个找到最适合你的。