Hermes Agent WSL2 安装教程 应该从哪里开始？
建议先打开「打开教程地图」，按本页的步骤完成最小验证，再阅读相关排错和视频内容。
Topic guide
WSL2 专题怎么读
先读基础页，再进入问题排查和可复制模板，最后用免费资源包跑一次低风险场景。
- 01从教程地图确认学习阶段
- 02读相关问题排查和实战文章
- 03领取 Starter 包做一次可复现验证
这个专题适合谁
Hermes Agent WSL2 安装教程 适合正在安装、换系统、上 VPS 或排查命令环境的人。这个阶段最重要的是缩小问题范围，先让 CLI 在当前终端稳定工作。
读完后的验收标准
能在当前终端稳定启动 Hermes Agent，短问答和 setup 验收都有明确结果。
先检查这三件事
01确认当前 shell、系统环境和安装路径一致
02先跑 hermes setup、config check 或 doctor 这类验收命令
03把失败日志复制出来，再判断是依赖、PATH、Provider 还是权限问题
常见误区
在 WSL2、PowerShell、macOS 终端之间混用路径
没看日志就反复重装
CLI 还没跑通就直接接 Gateway 或定时任务
常见问题
WSL2 相关问题怎么判断是否已经解决？
能在当前终端稳定启动 Hermes Agent，短问答和 setup 验收都有明确结果。
读完 Hermes Agent WSL2 安装教程 后下一步做什么？
如果还没有真实场景，先下载免费 Starter 包，选择日报、Issue 分类或内容选题这类只读模板跑一次。
读完专题，建议做一次验证
只看教程不够。下载 Starter 包，选一个日报、Issue 分类或内容选题模板跑一次，确认输入、输出和日志都可复现。
{ install }
安装部署·更新 2026-05-31·10 分钟阅读
Hermes Agent 中文安装教程：macOS、Linux 与 WSL2
从零开始，覆盖三大主流环境的依赖安装、Python 版本选择与第一次启动的常见坑。
// guide
故障排查·更新 2026-05-19·9 分钟阅读
Hermes Agent 安装失败怎么排查：command not found、PATH、Python 和 API Key
安装 Hermes Agent 后打不开、命令找不到、setup 卡住或 Provider 配置失败时，按终端、PATH、依赖、API Key 和系统路线逐项恢复。
// guide
故障排查·更新 2026-05-19·7 分钟阅读
hermes command not found 怎么办：PATH、Shell 和 Windows WSL2 排查
终端提示 hermes: command not found 时，按安装环境、PATH、shell 配置和 Windows WSL2 路径逐步恢复。
{ install }
安装部署·更新 2026-05-19·10 分钟阅读
Hermes Agent Windows、Linux、macOS 安装补充：怎么选最稳路线
面向中文用户补充 Windows WSL2、Windows PowerShell Early Beta、Linux、macOS 的安装路线、命令和验收清单。