Hermes 桌面版 · 接入公司 DeepSeek 网关（Windows）

网关地址https://llm.xiaokangai.cn/v1
备用 http://123.57.173.219/llm-gw/v1

桌面版下载https://llm.xiaokangai.cn/hermes-setup.exe
Windows 10/11 · 7.6 MB

API Key管理员发放，sk-dsgw- 开头，共 40 位

可用模型deepseek-v4-flash（默认）
deepseek-v4-flash-vision-exp（看图）

配置文件Windows 桌面版：%LOCALAPPDATA%\hermes\config.yaml
WSL / Linux 版：~/.hermes/config.yaml

1安装桌面版

没装过才需要，已经装了跳到第 2 步。

下载地址（公司镜像，秒下）：

下载链接

https://llm.xiaokangai.cn/hermes-setup.exe

Windows 10/11 · 7.6 MB · MD5 fad75c80123cdc036cd7dbc58bbae905（与官网同一文件）
官网原址（永远最新版）：https://hermes-agent.nousresearch.com/desktop

双击 Hermes-Setup.exe

不需要管理员权限，装在当前用户目录。

等它自己补齐依赖

首次启动会自动装 Python / Node / Git，约 3–10 分钟，右下角有进度，别中途关掉。

首次向导里选“稍后配置 provider”

相当于 Choose provider later，公司网关在第 2 步手动配更稳。

桌面版和命令行共用同一份数据和配置，都在 %LOCALAPPDATA%\hermes（= C:\Users\你的用户名\AppData\Local\hermes）。装完桌面版，PowerShell 里也能用 hermes 命令。

2写入网关配置

两条路，任选一条。改完都要完全重启桌面版。

方式一 · 手动改（最稳，推荐）

在文件资源管理器的地址栏粘贴 %LOCALAPPDATA%\hermes 回车，找到 config.yaml，用 VS Code 或记事本打开（保存为 UTF-8，缩进只用空格，不要用 Tab）。

情况 A：文件很长（2000 行左右，满是 # 注释）—— 大多数人都是这种

这是官方模板形态，不要重写、不要删注释，只改两处：

① 找到文件开头的 model: 段，让这几行指向网关：

model 段

model:
  default: "deepseek-v4-flash"
  provider: "llm-gw"
  base_url: "https://llm.xiaokangai.cn/v1"
  context_length: 1000000

② 在文件最末尾追加下面 4 行（providers: 顶格写，下一层缩进 2 空格）：

文件末尾追加

providers:
  llm-gw:
    base_url: "https://llm.xiaokangai.cn/v1"
    api_key: "sk-dsgw-你的Key"

只改 ① 不改 ② = 一定用不了。会报 agent failed: Unknown provider 'llm-gw' —— 因为 model 段只是“指定用谁”，② 才是“把 llm-gw 这个通道本身定义出来 + 带上密钥”。这是最常见的“配了没生效”。

情况 B：文件很短（几十行）或想同时挂多个模型

用 custom_providers 数组写法，三节分别到位（已有内容不要删）：

YAML

model:
  default: deepseek-v4-flash
  provider: llm-gw
  context_length: 1000000

providers:
  llm-gw: llm-gw

custom_providers:
  - name: llm-gw
    model: deepseek-v4-flash
    base_url: https://llm.xiaokangai.cn/v1
    api_key: sk-dsgw-你的Key
    models:
      - deepseek-v4-flash
      - deepseek-v4-flash-vision-exp

若原来写的是 model: ""，整行换成上面的 model 三行；若写的是 custom_providers: []，把 [] 换成上面的列表。
两种写法二选一，别同时写两套 llm-gw。

存盘前 10 秒自查

全文搜 model:、providers:、custom_providers: —— 每个只出现一次（出现两次就是重复定义，YAML 会报错）。
api_key 是完整的 sk-dsgw- 串，没被换行截断、没漏引号。
存成 UTF-8。改坏了就把同目录的 config.yaml.bak.* 覆盖回去。

方式二 · 一键脚本（不想碰配置文件就用这条）

按 Win + X → 终端 / Windows PowerShell，整段粘贴回车（把 Key 换成你自己的）：

PowerShell

$py  = "$env:LOCALAPPDATA\hermes\hermes-agent\venv\Scripts\python.exe"
irm https://llm.xiaokangai.cn/configure_hermes.py -OutFile "$env:TEMP\configure_hermes.py"
& $py "$env:TEMP\configure_hermes.py" sk-dsgw-你的Key

脚本会：自动定位配置目录 → 备份原配置 → 写入 llm-gw 通道与默认模型 → 域名/IP 双入口连通性与 Key 自检 → 真跑一次调用验证。

看到这行就是成功：

成功输出

   结果: provider=custom | model=deepseek-v4-flash | completed=True | failed=False
✅ 验证通过！流量已走公司网关 llm.xiaokangai.cn

