HoRain云--Hermes Agent 安装

📅 2026/7/7 18:17:24 👁️ 阅读次数 📝 编程学习
HoRain云--Hermes Agent 安装

Hermes Agent 支持以下操作系统:

平台支持方式
macOS桌面应用(推荐)/ 命令行安装
Windows桌面应用(推荐)/ PowerShell 脚本 / WSL2
Linux命令行一键安装
Android (Termux)命令行安装)

系统配置:

项目最低要求推荐配置
操作系统Linux / macOS / WSL2Ubuntu 22.04+ / macOS 14+ / WSL2 (Ubuntu)
Python3.10+3.11 或 3.12
内存4 GB8 GB+
磁盘空间2 GB5 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 installPython 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