让 AI 帮你安装 Hermes Agent：小白避坑指南

用户6211380713559
0 阅读6分钟

目标：零代码基础，通过和 AI 对话完成 Hermes Agent 安装
适用工具：Trae、Cursor、Claude Code 等 AI 编程助手
预计时间：30 分钟

一、你需要准备什么

  • 一台 Windows 10/11 电脑
  • 一个 AI 编程助手（Trae / Cursor / Claude Code 等）
  • 至少一个国产 LLM 的 API Key（GLM / Kimi / MiniMax 任选）

就这些。不需要懂 Linux，不需要会写代码。

二、第一步：让 AI 帮你装 WSL

打开你的 AI 助手，发送以下 Prompt：

请帮我在 Windows 上安装 WSL2，用于运行 Linux 环境。
请一步步告诉我该做什么，每步完成后我会告诉你再继续。

AI 会告诉你：

  1. 以管理员身份打开 PowerShell
  2. 运行 wsl --install
  3. 等待安装完成

⚠️ 第一个坑来了：

安装完成后，会弹出一个窗口让你创建用户名。千万不要输入纯数字（比如你的 QQ 号、工号），Linux 用户名必须以字母开头。

推荐用户名：user + 你的数字，例如 user66

三、第二步：让 AI 安装 Hermes

WSL 设置完成后，回到 AI 助手，发送：

现在帮我安装 Hermes Agent。
安装地址：https://hermes-agent.nousresearch.com/docs/getting-started/installation

要求：
1. 安装到 WSL 的 Ubuntu 环境中
2. 使用国内镜像源加速下载（阿里云 pypi 镜像）
3. 使用我当前登录的 WSL 用户，不要用 root
4. 每步完成后告诉我，我会反馈结果再继续

请先帮我检查 WSL 是否可用，然后再开始安装。

这个 Prompt 的关键点：

  • 指定了安装地址，AI 会去读取官方文档
  • 要求使用国内镜像源，避免下载超时
  • 强调不要用 root，这是最大的坑（后面会解释）
  • 要求分步进行，方便你及时反馈

四、常见踩坑及应对 Prompt

坑 1：AI 用 root 用户安装了

现象：安装成功了，但你一运行 hermes 就报错。

原因：WSL 安装脚本默认以 root 身份执行，但你日常登录的是普通用户。root 装的东西，普通用户用不了。

修复 Prompt：

安装过程中使用了 root 用户，但我日常登录的是普通用户（用户名是 XXX）。
请帮我把 Hermes 的所有文件复制到我的用户目录下，并重新创建虚拟环境，
确保我可以用自己的用户运行 hermes 命令。

坑 2：下载 Python 依赖超时

现象：安装卡在 Preparing packages... 不动。

修复 Prompt：

下载 Python 依赖超时了。请改用阿里云镜像源：
export UV_INDEX_URL=https://mirrors.aliyun.com/pypi/simple/
export UV_HTTP_TIMEOUT=300
然后重新安装。

坑 3：hermes 命令找不到

现象：输入 hermes 提示命令不存在。

修复 Prompt：

hermes 命令找不到，请帮我：
1. 检查 hermes 可执行文件是否存在
2. 创建软链接到 ~/.local/bin/
3. 确保 PATH 环境变量包含了 ~/.local/bin

坑 4：权限不够 Permission denied

现象：运行 hermes 报 bad interpreter: Permission denied。

原因：虚拟环境中的 Python 解释器路径指向了其他用户的目录。

修复 Prompt：

运行 hermes 报 Permission denied，虚拟环境的 Python 路径不对。
请帮我为当前用户重新创建虚拟环境（venv），并重新安装所有依赖。
使用国内镜像源加速。

坑 5：PowerShell 里 hermes 不识别

现象：在 Windows 终端输入 hermes 报错。

原因：hermes 装在 WSL（Linux）里，Windows 不认识。

正确做法：

# 先进入 WSL
wsl

