Windows 小白零基础安装 Hermes Agent 傻瓜级教学：即使你什么都不会，我也给你教会

昨天写了篇 Hermes 的教程，结果被朋友怼了，他说“你这不够保姆啊，有些人连终端都不会打开” 我一想，还真是——我自己刚接触这些东西的时候，连那个黑窗口是啥都搞不明白，到处搜“怎么打开终端”

所以今天这篇，我把它写成真正零基础的，哪怕你从没碰过命令行，也能一步不落地把 Hermes Agent 装上

这篇教程专供 Windows 用户，如果你是 Mac 或者 Linux，可以看我

话不多说

第一步：先看看你的电脑能不能装

Hermes Agent 要跑在 WSL2 上，说简单点就是微软官方允许你在 Windows 里开一块地方跑 Linux，不用装双系统，也不影响你正常用电脑

你不用理解它是什么，只需要确认一件事——你的 Windows 版本够不够新

操作（跟着做就行）：

同时按下键盘上的 Win 键（键盘左下角那个四个小方块的图标）和 R 键
弹出一个叫“运行”的小窗口，在里面输入 winver，然后按回车
屏幕上会跳出“关于 Windows”的窗口。找到“版本”那一行，看看数字

要求：版本号需要是 2004 或更高（比如 20H2、21H1、21H2、22H2），或者你用的是 Windows 11

如果版本不够新，先去“设置 → Windows 更新”里更新一下系统，再回来继续

第二步：一键安装 WSL2（全程只需复制粘贴）

操作：

在键盘上同时按 Win 键 + X 键，会弹出一个菜单用鼠标点击 “Windows PowerShell（管理员）” 或者 “终端（管理员）” 这一项（⚠️ 一定要选带“管理员”三个字的那个，否则后面可能装不上）
会弹出一个黑色的窗口，里面有很多字，这就是“终端”了别害怕，你只需要在里面输入一行命令
把下面这行字原封不动地复制，然后在黑色窗口里单击鼠标右键粘贴进去（或者按 Ctrl + V）：

plaintext

wsl --install

3. 按一下键盘上的回车键（Enter）

4. 接下来你会看到窗口里开始自动下载东西。什么都不用动，让它自己跑完这个过程大概需要 5 到 15 分钟，取决于你的网速

5. 安装完成后，终端会提示你重启电脑，照做，把电脑重新启动一下

第三步：重启之后，装上 Ubuntu

点击电脑左下角的 “开始”菜单,在程序列表里找这个图标“Ubuntu” ，如果有就点击打开，看下一步；如果没有就继续这一步

我发现有朋友反馈，装完 WSL2 后在开始菜单里找不到 Ubuntu，有的却是找得到

这很正常，没有的手动安装一下就好了

方法一：一条命令搞定

重启后，再次 Win + X，选择 “Windows PowerShell（管理员）”
复制粘贴下面这条命令，回车：

plaintext

wsl --install -d Ubuntu

等待下载安装完成，这次你一定能看到进度条在跑装好之后，开始菜单里就会出现 Ubuntu 的图标了

方法二：去“应用商店”里下载

如果你实在不想再敲命令了，也可以这样：

打开电脑自带的 Microsoft Store（微软应用商店）。
右上角搜索 Ubuntu
选一个版本（比如 Ubuntu 24.04 LTS），点击 “获取” 或 “安装”
装好后，同样可以在开始菜单找到它

验证一下是否装好

再次打开管理员权限的终端，输入：

plaintext

wsl -l -v

如果看到 Ubuntu 的名字，并且版本号（VERSION）是 2，就说明一切准备就绪了

小插曲：如果试了上面的方法还是找不到 Ubuntu，去 “控制面板 → 程序 → 启用或关闭 Windows 功能”，确认 “适用于 Linux 的 Windows 子系统” 和 “虚拟机平台” 前面都打了勾没有的话勾上，确定后重启电脑，再重试一次

第四步：进入 Ubuntu

从开始菜单点击打开 Ubuntu
第一次打开会显示 Installing, this may take a few minutes…，耐心等它初始化完成
接着它会问你：Enter new UNIX username: —— 这是在让你起一个名字输入一个你喜欢的英文小写名字，比如 suu，然后回车（只能小写字母）
然后它会让你设一个密码：New password: ⚠️ 提醒：输入密码的时候，屏幕上什么都不会显示这不是你的键盘坏了，也不是系统卡了，这是 Linux 的安全设计放心地把密码敲完，然后按回车
它会让你再输一遍确认，同样看不到任何字符，敲完回车即可

完成之后，你会看到类似 suu@DESKTOP:~$ 这样的提示符，意味着你已经成功进入了这个属于你的 Linux 小世界

请一定记住你刚才设置的用户名和密码

第五步：安装 Hermes Agent

现在 Ubuntu 系统已经准备好了，我们要在它里面安装 Hermes Agent

下面的每一步都在 Ubuntu 里操作

安装 Git（一个必备的小工具）

Hermes Agent 的安装需要用到 Git，Ubuntu 默认没有装，我们手动装一下

在 Ubuntu 窗口里依次输入以下两行命令（每输完一行就按一下回车）：

plaintext


sudo apt update

然后输入：

plaintext

sudo apt install git -y

💡 第一条命令如果让你输密码，输入你刚才在第三步设置的密码就行（同样不会显示任何字符）

等它跑完就行，一般几秒钟

运行 Hermes Agent 一键安装脚本

