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

推广链接说明部分链接为推广链接。通过这些链接购买时，我们可能获得佣金。下单前请向厂商核实最新价格与优惠。

本文目录

目录
Hermes Agent 到底能干嘛
系统要求
安装
方式一：一键安装（推荐）
方式二：手动安装
配置免费模型提供商
选项一：OpenRouter（最容易上手的免费方案）
选项二：Nous Portal
选项三：其他提供商
配置
关键配置项
从命令行切换模型
健康检查
第一次对话
接入聊天平台
接入 Telegram
接入 Discord
其他支持的平台
值得了解的核心功能
技能中心
定时任务
语音模式
子 Agent 委派
常见问题排查
"command not found: hermes"
API 密钥报错
模型没响应
内存占用过高
网关连接问题
总结

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

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

Hermes Agent 到底能干嘛

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

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

这意味着这个 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 多个模型的访问，其中好几个是免费的。这是我推荐的起步方案。

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

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

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

选项二：Nous Portal

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

访问 nousresearch.com 注册
在控制台查看是否有免费额度
用提供的 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

在 Telegram 上找 @BotFather 创建一个新 bot
复制 bot token
添加到配置：

hermes gateway add telegram --token "YOUR_BOT_TOKEN"

启动网关：

hermes gateway start telegram

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

接入 Discord

在 Discord 开发者平台创建一个 bot
开启 Message Content Intent
复制 bot token
配置：

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 上，你就拥有了一个随时在线的助手，它记得你的偏好、你的代码库、你的工作流。

上手步骤：

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

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