Hermes Agent 安装与配置教程(小白友好版)

Mac 安装（超简单）

Mac 系统自带 Linux 环境，Hermes Agent 可以直接运行，安装只需一行命令。

1. 打开终端

同时按下 Command（⌘）+ 空格键，搜索"终端"，点击打开。你会看到一个黑色或白色背景的命令行窗口。

2. 粘贴安装命令

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

Windows 安装（5 步搞定）

Windows 没有原生 Linux 环境，需要先安装 WSL（Linux 子系统），再装 Node.js，最后安装 Hermes Agent。整个过程分 5 步，跟着操作不会出错。

以管理员身份打开 PowerShell

按下键盘上的 Win 键（四个方块图标），搜索 PowerShell，右键点击选择"以管理员身份运行"。

安装 WSL（Linux 子系统）

在 PowerShell 中输入以下命令并回车。系统会自动下载安装 WSL 2 和 Ubuntu，需要几分钟到十几分钟。

wsl --install

打开 WSL 终端

后续所有操作都在 WSL 终端里进行。在开始菜单搜索 Ubuntu 或 WSL，点击打开。

安装 Node.js

在 WSL 终端中依次执行以下 4 条命令：

# 1. 更新软件包列表（需要输入 WSL 密码） 

sudo apt update  

# 2. 添加 Node.js 安装源 

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -  

# 3. 安装 Node.js sudo apt install -y nodejs  

# 4. 验证安装 node --version

一键安装 Hermes Agent

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

大模型配置

安装完成后通常会自动进入大模型配置流程。如果没有弹出配置提示，手动执行以下命令：

hermes setup

⚠️ 重要提示

· API Key 输入时是隐藏的，粘贴后看不到任何字符是正常的

· 只粘贴一次就够了，重复粘贴会导致运行时报错

· API Key 相当于你的账户密码，请妥善保管