首页/极客周刊/零门槛装好 Hermes Agent:全程不到十分钟,附免费模型配置
教程实战HermesAI Agent安装教程开源OpenClaw

零门槛装好 Hermes Agent:全程不到十分钟,附免费模型配置

2026年4月10日更新于 2026年4月11日
零门槛装好 Hermes Agent:全程不到十分钟,附免费模型配置

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

自动挡安装

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

curl -sL https://hermesagent.us/install | bash

Windows 环境,在 PowerShell 中输入:

irm https://hermesagent.us/install | iex

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

配置向导

安装完成后会自动进入配置向导,选第一项 Quick setup(推荐)。

接入模型

进入 Inference Provider 配置,提示输入 OpenRouter API Key,粘贴提前申请好的 Key 后回车。

接着选择默认模型。列表里有很多免费模型,推荐选 nvidia/nemotron-3-super-120b-a12b:free,完全免费,效果不错。

配置消息平台

选 Set up messaging now,然后选 Telegram,粘贴 Bot Token(申请方式见下一节),回车确认。

接着设置 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 启动,欢迎页说明一切正常。打开 Telegram,找你的 Bot 发消息测试即可。

手动挡安装

git clone https://github.com/NousResearch/Hermes-Agent
cd Hermes-Agent
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。Key 只显示一次,立刻复制保存好。


Hermes 还有更多玩法:定时任务、自建 skills……感觉有用就收藏,不定期分享 AI 工具的实际用法,不讲概念,只讲能上手的。