脚本只对 Windows 原生版这么做（会自动认 %LOCALAPPDATA%\hermes）。如果它中途报错（网络不通、Key 无效、模型不允许），按报错提示处理；实在不顺就回到方式一手改那两处，一样能通。

3在桌面版里选中网关模型

配置只在新进程里读，重启这一步不能省。

完全退出 Hermes

右上角关窗口不够 —— 右下角托盘图标右键退出，或任务管理器里结束所有 Hermes.exe。

重新打开 Hermes

启动时会加载刚才的配置。

选模型

对话框输入框左下角的模型选择器 → 供应商 llm-gw → 模型 deepseek-v4-flash。

发一句话试试

能看到流式回复就通了。

命令行等价操作：hermes model 交互式选择，或直接跑一次 hermes -z "回复OK" -m deepseek-v4-flash --provider llm-gw。

4验证是否走通

30 秒，一条命令。

PowerShell

hermes -z "回复OK" -m deepseek-v4-flash --provider llm-gw

# 提示找不到 hermes 命令时用完整路径：
& "$env:LOCALAPPDATA\hermes\bin\hermes.exe" -z "回复OK" -m deepseek-v4-flash --provider llm-gw

回 OK 即通。

别问模型“你是什么模型”来判断。无论走不走网关，Hermes 都会自称 DeepSeek —— 这是系统提示词决定的，不是判据。看的是命令有没有报错。

查自己的用量

登录网关管理面板，看自己 Key 的请求数、Token、费用：
https://llm.xiaokangai.cn/admin/（管理令牌向管理员索取）

5常见问题

点开看对应解法。

报 Unknown provider 'llm-gw'

配置里只指定了用 llm-gw，但没定义这个通道。第 2 步的 ② 那一节没写（或写错缩进）。补上文件末尾的 providers: 4 行，重启桌面版。

报 401 Invalid API key

Key 复制不全或写错。回管理后台点复制完整 Key（sk-dsgw- 开头 40 位，页面显示是 **** 脱敏的，要点复制按钮）。

报 403 ... not enabled for this key

这个 Key 没开通你要用的模型（比如 pro）。找管理员在后台该 Key 上勾选模型权限。

报 429 或面板显示“超额”

Token 额度用尽（自动化批量任务很容易一两天烧完）。找管理员「加额度」，不用换 Key。

报 Model 'deepseek-flash' is not allowed

模型名写错。网关只放 deepseek-v4-flash、deepseek-v4-pro、deepseek-v4-flash-vision-exp 三个。把 deepseek-flash / deepseek-chat 改成 deepseek-v4-flash。

报错信息里出现 11m-gw

字母 l 打成了数字 1。正确写法是 llm-gw（两个小写 L）。

域名连不上 / 一直转圈

① 把 base_url 换成备用地址 http://123.57.173.219/llm-gw/v1；② 检查是否开着代理（关掉系统代理 / http_proxy 再试）；③ 换手机热点验证是不是公司网络拦截，是的话找 IT 放行 llm.xiaokangai.cn。

模型选择器里根本没有 llm-gw

① 改的是不是 %LOCALAPPDATA%\hermes\config.yaml（别改到安装目录里的示例文件 cli-config.yaml.example）；② 桌面版是否完全重启（托盘也退）；③ YAML 缩进/编码是否被编辑器改坏（用 hermes doctor 能看出配置解析问题）。

回复很慢

模型在“思考”或网络抖动。日常用 deepseek-v4-flash 最快；大批量任务避开 9–12 点、14–18 点高峰更省钱。

改完桌面版起不来了

把同目录下 config.yaml.bak.* 覆盖回 config.yaml（脚本和手动改都会留备份），或者直接改用第 2 步的方式二一键脚本。

6用起来更顺

模型权限按 Key 分配

默认开 deepseek-v4-flash 和 deepseek-v4-flash-vision-exp；要 deepseek-v4-pro 找管理员开通。

要看图 / 看截图

把模型切成 deepseek-v4-flash-vision-exp，能直接识别图片内容。

想把“思考”打开

网关默认关闭思考以省额度。确需开启，在 providers.llm-gw（或 custom_providers 的 llm-gw 条目）下加两行，重启桌面版生效。

YAML 片段

  extra_body:
    thinking: {type: enabled}
    reasoning_effort: high

额度与费用

按 Token 计费、计入 Key 的总限额；面板「使用看板」能看每日明细和费用。

7找管理员

需要什么	去哪里
申请 / 重置 API Key	网关首页在线申请 `https://llm.xiaokangai.cn/`
加额度、开模型权限、停用 Key	管理面板 `https://llm.xiaokangai.cn/admin/`
一键配置脚本	`https://llm.xiaokangai.cn/configure_hermes.py`
桌面版官方文档	`https://hermes-agent.nousresearch.com/docs/user-guide/desktop`

Hermes 桌面版接入公司 DeepSeek 网关