Hermes / OpenClaw 接入 CC Switch 教程

ModelGate 专属教程：Hermes / OpenClaw 接入 CC Switch

本教程适用于通过 ModelGate 中转站为 Hermes 和 OpenClaw 配置 CC Switch 供应商。请按截图完成专用 API Key 创建、OpenAI Chat Completions 模式选择、模型获取和保存。

操作说明

Hermes 和 OpenClaw 的接入流程完全相同，仅 CC Switch 顶部的工具页签不同。下文以 Hermes 为例，OpenClaw 照做即可。

两者在本教程中都使用 OpenAI Chat Completions 接入方式。请重点核对供应商名称、API 地址、API 模式和 API Key，模型列表以 CC Switch 实际获取结果为准。

适用场景

需要让 Hermes / OpenClaw 通过 ModelGate 调用 OpenAI 兼容模型，并由 CC Switch 保存供应商配置。

配置目标

创建 Hermes / OpenClaw 专用 Key，新增 ModelGate 供应商，选择 OpenAI Chat Completions 模式。

完成标准 CC Switch 成功获取模型列表并保存供应商，Hermes / OpenClaw 后续可直接选择该供应商使用。 接口端点 统一填写 https://modelgate.app。API 模式选择 OpenAI Chat Completions。模型列表以当前 CC Switch 获取结果为准。

创建 Hermes / OpenClaw Key

进入 ModelGate 接入引导页创建 Hermes（或 OpenClaw）专用 API Key。专用 Key 便于区分用量，也方便单独停用或更换。注册账号后进入 令牌管理 页面。创建密钥时名称可填写 Hermes 或 OpenClaw，分组选择适合 OpenAI 兼容调用的分组。创建完成后确认 Key 信息和分组无误。在操作区点击 导入 CCS，将该 Key 带入 CC Switch。

添加 Hermes / OpenClaw 供应商

切换到 CC Switch 顶部的 Hermes（或 OpenClaw）页面，新增 ModelGate 供应商。该页面会把对应工具所需的供应商信息集中保存。

供应商名称保持 ModelGate，便于后续识别。
API 地址填写 https://modelgate.app。
API 模式选择 OpenAI Chat Completions。
API Key 填入刚创建的专用 Key。

获取模型并保存

点击获取模型，确认模型列表能够正常返回，再检查 JSON 配置并保存。确认 apiKey 已填入、baseUrl 为 https://modelgate.app、API 模式为 Chat Completions。保存后供应商卡片显示完成，即可在 Hermes / OpenClaw 中使用该配置。

最终核对清单

已创建 Hermes（或 OpenClaw）专用 ModelGate Key。
CC Switch 已切换到 Hermes（或 OpenClaw）页面，并新增 ModelGate 供应商。
供应商 API 地址为 https://modelgate.app，API 模式为 OpenAI Chat Completions。
API Key 已填入专用 Key。
已点击获取模型，并确认模型列表正常返回。
供应商已保存完成，对应工具后续可选择该配置使用。

常见问题排查

Hermes / OpenClaw 无法获取模型列表怎么办？

优先检查 API 地址是否为 https://modelgate.app、API 模式是否为 OpenAI Chat Completions，以及 API Key 是否正确。

保存后仍然无法调用怎么办？

回到 CC Switch 对应工具页面，确认供应商卡片处于启用状态。如已启用但仍无法调用，尝试重新获取模型并保存；问题持续时，删除供应商后重新添加。