零成本AI自由：Hermes接入硅基流动免费API全攻略
一、概述
Hermes Agent 是 Nous Research 于 2026 年 2 月发布的开源 AI 代理框架，支持 200+ SOTA 模型。硅基流动（SiliconFlow）是国内提供高性价比 API 服务的平台，API 格式兼容 OpenAI，Hermes 可直接对接。
本文档记录将 Hermes Agent 接入硅基流动 API 的完整流程，包含安装、配置、验证及常见问题排查。
二、准备工作
2.1 系统要求
| 操作系统 | Linux / macOS / WSL2（Windows 需 WSL2） |
| Node.js | 22+ |
| Git | 已安装 |
| 网络 | 能访问 https://api.siliconflow.cn/v1 |
2.2 注册硅基流动并获取 API Key（免费）
💡 邀请码：BvcOKsRz — 通过上方链接或输入此邀请码注册，可获得额外免费额度。
2.3 确认模型 ID
硅基流动支持多种模型，常见模型 ID 包括：
| DeepSeek-R1 | Pro/deepseek-ai/DeepSeek-R1 |
| DeepSeek-V3 | deepseek-ai/DeepSeek-V3 |
| DeepSeek-V4-Flash | deepseek-ai/DeepSeek-V4-Flash |
| Qwen2.5-7B | Qwen/Qwen2.5-7B-Instruct |
| Qwen2.5-32B | Qwen/Qwen2.5-32B-Instruct |
完整模型列表请参考：硅基流动模型库
三、安装 Hermes Agent
3.1 一键安装（推荐）
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安装过程中会自动检测并安装 uv、Python、Node.js、ripgrep、ffmpeg 等依赖。
3.2 刷新环境变量
source ~/.bashrc
# 或
source ~/.zshrc
3.3 验证安装
hermes –version
四、配置硅基流动 API
Hermes 提供了两种配置方式：交互式配置向导（hermes setup）和 模型提供商切换命令（hermes model）。两者均可完成配置，用户可根据习惯选择。
4.1 方式一：使用 hermes setup 交互式向导（推荐新手）
运行配置向导：
hermes setup
关键步骤说明：
| 1 | 选择设置方式 | 选 Full setup（完整设置），以便手动配置自定义端点 |
| 2 | 选择推理提供商 | 向下滚动，选择 Custom endpoint (enter URL manually) |
| 3 | 填写 Base URL | https://api.siliconflow.cn/v1 |
| 4 | 填写 API Key | 粘贴硅基流动 API Key |
| 5 | 填写 Model Name | 例如 deepseek-ai/DeepSeek-V4-Flash |
| 6 | API 兼容模式 | 选择 Chat Completions 或 Auto-detect |
| 7 | 显示名称 | 可填 SiliconFlow 或直接回车 |
| 8 | 其他配置 | TTS、终端后端等可直接回车使用默认值 |
4.2 方式二：使用 hermes model 切换提供商（更快速）
如果仅需修改模型提供商，无需走完整向导，可直接使用 hermes model 命令。
步骤 1：运行命令
hermes model
步骤 2：选择提供商
终端显示如下菜单（部分）：
Select provider:
↑↓ navigate ENTER/SPACE select ESC cancel
(●) Nous Portal …
(○) OpenRouter …
…
(○) custom (direct API)
(○) Custom endpoint (enter URL manually)
(○) Configure auxiliary models…
(○) Leave unchanged
正确选择：按 向下箭头（↓） 翻到接近末尾，高亮选中 Custom endpoint (enter URL manually) 或 custom (direct API)（两者均可，前者更明确），然后按 回车。
⚠️ 注意：不要选择 OpenAI 或 OpenAI ▸，因为这些选项默认指向官方 OpenAI 服务，无法自定义 Base URL，会导致后续请求失败。
步骤 3：填写接入信息
选择后，系统会依次提示输入：
- Base URL：输入 https://api.siliconflow.cn/v1
- API Key：粘贴您的硅基流动 API Key（以 sk- 开头）
- Model name：输入您要使用的模型 ID，例如 deepseek-ai/DeepSeek-V4-Flash
步骤 4：确认保存
输入完成后，配置会自动写入 ~/.hermes/config.yaml 和 ~/.hermes/.env，无需额外操作。
4.3 方式三：手动编辑配置文件（高级）
配置文件位置：~/.hermes/config.yaml
编辑该文件，确保 model 部分配置如下：
model:
default: deepseek–ai/DeepSeek–V4–Flash
provider: custom
base_url: https://api.siliconflow.cn/v1
api_key_env: SILICONFLOW_API_KEY
API Key 存放于 ~/.hermes/.env：
SILICONFLOW_API_KEY=sk-你的真实密钥
五、验证配置
5.1 诊断检查
hermes doctor
检查是否存在配置问题，如有问题可按提示修复。
5.2 测试对话
hermes chat -q "你好，请用一句话介绍自己"
或进入交互式聊天：
hermes
成功时，终端底部会显示当前模型、token 用量和响应时间，确认硅基流动 API 已连接并正常工作。 
六、常见问题与排查
6.1 HTTP 401: “Api key is invalid”
原因：API Key 无效或未正确传递。
解决方案：
-H "Authorization: Bearer sk-你的密钥"
6.2 provider 错误
错误信息：Unknown provider 'openai-compatible'
原因：Hermes 不识别 openai-compatible 作为 provider 值。
解决方案：将 model.provider 改为 custom：
hermes config set model.provider custom
或通过 hermes model 重新选择 Custom endpoint。
6.3 模型名称错误（HTTP 404）
原因：模型 ID 与硅基流动模型库中的名称不一致。
解决方案：
6.4 网络连接问题
症状：超时或连接被重置。
解决方案：
七、常用命令速查
| hermes | 启动新聊天会话 |
| hermes "消息" | 单次消息发送 |
| hermes -c | 恢复上一次会话 |
| hermes model | 切换模型提供商（快速配置） |
| hermes config | 查看当前配置 |
| hermes config edit | 编辑配置文件 |
| hermes doctor | 诊断连接问题 |
| hermes update | 更新到最新版本 |
八、参考资源
- Hermes Agent 官方 GitHub：NousResearch/hermes-agent
- 硅基流动官网（推荐链接，含免费额度）：https://cloud.siliconflow.cn/i/BvcOKsRz
- 硅基流动邀请码：BvcOKsRz
- 硅基流动 API Key 管理：https://cloud.siliconflow.com/account/ak
- 硅基流动模型库：https://www.siliconflow.com/models
- 硅基流动 API 文档：https://docs.siliconflow.cn
