Hermes Agent 使用 Ace Data Cloud 教程

进击的Coder

2026年8月20日 23:43
江苏

在小说阅读器读本章

去阅读

Hermes Agent 是 Nous Research 推出的开源终端 Agent，支持持久化记忆、技能创建、21+ 通讯平台网关（Telegram、Discord、Slack、WhatsApp、Signal、Matrix 等），可运行在本地、Docker、SSH、Daytona、Modal、Vercel Sandbox 等多种后端。

Hermes 原生支持任意 OpenAI 兼容端点，可以无需额外插件直接接入 Ace Data Cloud，一把 API Token 同时访问 Claude、GPT、Gemini、Grok、DeepSeek、Kimi、GLM 等 60+ 大模型。本文介绍配置流程。

申请流程

要使用本服务，首先到 Ace Data Cloud 控制台 ，或者识别下方二维码：

然后获取您的 API Token，留作备用。

如果尚未登录或注册，会自动跳转登录页面邀请您注册和登录，注册登录后会自动返回当前页面。首次申请时会赠送免费额度，可以免费体验 Hermes Agent 配合 Ace Data Cloud 的能力。

安装 Hermes Agent

Hermes 是一个 Python 包，需要 Python 3.10 或更高版本。推荐用 pipx 全局安装：

pipx install hermes-agent

也可以用 pip：

pip install --user hermes-agent

安装完成后检查命令是否可用：

hermes --version

如果提示 command not found，请检查 pipx 或 pip --user 的 bin 目录是否在 PATH 中。

配置 Ace Data Cloud

Hermes 把\"机密\"（API Token）与\"非机密\"（provider 与模型选择）分别保存在 ~/.hermes/.env 与 ~/.hermes/config.yaml。Ace Data Cloud 通过 Hermes 的 Custom Endpoint 机制接入，有两种配置方式。

方式一：交互式 hermes model（推荐）

运行：

hermes model

Hermes 会列出所有可用 provider，选择：

Custom endpoint (self-hosted / VLLM / etc.)

然后按提示输入：

Hermes 会把选择写入 ~/.hermes/config.yaml，把 API Token 写入 ~/.hermes/.env，然后即可开始：

hermes chat

方式二：手动编辑配置文件

如果希望直接编辑配置（例如批量部署、CI/CD 场景），编辑 ~/.hermes/.env：

ACEDATA_API_KEY={token}

{token} 替换为您的 API Token。

然后编辑 ~/.hermes/config.yaml：

custom_providers:
  - name: acedatacloud
    base_url: https://api.acedata.cloud/v1
    key_env: ACEDATA_API_KEY
    api_mode: chat_completions

model:
  provider: custom:acedatacloud
  default: claude-sonnet-4-6
  context_length: 200000

保存后即可启动：

hermes chat

“

Hermes 要求每个会话至少 64K context window。下方推荐的模型都满足。若你启用了较小上下文的模型（如 32K 以下），Hermes 启动会拒绝。

验证对接

按上述配置完成后，跑下面几个最小命令即可确认 Hermes 已经走通 Ace Data Cloud。

1. 检查 Hermes 版本

$ hermes --version
Hermes Agent v0.15.2 (...)
Python: 3.12.x

只要能输出版本号就说明命令行可用。

2. 单轮对话（默认模型 claude-sonnet-4-6）

用 -Q 静默模式 + --max-turns 1 跑一次最小化对话，让模型原样回显一段字符串：

$ hermes chat -Q --max-turns 1 -q \"Reply with EXACTLY this string and nothing else: HERMES_OK\"

HERMES_OK

输出中能看到 HERMES_OK 就说明 /v1/chat/completions 走通了。

3. 切换到另一个模型

$ hermes chat -Q --max-turns 1 -q \"Reply ONLY with the word PONG\"

PONG

可以把 claude-sonnet-4-6 替换为 gpt-5、gemini-2.5-pro、deepseek-v3.2-exp 等下方\"推荐模型\"中的任意 ID 复跑，确认多个模型族都可用。

