首页/极客周刊/Hermes Agent 安装教程:看完就能去闲鱼接单
教程实战HermesAI Agent安装教程开源OpenClaw

Hermes Agent 安装教程:看完就能去闲鱼接单

2026年4月11日更新于 2026年4月11日
Hermes Agent 安装教程:看完就能去闲鱼接单

Hermes Agent 安装教程来了,自动挡安装脚本全平台支持,还有免费模型可用。想吃这波红利的,可以动手了。

Hermes Agent 必定是新一代的 OpenClaw,想想前一段时间多少人在闲鱼吃到 OpenClaw 的红利,接下来你也可以吃到 Hermes 的红利。

Hermes 是 Nous Research 出的开源 AI Agent 框架,支持自建学习循环(会从使用中积累技能)、接入 15+ 模型提供商、跨平台消息集成(Telegram / Discord / Slack / WhatsApp)。

自动挡安装

在 Mac 或者 Linux 环境,在终端输入如下命令后回车:

安装命令

Windows 环境,在 PowerShell 中输入:

PowerShell安装

脚本会自动检测并安装 Python、Node.js、Git、ripgrep 等所有依赖,耐心等待即可:

安装中

配置向导

安装完成后会自动进入配置向导,选第一项 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配置

接着设置 Allowed user IDs(填你自己的 Telegram 数字 ID,不填则任何人都能用你的 Bot),Home Channel ID 可以留空后续再配。最后问是否安装为系统服务(launchd),选 Y 可以开机自启、后台常驻:

启动成功

怎么查自己的 Telegram 数字 ID:在 Telegram 里给 @userinfobot 发任意消息,它会回复你的 ID。

申请 Telegram Bot

  1. 在 Telegram 搜索 @BotFather
  2. 发送 /newbot,按提示取名(用户名必须以 bot 结尾)
  3. 拿到 Bot Token,格式类似 123456789:AAxxxxxxxx

启动成功

配置完成后运行 hermes 启动,欢迎页说明一切正常:

Hermes启动成功

打开 Telegram,找你的 Bot 发消息测试即可。

手动挡安装

克隆项目:

克隆项目

安装依赖:

pip install -e .

运行:

hermes setup

手动挡和自动挡用法完全一样,适合想改源码或固定版本的场景。

基本使用

基本命令

  • 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" 参数。

Q: Telegram Bot 没有响应

没有设置 UserId,手动设置或者让 Claude 设置下就行。

番外:申请 OpenRouter API Key

Hermes 支持多种模型提供商,推荐先配 OpenRouter——有大量免费模型可用,白嫖入门最方便。

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

创建API Key

Key 只显示一次,立刻复制保存好。


Hermes 还有很多玩法没展开:定时任务、自建 skills……后续会继续写。觉得有用就收藏,不定期分享 AI 工具的实际用法,不讲概念,只讲能上手的。