Hermes Agent 完整配置教程：从零配置到可用详细步骤

装了 Hermes Agent 之后怎么配置才能用？本文详细介绍从安装到可用的完整配置流程，适合完全零基础的小白。

配置流程概览

整体流程分 4 步：

1. 安装 Hermes Agent（参考安装教程）
2. 申请 API 密钥
3. 填写配置文件
4. 启动并验证

第一步：申请 API 密钥

API 密钥就像是你使用 AI 服务的”账号密码”。先申请一个，有免费额度可以用。

推荐 MiniMax（国内直接用）

1. 打开 https://platform.minimaxi.com
2. 用手机号注册账号
3. 登录后进入「控制台」
4. 左侧菜单找到「API 密钥」
5. 点击「创建密钥」
6. 复制生成的密钥（一串字母数字）

新用户有免费额度，日常使用几十块钱一个月够用。

备选：DeepSeek

1. 打开 https://platform.deepseek.com
2. 注册并登录
3. 进入「API Keys」创建密钥
4. 复制密钥

第二步：编辑配置文件

# 打开配置文件（Linux/macOS/WSL2）
nano ~/.hermes/config.yaml

# Windows WSL2 方式：
# 先进入 WSL：wsl -d Ubuntu
# 再运行：nano ~/.hermes/config.yaml

把内容替换成：

provider: minimax-cn
model: MiniMax-M2.7-highspeed
api_key: 你刚才复制的密钥
base_url: https://api.minimaxi.com/v1

# 显示设置
display:
  skin: default
  show_thinking: true
  color: true

# 工具设置
tools:
  enabled:
    - terminal
    - file
    - web
    - delegate
  disabled: []

# Skill 设置
skills:
  auto_load: true
  search_path:
    - ~/.hermes/skills

按 Ctrl+O 保存，Ctrl+X 退出。

第三步：验证配置

# 在终端运行：
hermes doctor

如果看到类似下面的输出，说明配置正确：

[✓] Python version: 3.11.15
[✓] Dependencies installed
[✓] Config file loaded
[✓] API connection: OK
[✓] Model: MiniMax-M2.7-highspeed
[✓] All checks passed

如果有问题，hermes doctor 会告诉你哪里出错，按提示修复即可。

第四步：启动

# 在终端输入：
hermes

# 看到欢迎界面就是成功了
# 现在可以输入你想让 AI 做的事

快速测试一下

启动后输入下面的话测试是否正常工作：

你好，帮我算一下 123+456 等于多少？

如果 AI 返回了计算结果，说明完全正常，可以开始使用了。

配置出错了怎么办

如果 hermes doctor 报红色错误：

• 401 Unauthorized：API Key 填错了，重新复制
• Connection refused：base_url 填错了或网络不通
• Config not found：配置文件没创建好，重跑 hermes setup

# 重置配置，重新来过
rm ~/.hermes/config.yaml
hermes setup

切换到 DeepSeek

如果想用 DeepSeek 模型：

# config.yaml 改为：
provider: deepseek
model: deepseek-chat
api_key: 你的DeepSeek密钥
base_url: https://api.deepseek.com/v1

常见问题

Q：hermes doctor 显示 Key 无效？
确认复制的内容完整没有多余空格，或者去控制台重新生成一个 Key。

Q：配置好了但启动后没反应？
试 hermes --verbose 启动，看详细日志报错什么。

Q：怎么确认用的是哪个模型？
在 Hermes 里输入 /model 可以查看当前使用的模型。