Hermes Agent 支持以下操作系统：
| 平台 | 支持方式 |
|---|---|
| macOS | 桌面应用（推荐）/ 命令行安装 |
| Windows | 桌面应用（推荐）/ PowerShell 脚本 / WSL2 |
| Linux | 命令行一键安装 |
| Android (Termux) | 命令行安装） |
系统配置：
| 项目 | 最低要求 | 推荐配置 |
|---|---|---|
| 操作系统 | Linux / macOS / WSL2 | Ubuntu 22.04+ / macOS 14+ / WSL2 (Ubuntu) |
| Python | 3.10+ | 3.11 或 3.12 |
| 内存 | 4 GB | 8 GB+ |
| 磁盘空间 | 2 GB | 5 GB+（为模型缓存和日志预留） |
| 网络 | 可访问 LLM API | 稳定的互联网连接 |
Windows 用户必须使用 WSL2（Windows Subsystem for Linux），Hermes Agent 目前不原生支持 Windows 命令行。
安装方式选择
方式一：Hermes Desktop（macOS / Windows 推荐）
Hermes Desktop 是官方出品的桌面应用，在命令行工具之上提供了图形化界面——包含可视化 Dashboard、Profile 管理器、技能浏览器等，安装桌面应用时会同时安装命令行工具（hermes命令），两者可以并用。
下载与安装
- 访问官网 hermes-agent.nousresearch.com
- 点击Download For...按钮
- 运行下载的安装程序，按提示完成安装。
下载后双击安装即可：
安装完成后，hermes命令会自动添加到系统路径，可以在终端直接使用。
整个面板如下所示：
方式二：命令行安装（Linux / macOS / WSL2）
打开终端，执行以下命令即可自动完成安装:
curl -fsSL https://get.hermes-agent.nousresearch.com | bash
Windows（原生 PowerShell）:
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
脚本会自动检测系统环境并安装所有依赖。
以上命令会自动完成以下所有步骤：
- 检测缺失的依赖并安装（uv、Python 3.11、Node.js v22、ripgrep、ffmpeg）
- 克隆 Hermes Agent 仓库到
~/.hermes/hermes-agent/ - 创建隔离的 Python 虚拟环境
- 配置全局
hermes命令 - 引导你完成 LLM 提供商配置
Windows 系统说明：不支持原生 Windows 环境，请先安装 WSL2，再在 WSL2 终端中执行上述命令。
如果安装过 OpenClaw 还可以直接导入配置：
这里选择不导入，输入 n，进入模型设置，选择第一个快速设置：
接下来我们选择倒数第二项的 More providers：
这里可以选择更多国内或国际的大模型：
所以选择的是Customer endpoint，就是自定义 API 地址与 API key。
Base URL 设置字节方舟兼容 OpenAI 接口协议工具：https://ark.cn-beijing.volces.com/api/coding/v3
设置 API key 与支持的大模型，比如 ark-code-latest。
安装完成后，刷新 Shell:
source ~/.bashrc # Bash 用户 # 或 source ~/.zshrc # Zsh 用户
验证安装成功:
hermes --version
使用以下命令开启智能体对话：
hermes
文件安装位置说明：
| 安装方式 | 代码位置 | hermes命令 | 数据目录 |
|---|---|---|---|
| pip install | Python site-packages | ~/.local/bin/hermes | ~/.hermes/ |
| git 安装脚本（用户级） | ~/.hermes/hermes-agent/ | ~/.local/bin/hermes（软链接） | ~/.hermes/ |
| root 模式（sudo 安装） | /usr/local/lib/hermes-agent/ | /usr/local/bin/hermes | /root/.hermes/ |
参考文档：hermes-agent.nousresearch.com/docs/getting-started