一、Hermes agent大模型选择

（一）国内模型（Kimi K2.6 优选）

• 长任务稳定：大上下文窗口，不易上下文丢失，长流程任务执行更连贯。
• 工具调用稳：原生函数调用能力强，适配多工具协同，出错率低。
• 中文适配好：理解中文指令、文档、本土业务精准，适配国内办公场景。
• 高并发可用：支持多智能体同时运行，不易阻塞、超时。
• 合规性强：支持私有化部署，数据内网闭环，满足政企安全要求。
• 性价比高：Token利用率高，长期调用成本更低。

（二）海外主流模型

• 复杂逻辑推理、任务拆解能力强
• 支持图文多模态，适配图像识别、内容创作、数据分析
• 生态完善，插件、工具兼容性最好

二、安装前置准备

1. 版本控制工具：已安装 Git 2.0 或更高版本
2. 模型 API 密钥：已获取 Kimi（Moonshot AI）或其他大语言模型服务商的 API Key
3. Windows 环境：Windows 用户需预先安装 WSL2，安装过程中将请求系统管理员权限以完成环境配置

三、安装hermes agent

1.1 Windows详细安装教程

方式一：WSL2 安装（推荐新手使用）

• 检查 Windows 版本：WSL2 需要 Windows 10（版本 2004 或更高）或 Windows 11。
• 选择终端 (管理员) 或 Windows PowerShell (管理员)，在 UAC 弹窗点击 “是”。
• 安装 WSL2，在 PowerShell 里输入这条命令，然后按回车：

wsl --install

• 重启后设置 Linux 用户名和密码
• 在 WSL2 里安装 Hermes Agent，现在你已经在 Ubuntu 里了，输入这条命令：

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

source ~/.bashrc
hermes

方式二：PowerShell 原生安装

• 打开 PowerShell：按 Win 键，输入 PowerShell，点击"Windows PowerShell"。（这次不需要管理员权限）
• 运行安装命令，复制下面这行，粘贴到 PowerShell 里，按回车：

irm https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

• 等待安装完成：安装过程可能需要 3-5 分钟，期间会自动下载 Python、Node.js 等依赖。看到"Installation complete"就成功了。

1.2 macOS 详细安装教程

• 克隆项目到本地

git clone https://gitcode.com/GitHub_Trending/he/hermes-agent.git

• 将下面代码复制到安装目录

mkdir -p ~/.hermes
cp -r ~/hermes-agent ~/.hermes/hermes-agent

• 进入目录并执行安装脚本

cd ~/.hermes/hermes-agent && bash scripts/install.sh

• 重载环境变量

# Zsh 用户执行source ~/.zshrc
# Bash 用户执行（二选一）# source ~/.bashrc

1.3 Linux 详细安装教程

• 克隆项目到本地

git clone https://gitcode.com/GitHub_Trending/he/hermes-agent.git

• 将下面代码复制到安装目录

mkdir -p ~/.hermes
cp -r ~/hermes-agent ~/.hermes/hermes-agent

• 进入目录并执行安装脚本

cd ~/.hermes/hermes-agent && bash scripts/install.sh

• 重载环境变量

# source ~/.zshrc

四、Kimi 大模型接入配置向导

1、选择模型提供商

2、输入 API 密钥

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

• 回到hermes agent继续配置

3、选择默认模型

4、配置工具

web          # 网络搜索和网页提取
terminal     # 执行命令
file         # 读写文件
browser      # 浏览器自动化（可选）

5、配置完成

6、安装后的第一件事

五、常见问题及解决办法

1、环境准备类问题（Windows 用户高发）

Windows 直接安装失败（未用 WSL2）

• 错误表现：安装脚本报错、命令无法执行、界面无响应
• 核心原因：Hermes Agent 仅支持 Linux/macOS/WSL2，不支持 Windows 原生 PowerShell/CMD
• 解决方案：

# 以管理员身份运行PowerShell，启用WSL2
wsl --install -d Ubuntu
# 安装后设置默认启动WSL
wsl --set-default Ubuntu

2、网络与资源下载问题（国内用户常见）

官方脚本下载失败（GitHub 访问受限）

• 错误表现：curl: (7) Failed to connect to raw.githubusercontent.com
• 核心原因：国内网络无法直接访问 GitHub 资源

cd /mnt/d/Downloads  # 进入安装包目录sudo apt install -y unzipunzip hermes-agent-2026.4.8.zip
cd hermes-agent && bash install.sh

export http_proxy=http://代理地址:端口
export https_proxy=http://代理地址:端口
curl -sSL https://get.hermesagent.com | bash

Python 依赖安装超时（PyPI 访问慢）

• 错误表现：pip install长时间卡住、ReadTimeoutError
• 解决方案：使用国内镜像源加速

pip install --trusted-host pypi.tuna.tsinghua.edu.cn -i https://pypi.tuna.tsinghua.edu.cn/simple/ 依赖包名

3、命令与环境变量问题

hermes: command not found（安装后无法识别命令）

• 错误表现：终端输入hermes提示未找到命令
• 核心原因：环境变量未加载或 PATH 未更新
• 解决方案：

# 重新加载环境变量source ~/.bashrc  # 或~/.zshrc（根据Shell类型）# 或直接重启终端

版本不匹配（Python/Node.js 版本冲突）

• Python 问题：Python 3.9 or older in PATH，安装器需要 Python 3.11

# 手动创建虚拟环境并指定版本
python3.11 -m venv hermes-venv
source hermes-venv/bin/activate

• Node.js 问题：ENOENT/EACCES错误，Node.js 安装不完整

# 删除残留文件并重新安装rm -rf ~/.nvm ~/.node-gyp
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install 18

4、依赖冲突与缺失问题

Pydantic 版本冲突

• 错误表现：TypeError: BaseModel.validate() takes 1 positional argument but 2 were given
• 核心原因：Hermes 依赖 Pydantic v1，系统安装了 v2（语法不兼容）
• 解决方案：

pip uninstall -y pydantic pydantic-core
pip install pydantic==1.10.13

六、结语