开源AI神器HermesAgent免费安装教程，支持跨平台与自学习

Hermes Agent 被视为新一代的 OpenClaw 继承者。回顾之前，许多用户曾通过 OpenClaw 获得了可观的早期红利。现在，你同样有机会把握住 Hermes 所带来的新机遇。

Hermes 是由 Nous Research 推出的开源 AI Agent 框架。它具备几项核心优势：支持自建学习循环（能够从实际使用中不断积累和进化技能）、可接入超过 15 家模型提供商，并实现了跨平台消息集成（如 Telegram、Discord、Slack、WhatsApp）。

自动安装指南

针对 Mac 或 Linux 操作系统，请在终端中执行以下命令：

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

该安装脚本具备自动检测功能，将为您安装 Python、Node.js、Git、ripgrep 等所有必需的依赖项。整个过程请您耐心等待即可。 （安装脚本运行中图示）

快速配置向导

安装流程结束后，系统将自动启动配置向导。我们推荐您选择第一项 Quick setup（快速设置）。 （选择 Quick setup 图示）

接下来进入 Inference Provider（推理服务提供商）配置环节。系统会提示您输入 OpenRouter 的 API 密钥，请粘贴您事先申请好的 Key 并按下回车（若尚未申请，可先查看文末的补充说明）。 （填写 OpenRouter API Key 图示）

随后需要选择默认使用的模型。列表中存在多款免费模型，此处建议选择 nvidia/nemotron-3-super-120b-a12b:free，该模型完全免费且实际效果相当不错。 （选择默认模型图示）

下一步是配置消息接收平台，请选择 Set up messaging now（立即设置消息平台）。 （配置消息平台图示）

选择 Telegram，然后粘贴您申请的 Bot Token（申请方法见下一节），回车确认。 （填写 Telegram Token 图示）

接着设置 Allowed user IDs（允许使用的用户ID，填写您个人的 Telegram 数字 ID，若不填写则任何人都能使用您的 Bot），Home Channel ID 可以暂时留空，后续再进行配置。最后，系统会询问是否安装为系统服务（如 launchd），选择 Y 可以实现开机自动启动和后台常驻运行。 （完成 Telegram 配置图示）

如何查询个人 Telegram 数字 ID：在 Telegram 应用中向 @userinfobot 发送任意消息，该机器人将回复您的唯一 ID。

申请 Telegram Bot 教程

  1. 在 Telegram 内搜索 @BotFather。
  2. 向其发送 /newbot 指令，并按照提示为机器人命名（注意：用户名必须以 bot 结尾）。
  3. 成功创建后，您将获得一个 Bot Token，其格式类似于 123456789:AAxxxxxxxx。

成功启动验证

全部配置完成后，在终端运行 hermes 命令启动程序。如果欢迎界面显示已加载 28 个工具和 77 个技能，则表明一切运行正常。 （Hermes 启动成功图示）

打开 Telegram，找到您创建的 Bot 并发送一条消息进行测试。 （Telegram 测试成功图示） 至此，基础配置与测试已完成。

手动安装方法

如果您希望修改源代码或固定使用某个特定版本，可以选择手动安装方式。

首先克隆项目仓库：

git clone https://github.com/nousresearch/hermes-agent.git
cd hermes-agent

然后安装所需的 Python 依赖包：

pip install -r requirements.txt

最后运行程序：

python -m hermes

手动安装模式下的功能和使用方式与自动安装完全一致。

基本使用命令一览

  • hermes — 启动交互式对话界面。
  • hermes model — 选择或切换模型提供商及具体模型。
  • hermes tools — 管理配置可用的工具列表。
  • hermes config set — 设置单个配置项。
  • hermes gateway — 启动消息网关（用于连接 Telegram、Discord 等平台）。
  • hermes setup — 重新运行完整的初始配置向导。
  • hermes claw migrate — 从旧版 OpenClaw 迁移配置数据。
  • hermes update — 将 Hermes 更新到最新版本。
  • hermes doctor — 诊断并排查运行中的常见问题。

常见问题与排错指南

Q: 提示 API call failed after 3 retries: HTTP 400: No models provided 错误 此问题通常由配置文件编码错误引起（在 Windows 系统中较为常见）。您可以寻求 Claude 等 AI 助手的帮助来修复：将完整的报错信息提供给 AI，它会自动定位到 cli.py 文件中的 open() 调用，并为您添加 encoding="utf-8" 参数。 （Windows 编码报错修复图示）

Q: Telegram Bot 对消息无任何响应 这很可能是因为未设置 Allowed user IDs。您只需通过配置命令手动添加您的 User ID，或同样请 Claude 协助设置即可解决。

补充说明：申请 OpenRouter API Key

Hermes 支持众多模型提供商，我们推荐首先配置 OpenRouter——它提供了大量可免费使用的模型，是零成本入门体验的最便捷途径。

访问 openrouter.ai/keys，点击 “Create Key” 按钮。在名称栏填写 hermes，然后直接点击 Create。 （创建 OpenRouter API Key 图示）

生成的 Key 仅会显示一次，请务必立即复制并妥善保存。 （复制 API Key 图示）

Hermes Agent 的功能远不止于此，还有更多高级玩法等待探索，例如设置定时任务、构建自定义技能等。希望本指南能帮助你顺利踏上探索之旅，充分利用这款强大的开源AI代理框架。