Hermes Agent 是一个开源的 AI 智能体，运行在终端里，能帮你写代码、查资料、处理文件、自动执行任务。本文带你在一台全新的 Windows 电脑上，从装环境开始，一步步把它跑起来。
Hermes Agent 主要跑在 Linux 环境。Windows 上最省事的方式是装 WSL（Windows Subsystem for Linux）——在 Windows 里跑一个 Ubuntu 子系统，不用装虚拟机、不用双系统。
① 以管理员身份打开 PowerShell：
PowerShell② 粘贴下面这行命令，按回车：
wsl --install
它会自动启用所需功能，并安装默认的 Ubuntu 发行版。
③ 重启电脑。命令执行完一般会提示重启，重启后 WSL 才生效。
① 打开 Ubuntu：点开始菜单，搜索 Ubuntu，点击打开。首次打开会有一个「正在解压安装」的等待过程，属正常现象。
② 创建 Linux 用户名和密码：首次启动会让你设置用户名和密码（密码输入时不显示，正常输入后回车即可）。这个用户名和 Windows 用户名是两回事，自己记住。
sudo apt update sudo apt upgrade -y期间会要求输入刚才设置的密码。Windows 里打开的「Ubuntu」黑窗口，就是后面所有操作的主战场。
先说明一个重要事实：Hermes Agent 的官方安装脚本会自动安装好它运行所需的 Python、Node.js、ripgrep、FFmpeg 等全部依赖（由内置的 PM 包管理器托管固定版本）。所以新手不需要手动装 Node.js，直接跳到第 4 步即可。
如果你之后想自己写前端/跑 JavaScript 项目，再补装 Node.js 也来得及：
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash - sudo apt install -y nodejs
node -v，能显示版本号（如 v20.x.x）就是成功了。在 Ubuntu 窗口里粘贴这一行命令，按回车，然后等它自动完成（会下载源码、装依赖，可能需要几分钟，网络慢时更久）：
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
安装脚本会自动完成：拉取源码 → 安装 uv 与 Python 运行时 → 安装 Node/npm/ripgrep/FFmpeg → 创建启动命令 hermes。
source ~/.bashrc
然后输入 hermes 验证有没有装好（此时还没配模型，先验证命令存在即可）。export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890Hermes 本身不带模型，需要接一个「大模型 API」。有两条路，新手推荐第一条。
路线 A：用 Nous Portal（最简单，一条命令）
Nous Portal 一个订阅覆盖 300+ 模型，还附带联网搜索、生图等工具网关，免去逐个配 Key 的麻烦：
hermes setup --portal
按提示登录授权即可，登录完自动完成模型配置。
路线 B：接第三方 API（更自由）
先选一家平台注册、创建 API Key（各平台免费额度不同）：
| 平台 | 官网（去注册拿 Key） | 适合 |
|---|---|---|
| OpenRouter | https://openrouter.ai | 一个 Key 用几十个模型，新手首选 |
| DeepSeek | https://platform.deepseek.com | 便宜、中文好 |
| 智谱 GLM | https://open.bigmodel.cn | 国产，中文好 |
| Moonshot Kimi | https://platform.moonshot.cn | 国产，中文好 |
| Google Gemini | https://aistudio.google.com | 免费额度大方 |
| Anthropic Claude | https://console.anthropic.com | 能力最强，偏贵 |
拿到 Key 后，运行向导选择模型并粘贴 Key：
hermes model
按上下方向键选择平台 → 选择模型 → 粘贴 API Key → 回车保存。
hermes doctor 检查配置是否完整。WSL 里访问 Windows 磁盘的方式：C 盘 = /mnt/c，D 盘 = /mnt/d。把 Hermes 的工作目录设到 D 盘，文件就存在你熟悉的 Windows 目录里，两边都能看到。
① 建一个工作目录（在 Ubuntu 里执行）：
mkdir -p /mnt/d/hermes-work
② 让 Hermes 默认在这个目录下干活：
hermes config set terminal.cwd /mnt/d/hermes-work
D:\hermes-work，就能直接看到 Hermes 生成的文件。想换目录随时改，或每次手动 cd /mnt/d/xxx 也行。① 健康检查：
hermes doctor
会列出环境是否就绪、模型是否配好。有报错就按提示补（多为缺 Key 或依赖）。
② 开始对话：
hermes
回车后进入聊天界面，试着让它做点事：
# 试试这些（直接输入后回车）
在 D 盘工作区建一个 hello.txt，内容写“你好，Hermes！”
帮我查一下今天北京的天气
写一个 Python 脚本，计算 1 到 100 的和
③ 也可以不进入界面，直接一句话跑任务：
hermes chat -q "在 /mnt/d/hermes-work 下创建一个 hello.txt，内容：你好，Hermes！"
hermes 进入对话、hermes --continue 继续上次的会话。source ~/.bashrc，或重新打开 Ubuntu 窗口。hermes model 重新配置。sudo mkdir -p /mnt/d && sudo mount -t drvfs D: /mnt/d。hermes uninstall。hermes --help 或 hermes doctor --fix，官方文档见下方汇总。