Hermes Agent安装教程：Mac与Windows完整精选测评指南，零基础入门到闲鱼接单

2026-06-20阅读 0热度 0

注意了，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。提前去申请好，把 Key 粘进来，回车确认：

填写 OpenRouter API Key

然后是选默认模型。列表里免费模型不少，这里推荐 nvidia/nemotron-3-super-120b-a12b:free，完全免费，效果也不错：

选择默认模型

接着配置消息平台。选 Set up messaging now：

配置消息平台

选 Telegram，再粘贴你之前申请好的 Bot Token（不会申请的话，下一节专门讲）。回车确认：

填写 Telegram Token

接下来要填写 Allowed user IDs，建议填你自己的 Telegram 数字 ID（不填的话任何人都有可能用你的 Bot）。Home Channel ID 可以先空着，后续再配也可以。最后问你是否安装为系统服务（launchd），选 Y 就能开机自动启动、后台常驻：

完成 Telegram 配置

怎么查自己的 Telegram 数字 ID：在 Telegram 里给 @userinfobot 发任意消息，它会直接把你的 ID 回复给你。

申请 Telegram Bot

在 Telegram 里搜索 @BotFather，然后发送 /newbot。按提示给你的机器人取个名字，注意用户名必须以 bot 结尾。完成后就能拿到 Bot Token，格式类似于 123456789:AAxxxxxxxx。

启动成功

配置全部完成后，直接运行 hermes 启动。能看到欢迎页，说明一切顺利：

Hermes 启动成功

打开 Telegram，找到你的 Bot 发送消息测试一下：

Telegram 测试成功

手动挡安装

如果你喜欢自己动手，也可以走手工路线：

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

装依赖：

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 doctor — 诊断问题

常见问题 & 排错

Q: 提示 API call failed after 3 retries: HTTP 400: No models provided

这通常是配置文件编码问题，在 Windows 上比较常见。直接让 Claude 帮你修，把报错信息完整丢给它，它自动会定位到 cli.py 里 open() 调用那里，加上 encoding="utf-8" 参数就解决了：

Windows 编码报错修复

Q: Telegram Bot 没有响应

多半是没设置 UserId。手动配置一下就行，或者让 Claude 帮你设一下，几分钟搞定。

番外：申请 OpenRouter API Key

Hermes 支持多种模型提供商，不过推荐先从 OpenRouter 入手。原因很简单——里面免费模型多，白嫖入门最方便。

打开 openrouter.ai/keys，点击 Create Key，名字填 hermes，直接点 Create：

创建 OpenRouter API Key

Key 只显示一次，记得立刻复制保存好：

复制 API Key

Hermes 还有很多玩法没有展开——比如定时任务、自建 skills 等等。后续会再写文章详细聊。