# 再运行 hermes
hermes

或者一行搞定：

wsl hermes

五、配置你的 API Key

安装完成后，让 AI 帮你配置：

现在帮我配置 Hermes Agent 的 API Key。
我已经安装了 WSL，用户名是 XXX。

我有的 API Key：
- GLM（智谱）：xxx
- Kimi（月之暗面）：xxx
- MiniMax：xxx

请帮我：
1. 写入到 ~/.hermes/.env 配置文件
2. 配置正确的 Base URL
3. 用 hermes model 命令切换到我想用的模型
4. 验证配置是否生效

六、启动 Hermes

配置完成后：

请帮我启动 Hermes Agent，并验证它能否正常对话。

AI 会告诉你运行 hermes，然后在 ❯ 提示符后输入消息即可开始对话。

七、完整的一键 Prompt（进阶）

如果你对 AI 比较信任，也可以直接发这个长 Prompt：

请帮我在 Windows WSL 环境中安装并配置 Hermes Agent。

环境信息：
- 系统：Windows 11
- WSL 发行版：Ubuntu
- 当前 WSL 用户名：user66

安装要求：
1. 从官方地址安装：https://hermes-agent.nousresearch.com/docs/getting-started/installation
2. 必须使用当前 WSL 用户（user66），不要用 root
3. 使用阿里云 PyPI 镜像加速：https://mirrors.aliyun.com/pypi/simple/
4. 超时时间设为 300 秒
5. 跳过 npm install（我不需要 WhatsApp 功能）
6. 安装完成后创建 hermes 命令的软链接
7. 配置 PATH 到 .bashrc
8. 每步执行后输出结果，方便我确认

安装完成后，帮我配置以下 API Key：
- KIMI_API_KEY=xxx（Base URL: https://api.moonshot.cn/v1）
- 并切换到 kimi-k2.5 模型

最后运行 hermes version 验证安装是否成功。

八、总结：和 AI 协作的三个原则

  1. 分步进行：不要让 AI 一口气执行所有命令，每一步都确认
  2. 明确用户身份：反复强调"使用当前用户，不要用 root"
  3. 及时反馈：遇到问题把完整的报错信息发给 AI，不要只说"不行"

记住：你不是在学 Linux，你是在指挥 AI 干活。

写在最后：为什么要使用当前用户

因为我在安装过程中真实遇到了这个问题，修复它浪费了至少 30 分钟 。具体原因如下：

  1. 安装位置错位

用 root 安装后，所有文件都放在 root 的目录下： 在这里插入图片描述

你登录 WSL 的默认用户是 user66 （非 root），所以这些文件你都碰不到。

  1. Python 路径写死了 这是最坑的一点。虚拟环境创建时，Python 解释器的路径被 硬编码 了：
/home/user66/.hermes/hermes-agent/venv/bin/
python 
  → /root/.local/share/uv/python/cpython-3.11.../
  bin/python3.11

这个符号链接指向 root 的目录。即使你把文件复制过来，hermes 启动时去找 Python，找到的还是 root 的路径，直接报：

bad interpreter: Permission denied

3. 修复成本极高 我当时花了几十步才修好：

  • 复制 .hermes 目录 → 改所有权 → 发现 venv 路径不对
  • 删除整个 venv → 重新安装 uv → 重建虚拟环境 → 重新装 180 个包
  • 修复 hermes 脚本的 shebang → 重新创建软链接
  1. 本质问题 WSL 的日常使用用户 ≠ 安装时使用的用户 。

Hermes 官方安装脚本默认以 root 执行（因为 curl | bash 在 root 下运行），但你创建 WSL 用户后，系统默认登录的是普通用户。这是 Linux 的权限隔离机制，无法绕过。

所以结论

在安装时强调"使用当前用户，不要用 root"，就是为了让 AI 从一开始就把所有东西装在正确的地方，避免后面的一系列权限地狱。

avatar
文章
阅读
粉丝