4. 直接 curl 对照（不依赖 Hermes）

如果想绕过 Hermes 单独验证端点，可以直接 curl：

$ curl -sS -H \"Authorization: Bearer $ACEDATA_API_KEY\" \\
       -H \"Content-Type: application/json\" \\
       -X POST https://api.acedata.cloud/v1/chat/completions \\
       -d '{\"model\":\"claude-sonnet-4-6\",\"messages\":[{\"role\":\"user\",\"content\":\"reply HERMES_OK\"}],\"max_tokens\":20}'

返回 OpenAI 兼容的 chat.completion 对象，choices[0].message.content 字段即模型回复。若返回 HERMES_OK，则确认 Token 与模型 ID 配置正确。

5. 如果任何一步失败

不要继续调参，先按下方\"故障排查\"小节定位原因；尤其 HTTP 402 / HTTP 403 used_up 说明 Token 有效但余额不足，到 platform.acedata.cloud/console/balance 充值即可。

推荐模型

下面这些模型已经过 Ace Data Cloud POST /v1/chat/completions 端到端验证，可以直接作为 model.default 使用：

完整模型目录可在 https://api.acedata.cloud/v1/models 查询（也是 Hermes 启动时自检调用的端点）。

切换模型也可以在运行中的 chat 里随时执行：

/model custom:acedatacloud:gpt-5
/model custom:acedatacloud:gemini-2.5-pro
/model custom:acedatacloud:deepseek-v3.2-exp

如需持久化到 config.yaml，加 --global 参数：

/model custom:acedatacloud:claude-opus-4-8 --global

用便宜模型跑辅助任务（可选，节省成本）

Hermes 把会话标题生成、视觉分析、上下文压缩、网页摘要等\"辅助任务\"默认走主模型。如果主模型用 Opus / GPT-5 等高价位模型，这部分会浪费成本。可以把辅助任务路由到便宜的 Flash 模型：

auxiliary:
  title:
    provider: custom:acedatacloud
    model: gemini-2.5-flash
  vision:
    provider: custom:acedatacloud
    model: gemini-2.5-flash
  compression:
    provider: custom:acedatacloud
    model: gemini-2.5-flash
  web_extract:
    provider: custom:acedatacloud
    model: gemini-2.5-flash-lite

也可以用 hermes model 的 \"Show auxiliary\" 面板配置。

计费说明

所有调用都按 Ace Data Cloud 平台侧的 Credits 计费 —— 按模型与 token 数量。Token 余额、消费记录、按模型聚合的用量都在 platform.acedata.cloud/console/usages 查看；余额不足时到 platform.acedata.cloud/console/balance 充值。

Hermes 自身没有任何额外收费。

高级：与其他 provider 共存 + 故障切换

Hermes 支持 custom_providers: 列表，你可以同时把 Ace Data Cloud、本地 Ollama、Together AI 等都配置好，运行时随意切换。也可以配置 fallback chain，主 provider 失败时自动降级到另一个：

custom_providers:
  - name: acedatacloud
    base_url: https://api.acedata.cloud/v1
    key_env: ACEDATA_API_KEY
  - name: local
    base_url: http://localhost:11434/v1   # 本地 Ollama

model:
  provider: custom:acedatacloud
  default: claude-sonnet-4-6

fallback_providers:
  - provider: custom:acedatacloud
    model: gpt-5
  - provider: custom:local
    model: qwen2.5-coder:32b

故障排查

更多详情可参考 Hermes 官方文档：

• Hermes Agent — AI Providers — 完整 provider 列表
• Hermes Agent — Configuring Models — 模型配置详解
• Hermes Agent GitHub

相关链接

• Hermes Agent 官网：hermes-agent.nousresearch.com
• Ace Data Cloud 控制台：platform.acedata.cloud
• 全部模型目录：api.acedata.cloud/v1/models