跳至主要內容

Hermes Agent 免费安装使用指南：从零搭建你的自进化 AI Agent

博客Hermes AgentNous ResearchOpen Source AIAI AgentFree AI大约 11 分钟

Hermes Agent 免费安装使用指南：从零搭建你的自进化 AI Agent

Hermes Agent 是几周前进入我视野的。翻了翻 GitHub 仓库（37.5k star，MIT 协议，Nous Research 出品），我发现它有一个大多数 AI Agent 都不具备的能力：越用越好。不是那种玄乎的"模型会自我进化"——它是真的从你跟它的交互中积累技能，记住哪些方法管用，然后不断打磨这些技能。光这一点就值得试试。

真正打动我的是：它能在 $5 的 VPS 上跑。不需要 GPU（当然你想加也行）。而且能接入 Telegram、Discord、Slack、WhatsApp 等十几个平台。我们推荐用 LightNode 作为 VPS 提供商——按小时计费最低 $0.013/小时，拿来折腾自托管 AI 性价比拉满。

目录

  1. Hermes Agent 到底能干嘛
  2. 系统要求
  3. 安装
  4. 配置免费模型提供商
  5. 配置
  6. 第一次对话
  7. 接入聊天平台
  8. 值得了解的核心功能
  9. 常见问题排查
  10. 总结

Hermes Agent 到底能干嘛

大多数 AI Agent 的套路都一样：你发个 prompt，它跑几个工具，返回结果，然后全忘了。Hermes Agent 走了一条不同的路。它内置了一个学习循环：

  1. 你给它一个任务
  2. 它分析需要什么技能
  3. 如果对应的技能不存在，它会自动创建一个
  4. 用这个技能执行任务，评估结果，把管用的方法存下来
  5. 下次遇到类似任务，直接调用打磨过的技能

这意味着这个 Agent 是真的在使用中进步，不是靠底层模型更新才变强。你自己的工作流、你自己的代码库、你自己的操作习惯——它都能学到。

除了学习循环，Hermes Agent 还自带 47 个内置工具，支持 MCP（Model Context Protocol）集成来扩展能力，能把任务委派给子 Agent。它还有定时任务调度器和语音模式，想解放双手的话可以用语音交互。

系统要求

安装之前，确认你的系统满足这些基本条件：

  • 操作系统：Linux（推荐 Ubuntu 20.04+）、macOS（12+）或通过 WSL2 运行的 Windows
  • Python：3.10 或更高版本
  • 内存：最低 2GB，推荐 4GB
  • 磁盘：Agent 本身大约需要 500MB
  • 网络：需要联网调用模型 API

Android 用户用 Termux 也可以。Windows 原生不支持，得走 WSL2。

如果是部署到 VPS，$5/月、1 vCPU + 1GB RAM 的机器轻度使用完全够。负载重的话（同时跑多个聊天平台、频繁的定时任务），建议 2GB 以上。

安装

Hermes Agent 有两种安装方式。快速安装全自动搞定，手动安装则给你更多控制权。

方式一：一键安装（推荐）

打开终端，运行：

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

这个脚本帮你搞定一切：检查依赖、创建虚拟环境、克隆仓库、安装依赖包、运行初始配置向导。在一台全新的 Ubuntu 机器上，整个过程大概 2-3 分钟。

装完后，验证一下安装：

hermes --version

应该会打印出版本号。如果提示 "command not found"，重启一下 shell 或者执行 source ~/.bashrc（用 zsh 的话是 ~/.zshrc）。

方式二：手动安装

如果你想知道机器上到底装了什么，或者一键脚本出了问题：

# 克隆仓库
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# 创建并激活虚拟环境
python3 -m venv venv
source venv/bin/activate

# 安装依赖
pip install -r requirements.txt

# 运行配置向导
python setup.py

配置向导会引导你选择模型提供商、输入 API 密钥和基本配置。之后随时可以用 hermes setup 重新运行。

配置免费模型提供商

Hermes Agent 不自带模型，它连接外部提供商。好消息是：好几个提供商都有免费额度，可以直接用。

选项一：OpenRouter（最容易上手的免费方案）

OpenRouter 提供 200 多个模型的访问，其中好几个是免费的。这是我推荐的起步方案。

  1. 在 openrouter.ai 注册账号
  2. 在控制台 生成 API 密钥
  3. 找免费模型——在模型目录里找标了 "free" 的模型

