Hermes Agent 接入 DeepSeek 保姆级教程【高性价比】

DeepSeek-V4-Flash是当前接入Hermes Agent的高性价比选择；操作路径包括获取API Key、安装Hermes Agent、配置模型（交互式或命令行）、验证响应与模型身份，全程无需服务器经验。

想让 Hermes Agent 用上 DeepSeek 模型，又不想花大价钱买 GPT-4 或 Claude 的 API 配额？DeepSeek-V4-Flash 响应快、价格低、中文强，是当前最值得接入的高性价比选择。本文只讲能立刻跑通的操作路径，不绕弯、不堆术语、不假设你有服务器经验。

获取 DeepSeek API Key

打开 DeepSeek 开放平台，注册账号并登录 → 进入「API Keys」页面 → 点击「Create API Key」→ 复制生成的 key（仅显示一次，务必立即保存）。

安装 Hermes Agent（Windows/macOS/Linux 通用）

终端执行一行命令即可完成安装：

curl -fsSL https://hermes-agent.org/install.sh | bash

安装过程自动检测系统、安装 uv、下载核心包、初始化 ~/.hermes/ 目录。若国内网络不稳定，可先用浏览器访问该脚本地址，保存为 install.sh 后本地执行：bash install.sh。

配置 DeepSeek-V4-Flash 模型

方法一：交互式向导（推荐新手）
执行 hermes setup → 选择 Provider：DeepSeek → 粘贴刚复制的 API Key → 模型名填 deepseek-v4-flash → Base URL 填 https://api.deepseek.com/v1。

方法二：直接用命令行写入配置（更适合复现流程，或者顺手做成脚本）
hermes config set model deepseek-v4-flash
hermes config set api.base_url https://api.deepseek.com/v1
hermes config set DEEPSEEK_API_KEY sk-xxxxxx（系统会自动写入 ~/.hermes/.env）

⚠️ 注意：模型名必须全小写、用短横线连接，deepseek-v4-flash 正确，DeepSeek-V4-Flash 或 deepseek_v4_flash 会导致 404 错误。

验证是否接入成功

第一步：启动本地对话终端
执行 hermes chat，输入任意一句话，例如「你好，你是谁？」

第二步：观察响应内容与速度
若 2～5 秒内返回结构清晰、带思考步骤的中文回复，且末尾未出现「Authentication failed」「Model not found」等报错，说明 DeepSeek-V4-Flash 已生效。

第三步：确认模型身份（这是关键校验）
最直接的做法，就是当场问一句：「你现在用的是哪个模型？」正常情况下，回复里应该明确带有 deepseek-v4-flash 这个字样。要是它回答成「我是一个 AI 助手」或者「基于 OpenAI 接口」，那基本就能判断当前配置还没真正生效。这时候别急着继续往下走，先检查一下 hermes config show 的输出，重点看 model 和 api.base_url 这两项是不是一一对应、彼此匹配。