乐于分享
好东西不私藏

Windows系统安装Hermes Agent新手教程,10分钟安装好!

Windows系统安装Hermes Agent新手教程,10分钟安装好!
Hermes Agent 是 NousResearch 开源的 AI 智能体框架,最大亮点是「自我进化」——每次成功完成任务后,它会把经验提炼成技能,下次遇到类似任务直接调用,越用越聪明。本教程专为国内网络优化,全程使用清华、kkgithub 等国内镜像,亲测可用。
 开始前请准备好
Windows 10 / 11 系统
一个存放项目的文件夹(路径中不要有空格,建议放在 D 盘)
智谱 GLM API Key(免费注册获取)
约 10 分钟安装时间

1安装基础环境
1安装 Python 3.13

按 Win + X 打开 PowerShell,输入:

PowerShell
winget install Python.Python.3.13

安装完成后验证:

python --version# 看到 Python 3.13.x 即为成功
终端显示 Python 3.13.x 版本号
2安装 uv 包管理工具

uv 是比 pip 快数倍的现代包管理器,用清华源安装:

pip install uv -ihttps://pypi.tuna.tsinghua.edu.cn/simple
⚠️ 安装完成后,必须关闭当前终端,重新打开一个新的 PowerShell 窗口,否则系统找不到 uv 命令。

在新窗口中验证安装:

uv --version# 应输出类似 uv 0.x.x 的版本号
左图:未安装时报错;右图:安装成功显示版本号
3安装 Git
winget install Git.Git

安装完后重启终端,执行 git --version 验证。


2拉取源码并安装依赖
💡 国内网络重点:官方 GitHub 访问不稳定,这里改用 kkgithub 镜像,速度快,体验一致。

切换到你的项目目录,依次执行以下命令:

PowerShell — 逐行执行
# ① 用国内镜像克隆代码
git clonehttps://kkgithub.com/NousResearch/hermes-agent.git
# ② 进入项目目录
cd hermes-agent
# ③ 创建虚拟环境
uv venv .venv --python 3.13
# ④ 激活虚拟环境(命令行前会出现 (.venv) 前缀)
.venv\Scripts\activate
# ⑤ 用清华镜像安装全部依赖
uv pip install -e ".[all]" -ihttps://pypi.tuna.tsinghua.edu.cn/simple

最后一步会滚动下载大量包,耐心等待。

✅ 终端显示一列绿色加号,代表全部依赖安装成功!
终端滚动完毕后显示的绿色加号列表

3初始化配置(接入智谱 GLM)

依赖装好后,运行初始化向导:

hermes setup
终端显示 Hermes Agent Setup Wizard 标题

下面按顺序完成各个配置项:

历史数据迁移 → 输入 n 跳过

如果电脑装过 OpenClaw 会弹出此询问,输入 n 回车,避免规则冲突。

选择安装模式 → 直接回车

选 1. Quick setup,直接按回车确认即可。

显示 Quick setup / Full setup 的选择菜单
选择大模型供应商 → 智谱 GLM

先输入 8(More providers...)回车翻页,然后输入 Z.AI / GLM 对应的序号(通常是 5)回车。

翻页后的供应商列表,高亮 Z.AI / GLM 选项
填写 API Key

将你在 智谱开放平台 生成的 API Key 粘贴进去,回车确认。

输入 API Key 并显示 "API key saved." 的提示
填写 Base URL ← 重点!
⚠️ 这里是 99% 的人会踩的坑

系统会提示你输入 Base URL,直接用默认值大概率会报错,启动后一直提示 API 认证失败。

正确的 Base URL 有一个格式细节极易忽略,填错了哪怕只差一个斜杠也无法连通。

以智普为例:https://open.bigmodel.cn/api/paas/v4/chat/completions

其余配置 → 全部默认跳过
• Add another credential? → 直接回车跳过
• Connect a messaging platform? → 选 2. Skip
• Select TTS provider? → 直接回车,保持默认 Edge TTS

4日常启动(三步走)

每次重新打开终端想使用 Hermes,按以下三步操作:

1进入项目目录cd D:\hermes-agent (改成你自己的路径)
2激活虚拟环境.venv\Scripts\activate
3启动 Hermeshermes chat
🎉 看到 Welcome to Hermes Agent! 的界面就大功告成了!
显示 Welcome to Hermes Agent! 的终端界面,以及 28 tools · 72 skills 等信息

?常见问题
Q运行 hermes 提示"不是内部命令"?
检查是否激活了虚拟环境,命令行前应有 (.venv) 前缀。若没有,先执行 .venv\Scripts\activate
Q安装依赖时报网络超时?
确认命令中带了 -i https://pypi.tuna.tsinghua.edu.cn/simple,或改用阿里云源 https://mirrors.aliyun.com/pypi/simple
Q路径带空格导致启动报错?
将项目移到无空格的路径下(如 D:\hermes-agent),重新进入目录激活环境即可。

🚀 其他问题

如果你跟着上面的教程还是不会安装,可以关注公众号私信hermes可以获取工具安装包,不需要终端下载。我已经全部打包好上传到网盘中了

有其他安装问题可以添加洋洋微信:xuexi16886

关注公众号 · 回复【hermes】