夜雨聆风技术教程
Hermes Agent 超详细安装教程
WSL + 阿里云通义千问版
从零开始，手把手教你部署这款强大的 AI Agent 工具
技术分享站
2026年5月12日
Hermes Agent 是由 Nous Research 推出的开源 AI Agent 框架，内置 18 个工具集和 86 项技能，支持浏览器自动化、代码执行、Discord 集成、GitHub 操作等强大能力。本文将带你一步步完成在 Windows 环境下的完整安装与配置，让你轻松拥有自己的智能助手。
Hermes Agent v0.13.0 启动界面 — 展示 18 工具与 86 技能
01安装前置条件
在开始安装之前，请确保你的系统已满足以下基本条件。值得庆幸的是，Python、Node.js、ripgrep、ffmpeg 等运行时组件无需手动安装，Hermes 的安装脚本会自动检测并为你完成安装。
必备环境清单
安装 WSL 和 Ubuntu
以管理员身份打开 PowerShell，依次执行以下命令。注意：安装过程需保持网络稳定，网络波动很容易导致安装失败。
PowerShell
wsl --install wsl --install -d Ubuntu-26.04
安装完成后，重启电脑，然后在开始菜单中找到 Ubuntu 并启动，完成首次配置（设置用户名和密码）。
02Hermes Agent 安装与部署
方法一：官方一键安装（推荐）
进入 Ubuntu 终端后，直接执行官方安装脚本：
Bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
方法二：国内镜像安装（网络不佳时使用）
如果官方地址访问缓慢或失败，可使用 ghproxy 镜像加速：
Bash
curl -fsSL https://ghproxy.net/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
方法三：手动下载 + 本地安装（备用方案）
如果自动下载失败，可以手动下载源码到 Windows，再复制到 WSL 中安装：
在 Windows 浏览器中访问 GitHub 仓库，下载 hermes-agent-main.zip并解压在 WSL 中创建项目目录：
Bash
mkdir -p ~/ai/hermes
将 Windows 下载的源码复制到 WSL（注意替换为你的实际路径）：
Bash
cp -r /mnt/c/Users/你的用户名/Downloads/hermes-agent-main ~/ai/hermes/
进入项目文件夹并执行本地源码安装：
Bash
cd ~/ai/hermes/hermes-agent-main sudo apt update sudo apt install -y python3-venv python3 -m venv hermes-agent source hermes-agent/bin/activate pip install . --no-cache-dir
补充安装 uv / ripgrep / ffmpeg
如果安装过程中提示缺少 uv，或后续发现 ripgrep、ffmpeg 找不到，执行以下命令补充安装：
Bash
# 安装 uv（快速 Python 包管理器）curl -LsSf https://astral.sh/uv/install.sh | sh# 更新软件源并安装 ripgrep、ffmpegsudo apt update sudo apt install -y ripgrep ffmpeg
03核心配置（一键完成）
安装完成后，需要进行三项核心配置：API 密钥、主配置文件、以及缺失目录的创建。
步骤一：配置阿里云通义千问 API 密钥
使用 nano 编辑器创建并编辑环境变量文件：
Bash
nano ~/.hermes/.env
将以下内容粘贴进去（请替换为你自己的 API Key）：
.env
DASHSCOPE_API_KEY=sk-你的阿里云API密钥 DASHSCOPE_BASE_URL=https://dashscope.aliyuncs.com/compatible-mode/v1
粘贴完成后，按 Ctrl+O 保存，再按 Ctrl+X 退出编辑器。
步骤二：配置主配置文件
编辑 config.yaml，设置默认使用的模型和提供商：
Bash
nano ~/.hermes/config.yaml
粘贴以下内容：
YAML
model: default: qwen3.6-plus provider: alibaba providers: alibaba: {} fallback_providers: []
当前配置使用的是 qwen3.6-plus 模型，你可以根据需要更换为其他阿里云 DashScope 支持的模型。
步骤三：创建缺失目录
Bash
mkdir -p ~/.hermes/hermes-agent
04启动你的 Hermes Agent
所有配置完成后，只需一条命令即可启动对话：
Bash
hermes chat
首次启动时会显示 "Initializing agent..."，稍等片刻后，你将看到熟悉的终端界面，并可以和 Hermes 进行对话了。
下次重启 WSL 后的快速启动
每次重启电脑或 WSL 后，只需要执行三步即可恢复使用：
Bash
# 1. 进入项目目录cd ~/ai/hermes/hermes-agent-main# 2. 激活虚拟环境source hermes-agent/bin/activate# 3. 启动对话hermes chat
05常见问题：取消 WSL 代理
如果你之前为 WSL 配置过代理（如 Clash、V2Ray 等），可能会导致 Hermes 连接国内 API 时出现问题。建议执行以下一键清除脚本：
Bash
# 清除终端全局代理环境变量unset HTTP_PROXY HTTPS_PROXY ALL_PROXY SOCKS_PROXY# 删除 pip 代理配置pip config unset global.proxy pip config unset install.proxy# 永久删除 ~/.bashrc 里的代理配置sed -i '/proxy\|socks\|HTTP_PROXY/d' ~/.bashrc# 使配置生效source ~/.bashrc
执行上述命令后，WSL 将不再使用任何代理。如果你需要恢复代理，请重新配置。
06结语
到这里，你已经成功完成了 Hermes Agent 的完整安装与配置。这款工具拥有 18 个工具集和 86 项技能，覆盖浏览器自动化、代码执行、Discord 集成、GitHub 操作、媒体处理等方方面面。
在终端中输入 /help 可以查看所有支持的命令，输入 /reload-skills 可以重新扫描技能目录，让新放入的技能无需重启即可生效。
关于微信、QQ 等社交平台的绑定方法，我们将在下篇教程中详细介绍，敬请期待！
如果本文对你有帮助，欢迎点赞、在看、转发三连！
有任何问题欢迎在评论区留言，我们会尽快回复。
— 技术分享站
