Hermes Agent
在 Hermes Agent 中配置使用 OminiApi
Hermes Agent 是 Nous Research 开源的 AI Agent：可以在终端里对话编程，也可以用 hermes gateway 挂到 Telegram、Discord、Slack 等平台当机器人。它内置工具调用、记忆和技能系统，数据都保存在本地 ~/.hermes/ 目录。
Windows 用户
原生 Windows 支持还处于实验阶段，推荐先按 WSL 教程装好 WSL，再在 WSL 里操作。
安装与初始化
一键安装
脚本会自动安装 uv、Python 3.11 等依赖，不需要 sudo：
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash重载 shell 并启动
source ~/.bashrc # zsh 用户执行 source ~/.zshrc
hermes能看到交互界面说明安装成功。首次启动会进入设置向导，供应商选择这一步可以先跳过，下面再配置 OminiApi。
方式一：用 CC Switch 配置（推荐）
按 CC Switch 教程安装并打开 CC Switch，顶部应用栏切换到 Hermes，点击「添加供应商」。
填写配置：
- 预设供应商：选择「自定义」；
- 供应商标识：只能用小写字母、数字和连字符，例如
ominiapi； - API 模式：用 Claude 模型选
Anthropic Messages，端点填https://omini.ominiapi.top；用 GPT / DeepSeek 等模型选 OpenAI Chat Completions，端点填https://omini.ominiapi.top/v1； - API Key：你的 API Key（见 API 密钥）；
- 模型列表：每个模型填「模型 ID」和「显示名称」，「高级选项」保持默认。例如：
- 默认模型：模型 ID
claude-opus-5-5，显示名称Claude Opus 5.5 - 备选模型：模型 ID
claude-sonnet-5，显示名称Claude Sonnet 5
- 默认模型：模型 ID
填好后点击右下角「添加」。
在列表里找到刚添加的 OminiApi 供应商，点击「启用」。
CC Switch 实际写入的是 ~/.hermes/ 下的 .env（API Key 等敏感信息）和 config.yaml（供应商、模型等配置）。熟悉 Hermes 的话，也可以按下面的方式手动编辑。
方式二：手动编辑配置文件
手动配置走 OpenAI 兼容接口，适合 GPT、DeepSeek、GLM、Kimi、Gemini 等模型。Claude 模型只支持 Anthropic 接口，请用方式一。
打开配置目录
cd ~/.hermes
explorer.exe .编辑 config.yaml
把 model 这一段改成：
model:
provider: custom
default: gpt-6
base_url: https://omini.ominiapi.top/v1
api_mode: chat_completionsbase_url要带/v1；default填 模型广场 里的模型名，例如gpt-6、deepseek-v4-pro、kimi-k3。
验证
重新打开终端，运行 hermes 进入对话界面。
输入 /model，在模型选择器里能看到 OminiApi 和刚配置的模型，选中后回车。之后想换供应商，回到 CC Switch 一键切换即可。
随便发一句话，能正常回复就说明配置成功。报 Key 错误、地址错误或模型不存在时，回到上面的步骤检查，或到 使用日志 查看原因。
常用命令
| 命令 | 说明 |
|---|---|
hermes | 进入交互式 CLI |
hermes model | 交互式选择供应商 / 模型 |
hermes dashboard | 启动 Web 界面 |
hermes config set KEY VALUE | 写入配置（密钥会保存到 .env） |
hermes gateway setup | 配置 Telegram / Discord 等平台机器人 |
hermes doctor | 诊断环境问题 |
hermes update | 更新到最新版本 |
Hermes 更新后配置格式可能变化，以 Hermes 官方文档 为准。