1、安装

• 管理员运行即可，一键安装
  
• 执行查看版本

Hermes --version

2、初始化配置

• 初始化配置

hermes setup

• 选择过程

1、1.Quick setup - provider, model & messaging (recommended)：快速配置
2、15. DeepSeek (DeepSeek-V3, R1, coder — direct API)：作者选择DeepSeek模型
3、Base URL [https://api.deepseek.com/v1]：如果是官方的，直接回车选择默认的就行，这个基础路径随着时间的变化很有可能被弃用了，一定要小心
4、Choice [1-6] (default: skip): 回车选择默认的4就行；标准的聊天模型，通用性较强。
5、7. Keep current (local)：回车选择默认的就行，只在本地使用
6、2. Skip — set up later with 'hermes setup gateway'：现在不配置消息通知平台
7、Launch hermes chat now? [Y/n]:回车选择默认的就行，进入聊天页面

常用命令

• 开启会话

hermes

• 查看版本

Hermes --version

• 配置模式

hermes model

# 当前会话生效
/model deepseek-chat

初始化配置截图

• 初始化配置

hermes setup

常见的错误

Hermes Agent 没有检测到有效的 API Key

• Hermes Agent 没有检测到有效的 API Key，导致无法连接任何大模型来回答你的问题。
  

HTTP 400 错误

• DeepSeek的Base URL 是 https://api.deepseek.com/v1，这个已经被弃用了，一直提示我参数格式错误，服了
• 解决方式：改为【https://api.deepseek.com】（20260616）
• 模型选择：deepseek-v4-flash （日常版）
• 错误截图
  

HTTP 402错误

• DeepSeek API 账户余额不足，无法支付本次请求的费用。
• 作者第一次注册也没实名就这样了
• 听说第一次实名有送50W（很少）的额度
  

参考文档

• Hermes Agent原生支持windows!无需魔法！无需WSL！离线安装包分享