Windows系统配置 Hermes Agent 史上最详细教程（WSL版）

Windows 系统配置 Hermes Agent 史上最详细教程（WSL版）

为什么要看这篇教程？

Hermes Agent 是一个运行在终端里的 AI 助手，它可以帮你写代码、查资料、操作文件，相当于一个随时待命的程序员助理。

但是 Hermes Agent 是用 Python 写的，只能在 Linux 系统上运行。Windows 系统本身不支持直接运行，所以需要借助 WSL（Windows Subsystem for Linux）来创建一个 Linux 环境。

简单理解：WSL 就像在 Windows 系统里装了一个虚拟机，可以运行 Linux 系统和 Linux 软件。

第一步：启用 WSL

操作步骤

  1. 鼠标右键点击 开始菜单（左下角 Windows 图标）
  2. 选择 Windows PowerShell (管理员) 或 终端 (管理员)
  3. 弹出”用户账户控制”窗口，点 是
  4. 在打开的窗口里输入：
1
wsl --install

按回车后会看到什么？

系统会开始下载并安装 WSL2（新版，性能更好）。屏幕会显示类似这样的内容：

1
2
正在安装...
此操作完成后，需要重新启动系统。

注意：如果看到英文提示 “The operation completed successfully”，说明已经安装过了，跳过这步。

需要重启电脑吗？

需要！ 看到安装完成的提示后，重启你的电脑。不重启的话后续步骤会报错。

第二步：重启后首次启动 Ubuntu

重启后会看到什么？

电脑重启后，会自动弹出一个黑色窗口（Ubuntu 终端），显示：

1
2
3
Installing, this may take a few minutes...
Please create a default UNIX user account. The username does not need to match your Windows username.
What do you want to call this new user account?

怎么操作？

  1. 输入一个英文用户名（不能用中文、空格、特殊符号）

    • 例如：alex、john、mike、hermes

  2. 按 回车

  3. 系统会提示输入密码：

    1
    New password:

    输入你选择的密码（输入时不显示字符，是正常的）

  4. 再次输入密码确认：

    1
    Confirm password:

  5. 完成！看到类似这样的内容就成功了：

    1
    2
    3
    4
    5
    6
    Welcome to Ubuntu 22.04.3 LTS (GNU/Linux 5.15.146.0.1-microsoft-standard-WSL2 x86_64)
     * Documentation:  https://help.ubuntu.com/
     * Management:     https://landscape.casual.com/
     * Support:        https://ubuntu.com/advantage

    alex@LAPTOP-ABC123:~$

最后一行的 alex@LAPTOP-ABC123:~$ 叫命令提示符，前面是你的用户名，后面是电脑名，~ 表示当前在主目录。

第三步：更新系统（重要！）

为什么要更新？

新安装的 Ubuntu 系统里很多软件包都是旧版本，可能有安全漏洞或兼容性问题。更新后再安装其他软件会更顺利。

操作步骤

在终端（就是刚才的黑色窗口）里输入：

1
sudo apt update

按回车后会看到什么？

系统会让你输入密码验证身份。输入密码时不会显示任何字符，这是正常的，输入完按回车即可。

输入正确后会开始下载更新列表，屏幕滚动显示类似：

1
2
3
4
Hit:1 https://archive.ubuntu.com/ubuntu jammy InRelease [164 kB]
Hit:2 https://archive.ubuntu.com/ubuntu jammy-updates InRelease [164 kB]
...
Reading package lists... Done

看到 Done 说明更新完成了。

接着输入第二行命令

1
sudo apt upgrade -y

这行命令会真正更新软件包。屏幕会显示：

1
2
3
4
5
Reading state information... Done
XX packages can be upgraded.
The following packages will be upgraded:
  ...
Do you want to continue? [Y/n]

输入 Y 或直接按回车确认。

等待更新完成，大约需要 3-10 分钟，取决于网速。完成后会显示：

1
2
XX packages upgraded, YY packages newly installed, ZZ packages removed.
Setting up...

第四步：安装 Python

为什么要安装 Python？

Hermes Agent 是用 Python 写的，没有 Python 就无法运行。大部分新版 Ubuntu 已经预装了 Python，但最好确认一下。

检查是否已安装

在终端输入：

1
python3 --version

会看到什么？

如果已安装，显示类似：

1
Python 3.10.12

如果显示 command not found，说明没装，继续下一步。

安装 Python

1
sudo apt install python3 python3-pip -y

按回车后等待安装完成，看到 Setting up... 就成功了。

验证安装

再次输入：

1
python3 --version

应该显示版本号了。

第五步：安装 Hermes Agent

操作步骤

在终端输入：

