linux系统部署hermes agent有五种方式：一、官方一键脚本（curl安装）；二、pip包安装；三、docker容器化；四、源码编译；五、wsl2子系统部署，各适配不同场景与需求。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在Linux系统上运行Hermes Agent，则可直接通过多种成熟方式完成部署。以下是适用于主流Linux发行版的详细操作步骤：
一、使用官方一键安装脚本（Ubuntu/CentOS/Debian通用）
该方法调用Hermes Agent官方维护的安装脚本，自动检测系统环境、安装依赖、配置路径并初始化基础服务，适合绝大多数Linux用户快速启用。
1、打开终端，执行下载并运行安装脚本：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
2、脚本执行过程中将提示输入系统密码（sudo权限），输入后按回车确认。
3、安装完成后，自动加载环境变量，无需手动修改~/.bashrc或~/.zshrc。
4、验证安装结果：hermes --version，预期输出类似hermes v0.8.0 (v2026.4.8)。
二、基于pip的Python包安装（轻量级部署）
此方式跳过源码构建与系统服务注册，仅安装可执行模块，适用于开发测试或资源受限环境，要求系统已预装Python 3.10+及pip。
1、确认Python版本：python3 --version，若低于3.10需先升级。
2、升级pip至最新稳定版：python3 -m pip install --upgrade pip
3、执行安装命令：pip3 install hermes-agent
4、安装完成后，直接运行：hermes gateway 启动默认网关服务。
三、Docker容器化部署（隔离性强、环境一致）
该方式将Hermes Agent及其全部依赖封装于标准镜像中，避免主机环境污染，适用于生产环境或需多版本共存的场景。
1、确保系统已安装Docker及docker-compose：docker --version && docker-compose --version
2、创建部署目录并进入：mkdir -p /opt/hermes && cd /opt/hermes
3、创建docker-compose.yml文件，内容包含服务定义、端口映射（如3000:3000）及环境变量MINIMAX_CN_API_KEY。
在无 root/sudo 权限的环境（云容器、VPS、隔离主机）中安装并配置 OpenClaw 浏览器工具的 headless Chrome。适用场景：...
4、启动服务：docker-compose up -d
5、检查容器状态：docker ps | grep hermes-agent，确认STATUS为Up且无重启循环。
四、源码编译部署（定制化与安全审计需求）
此方式完整拉取项目源码，本地编译生成二进制文件，支持Rust沙箱、自定义存储驱动及模型后端替换，适用于对供应链安全有严格要求的场景。
1、安装构建依赖：sudo apt install -y build-essential git python3.12-dev nodejs npm（Ubuntu/Debian）
2、克隆仓库：git clone https://github.com/NousResearch/hermes-agent.git && cd hermes-agent
3、安装Python依赖：pip3 install -r requirements.txt
4、执行构建与安装：make build && sudo make install
5、生成默认配置：hermes init，按交互提示完成API密钥、模型提供商等设置。
五、WSL2子系统内部署（Windows用户专用路径）
针对Windows平台用户，利用WSL2提供类原生Linux运行时，规避Windows兼容性问题，同时保持与Linux部署流程高度一致。
1、以管理员身份运行PowerShell，启用Ubuntu 22.04子系统：wsl --install -d Ubuntu-22.04
2、重启后启动Ubuntu，完成初始用户设置。
3、在WSL终端中更新系统并安装核心工具：sudo apt update && sudo apt install -y python3.12 python3.12-venv curl wget git
4、执行官方脚本：curl -fsSL https://hermes-agent.org/install.sh | bash
5、初始化并启动：hermes init && hermes gateway
