HermesAgentLinux安装与部署教程

本文详细解析了在Linux系统（含WSL2）上安装部署Hermes Agent时因GitHub网络受限导致git clone卡顿或“unexpected eof”错误的三大实用解决方案：通过官方脚本结合离线源码包快速补救、手动分步构建实现灵活定制、以及专为WSL2环境优化的DNS与权限适配流程，兼顾新手友好性与高级用户可控性，助你绕过网络障碍，高效完成本地智能体代理的部署。

如果您尝试在 Linux 系统上安装 Hermes Agent，但执行官方一键脚本后卡死在 git clone 步骤或报 unexpected eof 错误，则很可能是因 GitHub 源码拉取受网络限制所致。以下是多种可行的安装部署步骤：

一、官方脚本+离线源码补救法

该方法复用官方 install.sh 的环境自动配置能力，在其触发 GitHub 克隆前中断流程，再将已下载的完整源码包解压至指定路径，规避网络不稳定问题。

1、访问百度网盘链接 https://pan.baidu.com/s/1PMVQ4bANEhyie94IbRQ5GQ?pwd=9dbu，下载 install.sh 与 hermes-agent-main.zip 两个文件，并保存至用户主目录（即 ~ 路径）。

2、在终端中执行：chmod +x ~/install.sh，赋予脚本可执行权限。

3、运行脚本：~/install.sh，当输出出现类似 “Cloning into 'hermes-agent'…” 提示时，立即按 Ctrl+C 中断执行。

4、创建目标目录：mkdir -p ~/hermes-agent。

5、解压离线包：unzip ~/hermes-agent-main.zip -d ~/hermes-agent（若未安装 unzip，请先执行 sudo apt install unzip）。

6、进入目录并完成后续安装：cd ~/hermes-agent && uv pip install -e ".[all]"。

二、手动分步构建法

该方法完全绕过官方脚本，由用户自主控制每一步依赖安装与环境初始化，适合对系统有明确控制需求或需定制功能模块的用户。

1、确保已安装 Git：git --version；如无输出，请执行 sudo apt update && sudo apt install git（Ubuntu/Debian）。

2、安装 uv 包管理器：curl -LsSf https://astral.sh/uv/install.sh | sh。

3、创建 Python 3.11 虚拟环境：uv venv venv --python 3.11。

4、激活虚拟环境：source venv/bin/activate。

5、克隆仓库（若网络可用）：git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git；若失败，可改用离线 zip 包解压至当前目录并重命名为 hermes-agent。

6、进入项目目录：cd hermes-agent。

7、安装全部功能模块：uv pip install -e ".[all]"；如仅需核心功能，替换为 uv pip install -e "."。

三、WSL2 环境专项适配法

该方法专为 Windows 用户通过 WSL2 部署设计，重点解决子系统内 DNS 解析异常、权限模型冲突及 systemd 缺失导致的 gateway 启动失败问题。

1、在 Windows 上启用 WSL2 并安装 Ubuntu 发行版（推荐 22.04 或更新版本）。

2、启动 WSL2 终端，执行：sudo apt update && sudo apt install -y curl git unzip wget。

3、关闭 WSL2 的默认 systemd 支持（避免冲突），在 Windows PowerShell 中运行：wsl --shutdown，然后编辑 WSL 配置文件 %USERPROFILE%\AppData\Local\Packages\\wsl.conf，添加 systemd=false。

4、重启 WSL2，执行离线安装流程（同方法一），并在安装完成后运行：echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc。

5、验证命令可用性：hermes --version。

终于介绍完啦！小伙伴们，这篇关于《HermesAgentLinux安装与部署教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布科技周边相关知识，快来关注吧！