如何通过 Atlas Cloud 运行 Hermes Agent 和 DeepSeek API

您已经安装了 Hermes Agent，这是 Nous Research 的开源自主代理，现在您需要一个模型来支持它，这个模型要足够便宜以全天运行，并且足够强大以处理真实的工具调用。DeepSeek V4 在成本方面是一个显而易见的选择，Atlas Cloud 通过一个 OpenAI 兼容的端点提供 DeepSeek 系列以及 300 多个其他模型。本指南将引导您将 Hermes Agent 连接到 Atlas Cloud 上的 DeepSeek，从基本 URL 和模型 ID 到可用的 config.yaml，以便代理在生产级基础设施上运行，而无需第二个 SDK。

您正在连接什么

Hermes Agent 是一个持久的、自我改进的代理，运行在您自己的服务器上。它在设计上与模型和提供商无关，因此它不关心 DeepSeek 令牌是直接来自 DeepSeek 还是通过网关，只要端点支持 OpenAI API 格式。

Atlas Cloud 是一个全模态 AI 推理平台，通过一个 OpenAI 兼容的 API 密钥和一个计费账户公开文本、图像和视频模型。由于接口与 OpenAI 兼容，连接 Hermes 只需要更改基本 URL 和密钥，而无需重写代码。

这种配对对于持久代理很重要。Hermes 旨在运行数周，积累记忆和可重用技能，因此其背后的模型是经常性成本，而不是一次性调用。DeepSeek V4 在不牺牲工具调用质量的情况下保持了较低的经常性成本，通过 Atlas Cloud 路由意味着同一个密钥在回答聊天回合后，当技能需要时，可以生成图像或视频剪辑。您不仅选择了一个便宜的模型，还选择了一个代理不会过时的端点。

两个事实决定了整个设置，在您修改配置文件之前，这两个事实都值得准确理解：

• Atlas Cloud 基本 URL 是 https://api.atlascloud.ai/v1。
• Atlas Cloud 上的 DeepSeek 模型 ID 带有 deepseek-ai/ 前缀，例如 deepseek-ai/deepseek-v4-pro。这与 Hermes 使用其内置 DeepSeek 提供商时使用的裸 deepseek-v4-pro 不同，后者指向 DeepSeek 自己的端点。当您通过 Atlas Cloud 路由时，您使用完整的带前缀的 ID 和自定义的 OpenAI 兼容提供商，而不是内置的提供商。

步骤 1：获取您的 Atlas Cloud API 密钥

登录 console.atlascloud.ai，打开 API 密钥，点击创建 API 密钥，并将其复制到安全的地方。访问是按需付费的，因此没有押金，也没有最低消费。您注册，获取密钥，然后按请求付费。

将密钥排除在版本控制之外。Hermes 有意将秘密与设置分开：config.yaml 包含非敏感结构，可以安全地提交或共享，而 ~/.hermes/.env 包含密钥，默认情况下被 git 忽略。将 Atlas Cloud 密钥放入 .env 并从配置中按名称引用，这样您就可以版本化代理设置而不会泄露凭据。

textCopy
1echo "ATLASCLOUD_API_KEY=your-atlas-cloud-key" >> ~/.hermes/.env

2：确认您可以调用的 DeepSeek 模型 ID

Atlas Cloud 在公共端点发布其实时模型列表，因此您无需猜测 ID。快速调用即可返回 API 接受的确切字符串。

textCopy
1curl https://api.atlascloud.ai/v1/models \
2  -H "Authorization: Bearer $ATLASCLOUD_API_KEY"

首先查询列表并非多余。随着新版本的发布，模型 ID 会发生变化，来自博客文章或旧脚本的过时 ID 是第一次调用失败最常见的原因。/v1/models 端点是 API 今天将接受的真实来源，因此在编辑配置之前检查它可以避免一轮未知模型错误。您最常使用的 DeepSeek 条目是这些：

DeepSeek V4 Pro 在 Atlas Cloud 上的定价为每百万输入令牌 1.68 美元，每百万输出令牌 3.38 美元，而 V4 Flash 的定价为每百万输入令牌 0.14 美元，每百万输出令牌 0.28 美元。这种差距是下面配置中将主任务和辅助任务分开的原因。

步骤 3：将 Hermes 指向 Atlas Cloud

