技术教程

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 中安装：

1. 在 Windows 浏览器中访问 GitHub 仓库，下载 hermes-agent-main.zip 并解压
2. 在 WSL 中创建项目目录：

Bash

mkdir -p ~/ai/hermes

1. 将 Windows 下载的源码复制到 WSL（注意替换为你的实际路径）：

Bash

cp -r /mnt/c/Users/你的用户名/Downloads/hermes-agent-main ~/ai/hermes/

1. 进入项目文件夹并执行本地源码安装：

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 等社交平台的绑定方法，我们将在下篇教程中详细介绍，敬请期待！

如果本文对你有帮助，欢迎点赞、在看、转发三连！
有任何问题欢迎在评论区留言，我们会尽快回复。

— 技术分享站