接下来就是最核心的一步了

把下面这行命令完整复制，在 Ubuntu 窗口里右键粘贴，然后按回车：

plaintext

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

💡 如果提示“curl: command not found”，说明缺少 curl 工具先输入 sudo apt install curl -y 安装一下，再重新运行上面的命令

这条命令会启动官方安装脚本

脚本会自动检测你缺什么，然后帮你装好 Python、Node.js、ffmpeg 等所有需要的工具

整个过程大约 3 到 5 分钟，耐心看着屏幕上的日志就行，不用做任何操作

刷新一下环境变量

安装完成后，在 Ubuntu 窗口里输入：

plaintext

source ~/.bashrc

然后按回车，这一步让系统“认出”刚刚装好的 Hermes 命令

第六步：验证安装（确认一切顺利）

在 Ubuntu 窗口里输入：

plaintext

hermes doctor

按回车后，你会看到一行行绿色的 ✓ 检查项，包括 Python、Node.js、ripgrep、ffmpeg 等

如果大部分都是绿色的 ✓，说明安装成功了

如果某些项目显示红色 ❌，可以输入 hermes doctor –fix 让它自动修复，或者再按提示跑 hermes model 或 hermes setup 重新配置，通常就能解决

第七步：配置 AI 模型，通用版

Hermes 本身是一个聪明的“壳”，它需要连接一个大模型 API 才能真正思考和回答问题

好消息是，它支持市面上几乎所有主流模型

从 OpenAI 的 GPT 到 Anthropic 的 Claude，从国内的 Kimi、DeepSeek 到你本地运行的 Ollama，全都可以接入

下面我将教给你一套通用的配置方法，无论你想用哪个模型，看完都能自己搞定

准备工作：获取对应模型的 API Key

无论你选择哪家模型，都需要先注册该平台，并生成一个 API Key（通常是一串以特定字母开头的字符）

这串 Key 就是你的“钥匙”，请务必保管好，不要泄露

常见平台 API Key 获取位置：

OpenAI：

platform.openai.com

→ API keys
Anthropic（Claude）：

console.anthropic.com

→ API Keys
OpenRouter（聚合平台，推荐新手）：

openrouter.ai

→ Keys（一个 Key 通吃 200+ 模型）
Kimi（月之暗面）：

platform.moonshot.cn

→ API Keys
DeepSeek：

platform.deepseek.com

→ API Keys
Ollama（本地模型）：无需 API Key，但要提前安装并运行 Ollama

核心方法：使用 hermes model 交互式配置（最简单）

Hermes 内置了一个非常友好的交互式配置向导，它会一步步引导你完成所有设置。这是最推荐的方法，不用记任何参数

在 Ubuntu 终端里输入以下命令并回车：

plaintext

hermes model

系统会弹出一个选择菜单，用键盘的上下箭头键选择你想要的提供商，然后按回车 OpenRouter：一个聚合平台，一个 Key 能调用 GPT、Claude、Gemini、Llama 等 200+ 模型，推荐新手使用 OpenAI：直接使用官方 GPT 系列模型 Anthropic：直接使用官方 Claude 系列模型 Custom endpoint：连接任何兼容 OpenAI API 格式的服务（包括本地 Ollama、国产模型 API 等）列表中还会有其他选项，根据你的实际情况选择即可
根据提示输入你的 API Key 输入时屏幕上不会有任何显示，这是安全机制，直接粘贴后按回车即可
接着系统会列出该提供商下可用的模型列表，用上下箭头选一个作为默认模型，按回车确认
看到 Configuration saved 之类的提示，就说明配置完成了

💡 关于编辑器选择的小提示：如果在配置过程中出现 “Could not determine default editor” 的提示，这是在问你想用哪个文本编辑器对于新手，输入 nano 然后回车就行，它最简单

备用方法：手动命令行配置

如果你不想用交互式向导，或者需要批量脚本配置，也可以直接敲命令

bash

# 以 OpenRouter 为例
hermes config set model.provider custom
hermes config set model.base_url "https://openrouter.ai/api/v1"
hermes config set model.api_key_env "OPENROUTER_API_KEY"
hermes config set model.default "anthropic/claude-sonnet-4"
echo "OPENROUTER_API_KEY=你的API_Key" >> ~/.hermes/.env

不同提供商的参数只需替换对应内容即可

第七步：第一次运行，让它帮你做事

现在一切就绪，来试试让它帮你分析一下电脑环境：

在 Ubuntu 窗口里输入：

plaintext

hermes chat -q "1+1等于几？"

按回车后，你会看到 Hermes Agent 的启动画面，然后它会自动调用各种命令去算，然后得出 2

恭喜！你已经在 Windows 电脑上成功安装并运行了 Hermes Agent！

以后怎么用？

每次想用 Hermes Agent，先打开 “开始菜单 → Ubuntu”，进入那个黑色窗口
然后输入 hermes chat -q “你的问题或任务” 就能让它帮你干活了
如果想和它聊天式的对话，直接输入 hermes chat 然后按回车即可

常见翻车现场

装 Hermes 时报网络错，关了 Ubuntu 重开，再跑一次安装命令
跑 hermes doctor 如果有红叉，先跑 hermes doctor，再按提示跑 hermes model 或 hermes setup 重新配置，通常就能解决
提示找不到 hermes 命令输入 source ~/.bashrc
报错 401 认证失败检查 API Key 有没有输错，或者去 DeepSeek 看余额