将 Hermes Agent 接入 Scenepond
让 Scenepond 为你的 Hermes 智能体提供模型 API。
官方接入文档- API 地址
https://scenepond-api-production.up.railway.app/v1- API 协议
- OpenAI Chat Completions
- 模型 ID
deepseek-flash· 填写模型目录中的完整 ID
Hermes Agent 在终端中执行任务。Scenepond 提供选定的聊天模型，Hermes 负责智能体会话与工具。
请先安装客户端并确认它能在本地启动。还需要 Scenepond 账户、已启用的聊天模型、具有相应权限的 API Key，以及足够支付首次请求的余额。
客户端安装与首次启动 ↗让你的编程智能体协助配置
将配置说明复制给你正在使用的编程智能体，其中包含接口地址与操作要求，不含 API Key。也可以按下方步骤手动配置。
请通过自定义供应商，将 Hermes Agent 接入 Scenepond。 Scenepond 接入指南: https://open.scenepond.ai/zh/integrations/hermes?model=deepseek-flash 官方接入文档: https://hermes-agent.nousresearch.com/docs/integrations/providers#named-custom-providers API 地址: https://scenepond-api-production.up.railway.app/v1 模型 ID: deepseek-flash API 协议: OpenAI Chat Completions 先检查已安装的客户端版本和现有配置，保留其他供应商、智能体、消息渠道和设置。 确认我的 API 密钥有权访问所选模型。核实工具支持和实际上下文限制，不要假设未确认的能力。 我会将原始密钥设置到 SCENEPOND_API_KEY 或客户端的安全凭据字段。不要让我把密钥粘贴到聊天中，也不要打印、提交到代码库或嵌入浏览器代码。 按 Scenepond 接入指南使用该客户端的供应商语法与密钥保存方式。使用以 /v1 结尾的基础地址和 chat completions 协议，填写 Scenepond 凭据，而非上游供应商凭据。 先在本地验证配置，发起付费 API 请求前请向我确认。如果缺少模型或凭据，说明需要补充的配置。不要自动重试请求。 说明修改了哪些设置、如何启动新会话，以及已验证和未验证的内容。
1. 准备模型与 API Key
从目录复制已启用的完整模型 ID，并创建具有相应访问权限的 Scenepond API Key。智能体任务需要确认模型支持工具调用；选择前请核对上下文限制和支持协议。
使用目录中的 deepseek-flash，并确认你的 API 密钥有访问权限。这些步骤配置的是聊天接口；图片和视频工具需要单独配置。
2. 配置自定义供应商
在现有 ~/.hermes/config.yaml 中合并以下供应商与模型配置，保留其他供应商和设置。
1providers:
2 scenepond:
3 api: "https://scenepond-api-production.up.railway.app/v1"
4 key_env: "SCENEPOND_API_KEY"
5 transport: "chat_completions"
6
7model:
8 provider: "custom:scenepond"
9 default: "deepseek-flash"在 ~/.hermes/.env 中通过 SCENEPOND_API_KEY 保存 Scenepond API Key 原值，无需填写 Bearer 前缀。
SCENEPOND_API_KEY=YOUR_SCENEPOND_API_KEYHermes 要求模型至少支持 64,000 Token 上下文。请按模型实际能力设置上下文长度，填写更大的数值不会扩大模型容量。
3. 开始新会话
hermes保存后开始新会话；已有 Hermes 会话会保留原模型，直到你切换。也可以使用 hermes model 交互式配置自定义接口。
4. 核对返回结果与用量
确认客户端选中了 Scenepond 供应商和完整的模型 ID。在新会话发送下面这条简短消息，请求会使用账户余额。
不要调用工具，只回复 READY。收到文本回复后，打开 Scenepond 用量记录，核对模型、请求时间与实际结算费用。文本回复可确认基本聊天接入；工具与推理能力应在模型支持时分别测试。
常见配置问题
- 找不到密钥或凭据被拒绝
- 确认实际运行的客户端能读取原始密钥，且 Scenepond 密钥已启用。诊断输出中不要包含密钥。
- 模型不可用
- 检查模型目录中的完整 ID、密钥权限与余额。OpenClaw 的模型引用还需要加上 scenepond/ 前缀。
- Hermes 上下文错误
- 选择实际支持至少 64,000 个上下文 Token 的模型。增大配置值不能扩展模型容量。
- 聊天成功，工具调用失败
- 检查所选模型的工具支持和客户端的工具设置。文本聊天成功不能证明所有智能体能力都可用。