1
pip3 install hermes-agent

按回车后会看到什么？

屏幕会显示正在下载和安装：

1
2
3
4
5
Collecting hermes-agent
  Downloading hermes_agent-1.2.3-py3-none-any.whl (XX kB)
Collecting ...
Installing collected packages: hermes-agent, xxx, xxx
Successfully installed hermes-agent-1.2.3 xxx-1.0.0

看到 Successfully installed 就说明安装成功了！

验证安装

1
hermes --version

应该显示版本号。

第六步：配置 API Key

什么是 API Key？

API Key 就像是一个密码，用于连接 AI 服务。没有有效的 API Key，Hermes Agent 无法连接到 AI 模型，也就无法回答问题。

获取 API Key 的方法：联系你的 AI 服务提供商（如河南移动的 Coding Plan、MiniMax 等），按指引获取。

操作步骤

1. 创建配置目录

1
mkdir -p ~/.hermes

这行命令会在主目录（~）下创建一个名为 .hermes 的文件夹。. 开头表示隐藏文件夹。

2. 创建配置文件

1
nano ~/.hermes/config.yaml

nano 是一个简单的文本编辑器，Windows 上类似记事本。

按回车后会看到什么？

编辑器界面，底部有一行快捷键提示。按键盘向下箭头移动到空白处。

3. 粘贴配置内容

把下面的内容复制粘贴进去（把 你的API密钥 换成你真正的密钥）：

1
2
3
4
5
model:
  default: minimax-m2.5
  provider: custom
  base_url: https://zhenze-huhehaote.cmecloud.cn/api/coding/v1
  api_key: 你的API密钥

注意：把 你的API密钥 那几个字替换成你获取到的真实密钥，不要留中文！

4. 保存并退出

按键盘：

  1. Ctrl + O （保存）
  2. 按 回车 确认文件名
  3. Ctrl + X （退出）

回到命令提示符就对了。

第七步：启动 Hermes Agent

操作步骤

在终端输入：

1
hermes

按回车后会看到什么？

第一次启动可能会：

  1. 显示一些初始化信息
  2. 尝试连接 AI 服务
  3. 连接成功后显示对话界面

类似：

1
2
3
4
5
6
Hermes Agent v1.2.3
Loading configuration...
Connecting to AI service...
Connected! (Model: minimax-m2.5)

You:

看到 You: 就说明成功了！可以在后面输入你的问题。

如果显示错误？

常见错误及解决方法：

错误信息 原因 解决方法
API key is invalid API Key 错误 检查 config.yaml 里的 api_key 是否正确
Connection timed out 网络超时 检查网络，或配置代理（见下文）
command not found 没安装成功 重新运行 pip3 install hermes-agent

第八步：配置代理（如果需要）

为什么要配置代理？

中国大陆直接访问部分 AI 服务可能会被拦截或速度很慢。如果遇到连接问题，需要配置代理。

操作步骤

1
nano ~/.bashrc

在文件最末尾添加一行（按 Ctrl + End 跳到末尾）：

1
export all_proxy="socks5://127.0.0.1:10808"

这里的 127.0.0.1:10808 是代理地址，你需要改成你实际的代理地址。

保存退出（Ctrl + O，回车，Ctrl + X）。

然后让配置生效：

1
source ~/.bashrc

常见问题汇总

Q1: 每次使用都要重新打开 WSL 吗？

是的。关闭终端后 WSL 会停止，下次使用再打开 Ubuntu 即可。

Q2: 怎么打开 WSL/Ubuntu？

方法一：在开始菜单搜索 “Ubuntu”
方法二：打开 PowerShell，输入 wsl 直接进入

Q3: 输入密码时看不到字符正常吗？

正常，为了安全设计的。输入完按回车即可。

Q4: 安装太慢怎么办？

换清华源（步骤见上文”第四步”部分）

Q5: 想卸载 WSL 怎么办？

在 PowerShell 中运行：

1
wsl --unregister Ubuntu

Q6: 可以同时开多个终端吗？

可以，开多少个都行，互不影响。

完整操作流程回顾

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
# 1. 以管理员打开 PowerShell
wsl --install

# 2. 重启电脑

# 3. 设置用户名密码（首次启动）

# 4. 更新系统
sudo apt update
sudo apt upgrade -y

# 5. 安装 Python（如果需要）
sudo apt install python3 python3-pip -y

# 6. 安装 Hermes Agent
pip3 install hermes-agent

# 7. 配置
mkdir -p ~/.hermes
nano ~/.hermes/config.yaml
# 粘贴配置，保存退出

# 8. 启动
hermes

祝你在 Herme Agent 的世界里玩得开心！有问题随时问我！