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文件在.hermes文件夹中新建文本文档并重命名为config.yaml删除.txt后缀用记事本打开文件粘贴以下内容替换为你的真实信息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 cloneNo such file or directory: hermes.py官方入口非hermes.py使用python -m hermes chat启动No module named hermes未安装项目本体执行pip install -e .hermes 不是内部命令未激活虚拟环境先运行venv\Scripts\activateUnknown provider openaiWindows 不识别官方 provider修改config.yaml使用provider: customNo 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