Hermes 接入 XXAPI

✳

让 AI 帮你完成配置

首次安装或切换到 XXAPI，都可以使用。

打开豆包 ↗

AI 打不开链接时，。

查看短提示词

我想通过 XXAPI 使用 Hermes Agent，请先确认我的电脑系统（macOS / Linux / Windows WSL2）。请先阅读教程： https://docs.xxapi.ai/text/hermes.txt 先确认我是首次安装还是更换服务商。能操作本机时，请先检查并备份配置，再协助完成；只能聊天时，每次带我做一步，等我反馈再继续。密钥由我在本机填写，完成后验证连接。打不开链接就告诉我，我会提供完整教程。

Hermes 可以在终端里对话、操作文件，也能接入聊天软件。本页先完成终端对话，后续功能按需要再加。

1. 安装 Hermes

macOS、Linux 直接打开终端。Windows 建议在 WSL2 的 Linux 终端里操作，原生 Windows 支持仍属于实验功能。没有 WSL 的用户先按 Microsoft WSL 安装说明 安装并进入 Ubuntu。

运行 Hermes 官方安装命令。

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

安装完成后重新打开终端，执行 hermes --help。能看到命令帮助，说明程序已安装。

2. 选择配置方式

macOS 或 Linux 桌面用户可以按下一节用 CC Switch 配置。Windows WSL 用户直接展开下面的终端配置，确保密钥保存在 WSL 的 Hermes 环境中。Windows 上的 CC Switch 不一定写入 WSL 的家目录。

Windows WSL / 无桌面服务器：用 Hermes 自己的向导配置

在安装 Hermes 的同一个终端运行。

hermes model

选择自定义 API 服务商（Custom Endpoint）。依次填入 https://xxapi.ai/v1、自己的 XXAPI API Key，以及从 模型广场 复制的模型 ID。协议选择 OpenAI Chat Completions，模型需支持工具调用。列表没有你的模型时，手动输入模型名称。Context length 留空让程序自动检测，Display name 填 XXAPI。

向导保存后执行 hermes，跳到本页“发出第一条消息”。已有 Hermes 用户也可以用这条命令修改连接，不需要重新安装。

3. 在 CC Switch 里添加 XXAPI

先安装 CC Switch，确认使用的是带 Hermes 入口的版本。在顶部选择 Hermes，点击 添加供应商。

这一节使用 Claude 模型。准备一枚可调用 Claude 的 XXAPI API Key，并复制模型 ID。

查看当前可用模型与分组从 XXAPI 后台读取

选择与你的 API Key 相同的分组，再复制模型名称。

项目	填写内容
预设供应商	自定义
名称	XXAPI
供应商标识	xxapi
API 模式	Anthropic Messages
API 端点	https://xxapi.ai
API Key	自己的 XXAPI API Key
模型 ID	复制的 Claude 模型 ID
显示名称	可以与模型 ID 一样

选择供应商列表首项的 自定义配置，再填写表单。先添加一个模型并设为默认，高级参数保持默认。

XXAPI 自定义供应商表单局部示意。API 模式为 Anthropic Messages，地址为 https://xxapi.ai。

MODEL_ID 请替换成模型广场中的真实 ID，本次只添加一个默认模型。

点击添加，返回列表后在 XXAPI 上点击 启用。

密钥和模型请填写自己的值；界面位置以当前软件版本为准。

4. 发出第一条消息

重新打开终端，运行 hermes。进入后输入 /model，确认选中的是刚配置的模型。

发送“请用一句中文打个招呼，先不要执行任何命令”。收到回复，说明基础连接已经完成。

已经有 Hermes 配置

先备份 ~/.hermes/config.yaml 和 ~/.hermes/.env，它们分别保存配置与密钥。添加 XXAPI 服务商后切换默认模型，已有的工作目录和聊天软件设置可以继续保留。

已有终端需要退出再进入；运行中的会话不会因为你刚改了配置就自动使用新连接。不要把整个 .hermes 目录从 Windows 覆盖到 WSL。

遇到问题

看到的情况	处理方法
hermes 找不到	安装后重新打开终端，检查是否在同一个系统环境里运行
CC Switch 没有 Hermes	更新 CC Switch；也可以直接用 hermes model 配置
WSL 仍然提示选择供应商	在 WSL 内运行 hermes model，不要只配置 Windows 上的文件
401	检查密钥；Claude 模式地址为 https://xxapi.ai
模型不存在或协议报错	Claude 配 Anthropic Messages；通用 Chat 模型配 OpenAI Chat Completions 和 /v1

后续接入聊天软件、更多模型与官方文档

终端对话通过后，再运行 hermes gateway setup，按官方向导选择需要的聊天软件。机器人 Token 来自对应聊天平台，与 XXAPI API Key 分开填写。

• Hermes 模型配置
• CC Switch 源码