OpenRouter 上常见的免费模型包括 Llama、Mistral、Qwen 的多个版本。免费模型会轮换，记得去看看当前有哪些。

在 Hermes Agent 的配置向导里选 "OpenRouter" 作为提供商，然后粘贴你的 API 密钥就行。

选项二：Nous Portal

Nous Research 自己运行了一个推理服务。新用户偶尔会有免费额度，而且上面的模型专门针对 Agent 工作负载做了调优。

  1. 访问 nousresearch.com 注册
  2. 在控制台查看是否有免费额度
  3. 用提供的 API 密钥配置 Hermes Agent

选项三：其他提供商

Hermes Agent 还支持：

  • z.ai / GLM：国内 AI 平台，有免费额度
  • Kimi / Moonshot：另一个选择，有有限的免费用量
  • MiniMax：轻度使用有免费额度
  • 任何兼容 OpenAI 的接口：如果你有其他提供商的访问权限，也可以直接接入

配置自定义接口需要 base URL 和 API 密钥。配置向导可以处理这个，你也可以直接编辑配置文件（下一节会讲）。

配置

Hermes Agent 的配置文件在 ~/.hermes/config.toml。运行配置向导后，你会看到类似这样的内容：

[model]
provider = "openrouter"
api_key = "sk-or-v1-..."
model = "meta-llama/llama-3.3-70b-instruct:free"

[agent]
name = "Hermes"
memory = true
skills_dir = "~/.hermes/skills"

[messaging]
# 在这里配置聊天平台
# telegram_token = ""
# discord_token = ""

关键配置项

模型设置：随时可以切换模型或提供商。想试试 OpenRouter 上其他免费模型，直接改 model 字段。也可以整个换提供商——把 provider 改成 "openai" 或 "nous"，然后更新 API 密钥。

记忆：保持 memory = true。这是学习循环的关键。Agent 会把对话历史和技能优化记录存在 ~/.hermes/memory/ 里。

技能目录：学到的技能保存在这里。你可以浏览 ~/.hermes/skills/ 看看 Agent 学到了什么。技能以 JSON 文件存储，想手动微调也行。

从命令行切换模型

不用每次都编辑配置文件。Hermes Agent 有内置命令：

# 列出当前提供商可用的模型
hermes model list

# 切换到指定模型
hermes model set meta-llama/llama-3.3-70b-instruct:free

# 查看当前使用的模型
hermes model show

健康检查

改完配置后跑一下这个，确认一切正常：

hermes doctor

它会检查 API 密钥、模型可用性、网络连接和技能系统状态。如果有什么不对，会直接告诉你怎么修。

第一次对话

配置好后，启动一个会话：

hermes chat

这会打开一个交互式 REPL。先试个简单的：

You: What tools do you have available?
Hermes: I have access to 47 built-in tools including:
- file_read / file_write (file operations)
- shell_exec (run shell commands)
- web_search / web_fetch (web access)
- code_search (search codebases)
- calendar / reminders (scheduling)
- ...and more. I can also use MCP tools if configured.

然后给它一个真正的任务：

You: Create a Python script that monitors a directory for new files and logs their names to a file called new_files.log

Hermes: I'll create that for you.
[creates watch_dir.py with inotify or polling-based implementation]
[tests the script]
The script is ready at ./watch_dir.py. Run it with python watch_dir.py /path/to/watch

第一次提需求时，Agent 会从零开始构建技能。之后再提类似任务，它会直接用打磨好的版本。跑几轮之后去看看技能目录，你就能看到效果了。

接入聊天平台

Hermes Agent 的一个亮点是多平台支持。你可以通过 15+ 个聊天平台跟它对话，不光是命令行。

接入 Telegram

  1. 在 Telegram 上找 @BotFather 创建一个新 bot
  2. 复制 bot token
  3. 添加到配置：
hermes gateway add telegram --token "YOUR_BOT_TOKEN"
  1. 启动网关：
hermes gateway start telegram

现在你可以直接在 Telegram 里跟你的 Agent 聊了。它跟命令行会话共享相同的记忆和技能。

接入 Discord

  1. 在 Discord 开发者平台 创建一个 bot
  2. 开启 Message Content Intent
  3. 复制 bot token
  4. 配置：
