最近折腾 Hermes Agent，折腾了快一周才在 Windows 上跑起来。网上中文资料基本没有，踩的坑不少，记下来给自己备忘，也省得别人再踩一遍。

这不是什么推荐文章，这东西装起来挺折腾的，你得自己决定要不要花这个时间。

Hermes 只能跑在 Linux 上，Windows 得先装 WSL2。我 C 盘只剩 20G，必须装到 D 盘。

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

跑完重启，不重启后面全报错，别问我怎么知道的。

重启之后，去微软官网搜 "wsl_update_x64.msi" 下载安装，然后：

不走 Microsoft Store，手动下载 rootfs 导入：

curl -L -o D:\WSL\ubuntu-22.04-root.tar.xz （Ubuntu 官网 WSL 页面有下载地址）

wsl --import Ubuntu D:\WSL\Ubuntu D:\WSL\ubuntu-22.04-root.tar.xz

默认进 root 不太好，建个日常账户：

国内不换源 apt 基本下不动东西。

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak

官方有个一键安装脚本，但 GitHub 在国内访问要命。得加镜像代理前缀才能下载，常用的代理有 

装的时候会自动拉 uv、Python、Node.js、Playwright 这些依赖，等就是了。

Playwright 下载 Chromium 那步特别慢，我当时以为卡死了差点 Ctrl+C，忍住了，最后还是下完了。

如果 command not found，试 ~/.local/bin/hermes，装完有时候 PATH 没刷新。

Hermes 没自带模型，得自己接 LLM API。用 hermes setup 交互式配置，按提示填 Provider、API Key、Base URL 和模型名。

如果 setup 过程报错，就手动改配置文件：

这里有个坑：如果 API Key 对应的模型额度用完了，会返回 403 错误。解决办法就是换一个还有额度的模型，或者检查 Key 是否正确。

Hermes 默认开了并行执行（Orchestrator），3 个 Agent 同时跑，Token 消耗直接 ×3。我第一天就把免费额度烧光了。

/config delegation.orchestrator_enabled false

默认 90 轮，太能聊了，30 轮够了。

日常简单问题切轻量模型，复杂问题再切回来，能省不少。

没重启就继续装 | 后面步骤全报错 | 重启电脑再来

WSL2 内核 msi 装不上 | 安装失败 | 先重启再装

GitHub 下载超时 | 卡住不动 | 加镜像代理前缀

hermes 命令找不到 | command not found | source ~/.bashrc 或用完整路径

模型返回 403 | HTTP 403 | 换个有额度的模型

setup 交互式失败 | 各种报错 | 手动编辑 config.yaml

免费额度一天烧光 | 并行任务 3 倍消耗 | 关 Orchestrator

Hermes Agent 的记忆系统和自动技能生成挺有意思，但装起来确实折腾，而且对免费用户来说 Token 消耗是最大的问题。如果你只是想体验一下，建议关掉并行执行、用轻量模型，省着点用。

本文纯个人踩坑记录，不保证适用所有环境，有问题的话评论区聊。

我在 Windows 上装 Hermes Agent 踩了一周的坑，记录一下

Windows安装HermesAgent详细教程：解决WSL2安装到D盘、换阿里云镜像源、GitHub下载加速、模型配置及Token消耗过快等问题。记录真实踩坑经验，包含WSL2内核安装、Ubuntu导入、用户创建、Hermes安装验证及API配置全流程，特别提醒注意免费额度消耗问题。

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

我在 Windows 上装 Hermes Agent 踩了一周的坑，记录一下

我在 Windows 上装 Hermes Agent 踩了一周的坑，记录一下

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