EcoPhase 文档 - 接入 Hermes

分别通过 Hermes Desktop 与 Hermes CLI 的 Custom endpoint，将默认模型连接到 EcoToken OpenAI 兼容网关。

Base URL	认证方式	接口协议
`https://ecotoken.ecophase-ai.com/v1`	Bearer API Key	OpenAI Chat Completions

01 准备接入信息

先在 EcoToken 控制台创建 API Key，并确认该 API Key 可以访问 deepseek-v4.1-flash。

YOUR_API_KEY 是占位符。不要把真实 API Key 提交到代码仓库。

02 安装 Hermes

推荐使用 v0.20.0 或更高版本。下面的一键安装命令适用于 Linux、macOS 和 WSL2；Windows 用户请先进入 WSL2。

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

03 方式一：EcoToken 工具配置

Windows 原生环境默认修改 %LOCALAPPDATA%\hermes\config.yaml；macOS、Linux 和 WSL 默认修改 ~/.hermes/config.yaml。原文件需要修改时会生成同目录的 .ecotoken.bak。

npm install -g @ecophase-ai/ecotoken

04 方式二：Hermes Desktop

点击右上角齿轮进入 Settings → Providers → API keys。

选择 Local / custom endpoint。

Hermes Desktop Providers 的 Local custom endpoint 入口

填写 EcoToken Base URL 和 API Key，然后点击 Connect。

Provider: Custom endpoint
API mode: OpenAI Chat Completions
API base URL: https://ecotoken.ecophase-ai.com/v1
API key: YOUR_API_KEY
Model name: deepseek-v4.1-flash
Context length: 1048576

回到主界面，从底部模型选择器的 Custom Endpoint 下选择 deepseek-v4.1-flash。

启用 Vision 能力

进入 Settings → 模型。在“辅助模型”中找到“视觉（图片分析）”，点击右侧的“更改”。

将视觉模型的提供方设为 Custom endpoint，模型选择 deepseek-v4.1-flash，然后点击“应用”。推理强度可以继承主模型设置。

将 Hermes Desktop 的视觉辅助模型设为 EcoToken deepseek-v4.1-flash

完成后即可在 Hermes 对话中粘贴或上传图片并进行提问。主模型和视觉辅助模型都应指向 deepseek-v4.1-flash。

05 方式三：Hermes CLI

在终端运行模型向导，选择 Custom endpoint，再按提示输入相同的端点、API Key 和模型信息。

hermes model

# Provider: Custom endpoint
# API mode: OpenAI Chat Completions
# API base URL: https://ecotoken.ecophase-ai.com/v1
# API key: YOUR_API_KEY
# Model name: deepseek-v4.1-flash
# Context length: 1048576

Hermes Desktop 与 Hermes CLI 使用同一套配置、API Key 和会话。在任一端完成设置后，另一端会读取相同结果。

06 启动并验证

hermes desktop

模型能返回内容，并且 EcoToken 控制台“用量与费用 → 请求记录”出现对应记录，即表示接入成功。

07 常见错误

401：检查 API Key 是否完整、是否已停用。
403：检查 API Key 分组、模型权限和账户状态。
model not found：模型名称必须与 EcoToken 控制台中的模型 ID 完全一致。