hermes gateway add discord --token "YOUR_BOT_TOKEN"
hermes gateway start discord

其他支持的平台

所有平台的操作方式都一样。用 hermes gateway add <platform> 加上对应的凭证：

  • Slack：需要一个带 bot 权限的 Slack App
  • WhatsApp：用 WhatsApp Business API 或非官方桥接方案
  • Signal：需要 signal-cli
  • Matrix：需要一个 Matrix bot 账号
  • Mattermost：个人访问令牌
  • Email：IMAP/SMTP 凭证
  • SMS：Twilio 或类似服务
  • 钉钉 / 飞书 / 企业微信：国内聊天平台

运行 hermes gateway list 查看所有可用平台及其状态。

值得了解的核心功能

技能中心

Hermes Agent 有一个社区技能仓库。可以浏览和安装别人做好的技能：

# 浏览可用的社区技能
hermes skills browse

# 安装指定技能
hermes skills install web-scraper

# 列出已安装的技能
hermes skills list

不想等 Agent 从零学起的话，这个功能很实用。常见任务像网页抓取、API 测试、文档解析，大概率已经有人做好了现成的技能。

定时任务

不用外部 cron，直接在 Agent 内部设置定时任务：

hermes cron add "0 9 * * *" "Summarize yesterday's git commits and post to #dev-channel"

Agent 内部处理调度，用已有技能执行任务。

语音模式

想解放双手的话：

hermes chat --voice

这会用你的系统麦克风和扬声器。跟支持音频输入的模型配合效果最好，不过也可以走本地的语音转文字方案。

子 Agent 委派

面对复杂的多步骤任务，Hermes Agent 可以启动子 Agent：

You: Research the top 5 VPS providers, compare their pricing, and create a summary document

Hermes: I'll delegate this to subagents for parallel research.
[spawns subagents for each provider]
[collects results]
[generates comparison document]

子 Agent 跟父 Agent 共享记忆和技能系统，所以能直接利用主 Agent 积累的所有经验。

常见问题排查

"command not found: hermes"

安装脚本把 Hermes 加到了你的 PATH 里，但当前 shell 可能没刷新。执行：

source ~/.bashrc  # 或 ~/.zshrc

如果还不行，检查 ~/.local/bin/hermes 是否存在，然后手动加到 PATH：

export PATH="$HOME/.local/bin:$PATH"

API 密钥报错

先跑 hermes doctor。它会告诉你 API 密钥是不是无效、过期了，或者选的模型不可用。常见修复方法：

  • OpenRouter：在 openrouter.ai/keys 检查你的密钥
  • 免费模型可能有速率限制——换一个免费模型试试
  • 确认 API 密钥末尾没有多余的空格

模型没响应

免费额度模型有用量上限。遇到了就切换：

hermes model list    # 看看还有哪些可用
hermes model set <different-free-model>  # 切换

内存占用过高

如果 Agent 的记忆增长太大（用 du -sh ~/.hermes/memory/ 查看），可以清理旧记录：

hermes memory prune --older-than 30d

这会保留最近的交互和技能，但删除 30 天前的对话日志。

网关连接问题

聊天平台的话，先确认网关进程在跑：

hermes gateway status

如果网关频繁断开，检查网络然后重启：

hermes gateway restart telegram

总结

Hermes Agent 做到了其他开源 Agent 没搞好的事：它真的能从你的使用模式中学习，越用越强，不需要你手动定义工作流或写自定义插件。技能系统是真正的杀手锏——第一次做要 10 分钟的任务，第五次可能只要 30 秒。

在便宜硬件上运行、连接免费模型提供商，意味着你可以几乎零成本地 24/7 跑一个个人 AI Agent。接到 Telegram 或 Discord 上，你就拥有了一个随时在线的助手，它记得你的偏好、你的代码库、你的工作流。

上手步骤：

  1. 选一台 VPS（或者用本地机器）——LightNode 挺合适的
  2. 跑一键安装脚本
  3. 注册 OpenRouter，选一个免费模型
  4. 开始聊天

GitHub 仓库 有详细文档，社区也很活跃。给它一个周末的时间——到周一，你的 Agent 就已经开始为你的工作积累专属技能了。

专注全球VPS服务器推荐。