Hermes Agent 安装教程（Windows）

Windows 上推荐在 WSL2 里安装和运行 Hermes Agent，体验最好。如果你只想在 PowerShell 里操作，下面也提供了原生方案。

方案 A：WSL2（推荐）

1. 先安装 WSL2 并进入 Linux 子系统
2. 在 WSL2 里按 Linux 教程做：

Hermes Agent Linux

方案 B：PowerShell 原生安装

0. 前置：安装 Python

从官网下载安装包：https://www.python.org/downloads/

安装时勾选 Add Python to PATH。

验证安装：

python --version
pip --version

1. 安装 Hermes Agent

推荐方式：pipx

pip install pipx
pipx ensurepath

重新打开 PowerShell 后，执行：

pipx install hermes-agent

备选方式：pip

pip install hermes-agent

验证安装：

hermes --version

2. 配置 Hermes（接入闪电API）

2.1 创建配置目录

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.hermes"

2.2 写入配置文件

根据你要使用的模型类型，选择下面其中一种写法。

Claude / Anthropic（不带 /v1）：

@'
models:
  default: flashapi-claude/claude-opus-4-6

providers:
  flashapi-claude:
    type: anthropic
    base_url: https://ai.flashapi.top
    api_key: 你的闪电API Key
    api_key_env: ANTHROPIC_API_KEY
    default_model: claude-opus-4-6
    models:
      - claude-opus-4-6
'@ | Set-Content -Path "$env:USERPROFILE\.hermes\config.yaml" -Encoding UTF8

GPT / OpenAI（必须带 /v1）：

@'
models:
  default: flashapi-codex/gpt-5.5

providers:
  flashapi-codex:
    type: openai
    base_url: https://ai.flashapi.top/v1
    api_key: 你的闪电API Key
    api_key_env: OPENAI_API_KEY
    default_model: gpt-5.5
    models:
      - gpt-5.5
'@ | Set-Content -Path "$env:USERPROFILE\.hermes\config.yaml" -Encoding UTF8

必须替换：把 你的闪电API Key 替换成你从闪电API官网复制的真实 Key。

2.3 验证配置文件

Get-Content "$env:USERPROFILE\.hermes\config.yaml"

3. 启动并验证

hermes

常见问题

1. 提示找不到 hermes 命令

原因：pipx 安装路径没有加到 PATH。

解决方法：

pipx ensurepath

然后重新打开 PowerShell。

2. API 调用失败

1. 检查配置文件内容
2. 确认 API Key 正确，令牌分组已创建
3. 确认 Claude 接口不带 /v1，GPT 接口带 /v1