安装hermes
2026-05-02
我先查一下 Hermes Agent 当前 Windows 安装的官方步骤——之前你做过 Hermes 的 PDF 文档，但安装脚本可能已经更新过，确认一下最新版本最稳妥。Hermes Agent 不支持原生 Windows，必须通过 WSL2 安装 Linux 子系统再装。这是官方明确的限制。下面是 Win11 完整步骤，按顺序走即可。
第一步：装 WSL2
以管理员身份打开 PowerShell，执行：
wsl --install
这一条命令会自动启用虚拟化、安装 WSL2 内核、并默认装上 Ubuntu。完成后重启电脑。
重启后 Ubuntu 会自动启动，提示你设置 Linux 用户名和密码（密码输入时屏幕不显示字符是正常的）。这个密码和 Windows 登录密码无关，但要记住——后面 sudo 要用。
如果想指定版本（推荐 22.04，社区兼容性最好）：
wsl --install -d Ubuntu-22.04 wsl --set-default-version 2
验证：wsl -l -v 看到 VERSION 2 就对了。
第二步：进入 Ubuntu，准备环境
打开"开始菜单"找 Ubuntu 启动，进入 Linux 终端。先更新一下系统并装 Git（唯一需要手动装的依赖）：
sudo apt update sudo apt install -y git curl git --version # 验证
第三步：一键安装 Hermes
国内网络环境推荐用 ghfast.top 加速版（官网首页给的就是这个）：
curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
国际网络畅通的话用原版：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
这一步会自动装好 uv、Python 3.11、Node.js v22、ripgrep、ffmpeg、克隆代码、建虚拟环境、注册全局 hermes 命令。整个过程约 60 秒（网络好的话）。
如果卡住没反应，多半是 GitHub 或 PyPI 连不通。两个常用救急方案：
# 换清华源（解决 PyPI 慢）
export UV_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple/
# 配 WSL2 的代理（如果你 Windows 上有 Clash/V2Ray 之类）
host_ip=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}')
export http_proxy="http://${host_ip}:7890"
export https_proxy="http://${host_ip}:7890"
# 注意：Windows 端代理软件要开启"允许局域网连接"（Allow LAN）然后重新跑安装脚本。
第四步：让 hermes 命令生效
source ~/.bashrc hermes --version
能看到版本号（当前是 v0.8.0/v0.8.1）就说明装好了。
第五步：跑诊断 + 配模型
hermes doctor # 检查所有依赖是否到位 hermes setup # 交互式向导，配 LLM 提供商
hermes setup 会让你选模型提供商。常用选择：
如果之前用过 OpenClaw：向导会问要不要导入配置，直接选 y，API Key 全自动迁移过来
国内环境：选
More providers→Custom endpoint，填阿里百炼 / 智谱 / Kimi 的 endpoint 和 key百炼 Coding Plan：endpoint 填
https://open.bigmodel.cn/api/coding/paas/v4
配完直接：
hermes
进入交互式终端就能开始对话了。
后续配置（按需）
hermes model # 切换模型 hermes tools # 启用/禁用工具 hermes gateway setup # 接入微信/飞书/钉钉/企业微信
培训现场常见的几个坑
如果你是给 SINOROAD 培训学员用，提前提醒这几点能省一半答疑时间：
第一，不要在 PowerShell/CMD 里直接跑安装脚本——必须先 wsl 进入 Ubuntu 再跑。学员经常忘这步。
第二，WSL2 里不要用 sudo 跑 hermes。安装时不需要 sudo，运行时也不需要。用 sudo 会导致权限混乱、配置文件读不到。
第三,WSL2 的家目录是 Linux 文件系统，不在 C:\Users\xxx 下。配置文件在 ~/.hermes/，对应 Windows 路径是 \\wsl$\Ubuntu\home\<你的用户名>\.hermes\，可以从 Windows 资源管理器直接打开看。
第四，如果学员电脑没开虚拟化（VT-x/AMD-V），WSL2 会装不上，需要进 BIOS 开启。这个最好提前在培训通知里写明。
第五,飞书/钉钉网关推荐用 WebSocket 模式，不需要公网 IP，家用网络也能用。微信用的是 iLink Bot API，原生支持，扫码登录即可。
需要我整理成一份学员可以照着拷贝的 Word 或 PDF 操作手册吗？或者把它写成 Markdown 直接发到 SINOROAD 的培训群里？
发表评论: