真机实测：Hermes Agent Windows 全流程安装与配置指南

玩本地 AI Agent 的朋友大多了解 OpenClaw，今天给大家推荐一款近期爆火的新工具 ——Hermes Agent。上手之后能明显感觉到，它整体更加成熟稳定。不同于同类工具，Hermes 深耕长期记忆与自动技能沉淀，越用越顺手，很适合日常长期使用。接下来我结合真机实测，整理了它 Windows 原生版的完整安装教程，全程搭配截图，零基础也能跟着一步步操作。

特别提示：

国内用户注意，本教程推荐搭配 Kimi 大模型使用，无需特殊网络，中文理解和智能体任务表现出色。

一、系统要求与准备

• 支持平台：Linux、macOS、Windows（WSL2推荐，原生Windows为早期Beta）、Android（Termux）
• 网络要求：能访问GitHub和模型API
• 硬件建议：至少4GB内存，推荐8GB+，磁盘空间≥500MB（含依赖与模型缓存）
• 权限：无需sudo/管理员权限（一键安装脚本自动处理用户级环境）

一、前置依赖检查：Git 环境

在开始安装 Hermes Agent 之前，请确保您的计算机已正确安装 Git 版本控制系统。

• 右键点击 Windows 开始按钮，选择并打开管理员模式的 Windows PowerShell
• 在终端中输入以下命令并回车执行：
• powershell

git -v

• 若终端返回类似git version 2\.53\.0\.windows\.2的版本信息，说明 Git 已成功安装，可继续进行后续安装步骤。

若终端提示 “找不到 git” 或 “git 不是内部或外部命令”，则需先安装 Git：

• 官方下载地址：https://git-scm.com/
• 安装流程：下载对应 Windows 版本的安装包后，全程保持默认设置，连续点击 “下一步” 即可完成安装。
• 安装完成后，重新打开管理员模式的 PowerShell，再次执行git \-v命令验证安装成功，再继续后续操作。

二、Hermes Agent 官方安装命令

Windows原生（早期测试版）

• 以管理员身份打开PowerShell
• 执行安装命令：

iex (irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1)

• 注意：可能有兼容性问题，建议优先用WSL2方案

Linux/macOS/WSL2（稳定）

• 一键安装（官方）

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

• 国内镜像（推荐）

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

• 验证安装

source ~/.bashrc # 或 source ~/.zshrc hermes --version # 应显示版本号如 v0.8.0+

然后你就可以看到这样的界面：

三、进入 Hermes 初始化配置向导

接下来，Hermes 会询问安装方式：

这里选择Quick setup，按回车

快速配置会帮你把模型供应商、默认模型和消息平台都设置好，第一次用完全够了。啥也不用输，直接敲回车就行，系统默认就是第 1 项。

四、选择模型提供商

在这一步内，可以选择你想使用的 AI 模型提供商，我们以Kimi为例：

• 国内用户：选Kimi，适合国内用户，网络也稳定

这里的逻辑很简单：Hermes Agent 本身是 AI 助手的 "大脑指挥中心"，真正负责思考和回答问题的是你配置的模型服务商。也就是说，Hermes 相当于你的 Agent 工作台，Kimi 则提供底层的 AI 思考和推理能力

五、创建Kimi API 密钥

选择提供商后，系统会提示你输入 API 密钥，这时候你需要：

• 登录Kimi 开放平台获取API Key，访问 https://platform.moonshot.cn/console 点击登录
• 点击左侧的API Key管理，创建API Key，复制弹出的密钥字符

• 安全提醒：API密钥为私密凭证，禁止截图、分享、公开传播，避免额度被盗刷
• 回到hermes agent继续配置

六、选择默认模型

将复制的API Key贴入终端并敲击回车，然后选择Kimi-K2.6模型并敲击回车确认。

七、选择 Terminal Backend

这里是选择 Hermes 后续执行命令、运行代码的位置，包括本地，Docker，远程，云端等等方式。

对于普通 Windows 用户来说，可以直接保持默认选项（本地），按回车即可。

八、跳过聊天平台设置

这里我们选择2跳过聊天平台设置

九、全部流程完成后，就可以开始对话啦~

到现在我们就可以正常使用Hermes啦，能看到我们选择的Kimi大模型也是正在工作啦~

十、常见问题解决

1、安装失败：

• 检查网络连接，确保能访问GitHub
• 国内用户改用镜像安装脚本
• 手动安装时确保Python 3.11+

1. 命令未找到：
   • 执行source \~/\.bashrc或source \~/\.zshrc
   • 检查\~/\.local/bin是否在PATH中：echo $PATH
2. 模型连接失败：
   • 验证API密钥正确性
   • 检查网络是否能访问模型服务
   • 切换模型提供方
3. Windows问题：
   • 优先使用WSL2+Ubuntu 22.04 LTS
   • 确保WSL2已启用：wsl \-\-install

十一、最后

工具学习遵循 "实践先行" 原则：安装阶段以环境可运行为首要目标，暂不要求掌握全部技术细节。从兼容性和访问速度角度考量，Kimi 是 Windows 国内用户的优选模型方案。完成基础部署后，结合实际使用体验再深入理解其功能特性与高阶玩法，学习效率将大幅提升。