Hermes Agent Windows 安装与火山引擎接入指南

（适配 Windows 10/11，含全流程排错方案）

---

一、准备工作

1. 系统与软件要求

• 操作系统：Windows 10 / Windows 11

• 必须安装工具：

  • Python 3.11+（安装时务必勾选「Add Python to PATH」）

  • Git（默认安装即可，用于拉取源码）

• 提前准备：火山引擎 Coding Plan API Key

---

二、分步安装流程

步骤1：拉取源码

打开 CMD / PowerShell，执行以下命令：

git clone https://github.com/NousResearch/Hermes-Agent
cd Hermes-Agent

步骤2：创建并激活虚拟环境

python -m venv venv
venv\Scripts\activate

成功标志：命令行前缀出现 (venv)，代表已进入隔离环境。

步骤3：安装依赖与项目本体

pip install -r requirements.txt
pip install -e .

步骤4：首次启动（跳过向导配置）

执行命令：

hermes chat

出现配置向导时，全部选择「跳过」：

• 输入 n 回车，跳过 OpenClaw 导入

• 选择 Skip，跳过消息平台配置

• 不登录任何官方账号（OpenAI / Nous 等）

---

三、配置火山引擎 Coding Plan

步骤1：定位配置文件目录

在资源管理器地址栏输入：

C:\Users\你的用户名\.hermes

若 .hermes 文件夹不存在，手动新建即可（注意文件夹名前的点号）。

步骤2：创建/修改 config.yaml 文件

1. 在 .hermes 文件夹中，新建文本文档，并重命名为 config.yaml（删除 .txt 后缀）

2. 用记事本打开文件，粘贴以下内容，替换为你的真实信息：

model:
  provider: custom
  base_url: https://ark.cn-beijing.volces.com/api/coding/v3
  api_key: 你的火山引擎Coding_Plan_API_Key
  model: ark-code-latest
  api_type: openai
​
providers: {}
fallback_providers: []
credential_pool_strategies: {}
toolsets:
  - hermes-cli
​
agent:
  max_turns: 90
  gateway_timeout: 1800
  restart_drain_timeout: 60
  service_tier: ''
  tool_use_enforcement: auto
  gateway_timeout_warning: 900
  gateway_notify_interval: 600
​
terminal:
  backend: local
  modal_mode: auto

步骤3：验证配置

回到终端，执行：

hermes doctor

只要无红色报错，即代表配置成功。

步骤4：启动对话

hermes chat

输入测试指令，验证模型响应：

帮我写一段 Python 代码，实现批量读取 Excel 并生成汇总表。

---

四、日常使用流程

每次新打开终端，需执行以下步骤：

# 1. 进入项目目录
cd /d "你的Hermes-Agent路径"
​
# 2. 激活虚拟环境
venv\Scripts\activate
​
# 3. 启动对话
hermes chat

---

五、常见问题与解决方案

错误现象	根因	解决方法
irm 不是内部或外部命令	旧版 PowerShell 不支持 irm	放弃脚本安装，改用手动 git clone
No such file or directory: hermes.py	官方入口非 hermes.py	使用 python -m hermes chat 启动
No module named hermes	未安装项目本体	执行 pip install -e .
hermes 不是内部命令	未激活虚拟环境	先运行 venv\Scripts\activate
Unknown provider 'openai'	Windows 不识别官方 provider	修改 config.yaml，使用 provider: custom
No API key found	配置文件路径/格式错误	检查 C:\Users\用户名\.hermes\config.yaml

---

六、附：配置文件模板（直接使用）

可直接复制到 config.yaml，替换 API Key 即可：

model:
  provider: custom
  base_url: https://ark.cn-beijing.volces.com/api/coding/v3
  api_key: 你的API_KEY
  model: ark-code-latest
  api_type: openai