Hermes Agent

适用边界

本文描述的是 Hermes 调 Ling.AI：Hermes Agent 把 Ling.AI 当作 OpenAI-compatible provider 发起模型请求。不要和 Hermes API Server 混淆，后者是把 Hermes 暴露给其它客户端调用，方向相反。

准备

• 安装 Hermes Agent，并确认当前版本支持 OpenAI-compatible provider 配置。
• 在 Ling.AI 控制台创建 API Key，确认 Key、余额、套餐和模型授权可用。
• 请求 GET https://api.lingyuncx.com/v1/models，复制一个适合 agent 任务的模型 ID。
• 如果使用 CC Switch 管理 provider，先安装并启动 CC Switch。

直接配置

Hermes 通常先读取 shell 环境变量；如果当前版本支持 hermes config set 或 ~/.hermes/.env，也可以把同样的变量写入 Hermes 用户配置。团队共享文档只写变量名，不写真实 Key。

1. 设置 Base URL。 设置 OPENAI_BASE_URL=https://api.lingyuncx.com/v1。
2. 设置 API Key。 设置 OPENAI_API_KEY 为 Ling.AI API Key。
3. 设置模型。 设置 OPENAI_MODEL 为 /v1/models 当前返回的模型 ID。
4. 重启 Hermes。 让 Hermes 进程重新读取环境变量。
5. 先禁用高风险动作。 首次验证只发只读 prompt，不让 Hermes 执行文件写入或命令。

配置示例

export OPENAI_BASE_URL="https://api.lingyuncx.com/v1"
export OPENAI_API_KEY="<YOUR_LING_AI_API_KEY>"
export OPENAI_MODEL="your-model-id-from-v1-models"

CC Switch 配置

CC Switch 支持 Hermes app-specific provider。通过 CC Switch 配置时，Base URL 使用 https://api.lingyuncx.com/v1，模型 ID 仍以 /v1/models 当前返回值为准。

1. 进入 Hermes 工具页。 启动 CC Switch，选择 Hermes。
2. 新增 provider。 点击加号或 Add Provider。
3. 选择自定义供应商。 使用 Custom Configuration、API Key Provider 或当前版本等价入口。
4. 填写名称。 Provider Name 建议填 Ling.AI。
5. 填写 Base URL。 输入 https://api.lingyuncx.com/v1。
6. 填写 API Key。 粘贴 Ling.AI API Key，或使用 CC Switch 支持的本机密钥引用。
7. 填写模型。 Model ID 填 /v1/models 当前返回值。
8. 启用并重启。 保存后 Enable / Switch，重启 Hermes，再运行短 prompt。

验证

1. 运行 Hermes 的短 prompt，先不要让它写文件或执行命令。
2. 确认 Hermes 收到模型回复。
3. 到 Ling.AI 控制台核对请求状态、模型 ID、usage 和钱包扣费。
4. 确认没有把 Hermes API Server 当作 Ling.AI 的上游 provider 配置。

排障

参考资料

• Hermes Providers 文档
• Hermes Configuration 文档
• CC Switch 官方仓库