由于 Atlas Cloud 是一个自定义的 OpenAI 兼容端点，而不是 Hermes 的内置 DeepSeek 提供商，您需要在 ~/.hermes/config.yaml 中明确定义它。提供商块指定基本 URL 和保存您密钥的环境变量，模型块选择带前缀的 DeepSeek ID。

textCopy
1inference:
2  provider: atlascloud
3  base_url: https://api.atlascloud.ai/v1
4  api_key_env: ATLASCLOUD_API_KEY
5  model:
6    default: deepseek-ai/deepseek-v4-pro

保存文件，然后启动代理。

textCopy
1hermes

如果第一条消息返回正常回复，则连接正确。如果您收到身份验证错误，则 .env 中的密钥错误或未加载；如果您收到未知模型错误，请根据步骤 2 中 /v1/models 的输出重新检查 deepseek-ai/ 前缀。

这里最常见的错误是使用 Hermes 的内置 deepseek 提供商，却期望 Atlas Cloud 响应。内置提供商硬编码到 DeepSeek 自己的端点及其裸模型名称，因此它会愉快地向您的 DeepSeek 账户收费，并完全忽略 Atlas Cloud。通过 Atlas Cloud 路由是一个有意的自定义提供商选择：您自己的 base_url、您的 Atlas Cloud 密钥和带前缀的 deepseek-ai/ 模型 ID。将这三者保持在一起，两条路径永远不会混淆。

步骤 4：将廉价工作发送到 Flash

Hermes 在后台运行许多低价值的调用：网页摘要、视觉分析、上下文压缩、命令批准。为这些支付 V4 Pro 的费用是浪费。将辅助插槽指向 V4 Flash，这样主循环可以保留更强的模型，而后台任务以一小部分成本运行。

textCopy
1auxiliary:
2  web_extract:
3    provider: atlascloud
4    base_url: https://api.atlascloud.ai/v1
5    api_key_env: ATLASCLOUD_API_KEY
6    model: deepseek-ai/deepseek-v4-flash
7  compression:
8    provider: atlascloud
9    base_url: https://api.atlascloud.ai/v1
10    api_key_env: ATLASCLOUD_API_KEY
11    model: deepseek-ai/deepseek-v4-flash
12    timeout: 120

每个辅助插槽都接受自己的提供商、模型、基本 URL、密钥和回退链，因此您可以独立调整每个后台任务。

步骤 5：添加回退以提高弹性

长时间运行的代理最终会遇到速率限制或连接超时。回退链使其保持工作而不是出错。这里压缩任务首先尝试 V4 Flash，然后回退到第二个 Atlas Cloud 模型，最后才放弃。

textCopy
1auxiliary:
2  compression:
3    provider: atlascloud
4    base_url: https://api.atlascloud.ai/v1
5    api_key_env: ATLASCLOUD_API_KEY
6    model: deepseek-ai/deepseek-v4-flash
7    fallback_chain:
8      - provider: atlascloud
9        base_url: https://api.atlascloud.ai/v1
10        api_key_env: ATLASCLOUD_API_KEY
11        model: deepseek-ai/deepseek-v3.2

Hermes 会按顺序尝试每个条目，直到其中一个成功，因此单个提供商的故障不会使代理停滞。对于按计划无人值守运行的代理，这与一个安静恢复的 cron 作业和一个在凌晨 3 点死亡并在早上留下堆栈跟踪的作业之间的区别。

何时此设置最适合

通过 Atlas Cloud 在 DeepSeek 上运行 Hermes 在您希望代理所涉及的一切都使用一个密钥和一个账单时最有意义。由于同一个端点也提供图像和视频模型，因此最初只处理文本的代理以后可以生成图像或剪辑，而无需新的集成或第二个供应商账户。如果您的代理只调用 DeepSeek 而不调用其他任何东西，那么指向 DeepSeek 自己的 API 的内置 DeepSeek 提供商是更简单的路径。一旦您希望在单个 OpenAI 兼容接口后面添加跨模态模型，Atlas Cloud 路由就有了它的用武之地。

在将所有这些提交到配置文件之前，您可以在 atlascloud.ai/models 上自行确认每个模型 ID 和实时价格，这是随着 DeepSeek 产品线发展而值得保持的习惯。