NineClaw文档
← 全部教程

编程与智能体

Hermes 安装及 API 配置教程

关于 Hermes

由 Nous Research 开发的自我改进的AI代理工具。唯一具备内置学习循环的代理——它通过经验创造技能,在使用过程中改进技能,推动自身坚持掌握知识,并逐步建立一个跨会话中自我认知的深入模型。 官网：https://hermes-agent.nousresearch.com GitHub：https://github.com/nousresearch/hermes-agent

  • 安装要求：Linux、macOS，Windows 用户需要先安装 WSL2（Windows 子系统 Linux）；安卓手机用户可以用 Termux。
  • 模型要求：Hermes 要求大模型至少支持 64000 token 的上下文窗口。

安装 Hermes Agent

第一步：运行安装脚本

打开终端命令行工具运行以下安装脚本，安装脚本会自动处理所有依赖——Python、Node.js、ripgrep、ffmpeg，全部帮你装好。装完之后会自动进入配置向导。

Linux / macOS / WSL2系统：

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

Windows PowerShell：

irm https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.ps1 | iex

安卓 / Termux：

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

验证是否安装成功：

hermes doctor

看到全部是绿色 ✅，第一步安装过程就完成了。

第二步：配置API令牌

1、安装完成后会自动进入配置向导，选 Quick setup 即可快速上手。

图片.png

或者使用以下命令进入配置向导

hermes setup

2、模型供应商选择最下面的：Custom endpoint (enter URL manually）

图片.png 然后依次填入以下项目

图片.png

其他两项直接回车即可，然后可以选择 配置聊天客户端或者跳过完成设置

图片.png

输入 Y 回车即可进入终端聊天界面

使用 Hermes

Hermes 启动聊天对话命令：

hermes

只需一个命令即可更新到最新版本：

hermes update

检查您当前的安装版本命令：

hermes version

要稍后重新配置单个设置，可使用以下专用命令：

hermes model          # Choose your LLM provider and model
hermes tools          # Configure which tools are enabled
hermes gateway setup  # Set up messaging platforms
hermes config set     # Set individual config values
hermes setup          # Or run the full setup wizard to configure everything

手动卸载命令：

rm -f ~/.local/bin/hermes
rm -rf /path/to/hermes-agent
rm -rf ~/.hermes            # Optional — keep if you plan to reinstall