Hermes Agent 不完全指南：从入门到放弃（新手友好版）
Meta Description：2026 年 Hermes Agent 完整安装教程，手把手带你从零开始配置 Hermes Agent，接入 Telegram，了解核心特性与 OpenClaw 差异。新手友好，含费用参考和安全性说明。说实话，这篇文章就是写给两种人的：一种是完全没碰过命令行的纯新手，另一种是从 OpenClaw 想迁移过来的老用户。我踩过这个坑，所以手把手带你从零开始，装好 Hermes Agent，接入 Telegram，把核心玩法一次讲清楚。
🤔 Hermes Agent 是什么？
Nous Research 今年 2 月底才开源的 AI Agent 框架，上线不到两个月就冲到 35K star。说实话，这个增长速度让我有点意外——通常这种工具得养半年才有人用，Hermes 属于例外🚀。
大多数人用 AI 的方式是：打开网页、输入问题、等它回答、关掉窗口。Hermes 的定位不是这个，它是部署在服务器上、24 小时替你干活的数字员工。你关掉电脑，它还在跑；你睡着了，它还在处理任务。这是从"聊天工具"到"基础设施"的思路转变，理解这一点，才能真正用好它。
核心差异一句话：会自己变聪明。完成复杂任务后自动提炼成可复用技能（Skill）存起来，下次直接调用，还会随使用次数持续调优。有用户反馈两小时内自动生成三份技能后，重复任务速度提升了 40%。
底层用 Python 写的，OpenClaw 是 JS，AI 时代大多数工具和模型库都是 Python 生态，想改源码、加自定义工具、对接本地模型，Hermes 的门槛更低。
模型推荐用 OpenRouter，有免费模型可用，零成本上手。
⚠️ 重要更新：Anthropic 4 月 7 日起调整政策，Hermes 等第三方工具不再走订阅额度，改为按量单独计费。建议优先用 OpenRouter 免费模型。
📋 开始之前
1. 系统支持情况
| 系统 | 支持情况 | 备注 |
|---|---|---|
| Linux | ✅ 原生支持 | 推荐 Ubuntu 20.04+ |
| macOS | ✅ 原生支持 | - |
| Windows | ⚠️ 需 WSL2 | 先装 WSL2 再操作 |
💡 Windows 用户：需要先安装 WSL2，再在 WSL2 环境里按本教程操作。可在微软官方文档搜索「安装 WSL」，按步骤装好后回来继续。
2. 确认 Git 已安装
打开终端，输入：
git version 能看到版本号（如 git version 2.x.x）就没问题。如果提示 command not found，先去 git-scm.com 下载安装。
3. 准备好大模型 API Key
Hermes 支持接入 Claude、OpenAI、OpenRouter 等主流模型。安装时会引导你选择和配置，提前备好 Key 就行。
🔧 第一步：安装
打开终端（Windows 用户在 WSL2 里操作），执行：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash 脚本会自动完成所有准备工作：
- 检测并安装 Python / Node.js / Git / ripgrep 等依赖
- 克隆仓库
- 创建全局 hermes 命令
⚠️ 网络提示：要安装的东西比较多，网络不好的话多等一会儿，不要中途关掉终端。
安装完成后，脚本会自动进入引导设置，选择 Quick setup 模式，然后按提示配置模型。推荐选 OpenRouter，进入后可以选免费模型（如 google/gemma-4-31b-it:free），零成本跑起来先体验。
如果之前本地已有 OpenAI 或 Codex 的授权配置，Hermes 会自动读取，不用重复填写。
配置最后会询问是否注册为系统服务，选 Y 可以开机自启、后台常驻，省去每次手动启动的麻烦。
如果你暂时不想配置聊天平台，选择跳过（Skip），直接在终端里输入：
hermes 能看到对话界面，说明安装成功了，可以直接在命令行里开聊。
⚠️ 如果提示找不到 hermes 命令：先执行 `source ~/.bashrc` 或 `source ~/.zshrc` 刷新一下 shell 环境，重新打开终端也行。
实际体验下来，安装确实比 OpenClaw 方便，一次就配置成功了✌🏻
别误会，我不是说 OpenClaw 不好，只是我亲眼见过太多人在安装阶段就放弃了。Hermes 这个一键脚本确实省事儿。
💬 第二步：接入 Telegram
💡 提示：如果你只想用命令行和 Hermes 交互，这一步可以跳过。想在手机或电脑的 Telegram 里聊，才需要配置。
2.1 先去 Telegram 创建一个 Bot
1. 打开 Telegram，搜索 BotFather（官方账号，蓝色认证标）
2. 发送 `/newbot`
3. 根据提示依次输入 Bot 的显示名称（Name）和用户名（Username，必须以 bot 结尾）
4. 创建成功后，BotFather 会返回一串 HTTP API Token，复制保存好
2.2 回到终端配置
如果安装时跳过了 IM 配置，可以随时重新运行：
hermes gateway setup 在引导界面选择 Telegram，将刚才复制的 Bot Token 粘贴进去。
⚠️ 注意：粘贴 Token 时终端不会显示任何内容，这是正常的安全设计，直接按回车确认就行。
第一次遇到这种情况别慌，我刚开始也以为终端卡死了，其实是在保护你的密钥。
接着需要填写你自己的 Telegram 数字 ID（Allowed User ID）。查询方法：在 Telegram 里给 @userinfobot 发任意一条消息，它会立即回复你的账号 ID，复制那串数字填进去即可。不填则任何人都能使用你的 Bot。
2.3 完成配对
配置完成后，终端会给出一条命令，复制执行，然后打开 Telegram 找到你刚创建的 Bot，发一条消息，能收到回复就说明配对成功了。
📱 其他聊天平台：飞书、企业微信、钉钉、Discord、WhatsApp 等平台的配置方式与 Telegram 大同小异，都在引导菜单里可以找到。
✅ 第三步：验证安装
运行以下命令做一次全面检查：
hermes doctor 输出全绿就说明 Hermes 运行正常，依赖和配置都没问题。如果有报错，它会提示具体是哪里出了问题。
🚀 核心特性
Skills 自动生成
完成一个复杂任务后，Hermes 会把整个执行过程沉淀成一份 Markdown 技能文档存起来，下次遇到类似任务直接调用。它还会记录每个 Skill 的调用次数和执行过程，到一定次数自动调优——技能真的会越用越好，不是说说而已。
分层记忆
核心信息常驻 MEMORY.md，每次对话都带着；历史对话全量存 SQLite，按需检索召回，容量没有上限。OpenClaw 是每次任务都把历史上下文塞进 prompt，记得越多烧得越多。Hermes 按需召回，用得越久成本反而稳定。
透明化执行
IM 里能看到 toolcall 过程，知道 agent 每一步在干什么，OpenClaw 这块是黑盒。另外支持 Profiles，可以同时跑多个隔离的 Agent 实例。
语音交互
CLI 里按 Ctrl+B 录音，Telegram / Discord 里可以直接语音对话，Discord 甚至能让 Agent 加入语音频道实时监听回话。支持本地 Whisper（免费）或 Groq 做语音识别，平时用不到但有需要时是个加分项。
SOUL.md 人格定制
在 `~/.hermes/SOUL.md` 里写几行描述，就能给 Agent 定义一个跨所有平台的持久人格，说话风格、处事偏好、什么该避免。想要一个务实的工程师助手还是一个幽默的助理，完全自己决定。
总体来说，交互体验流畅，配置简洁但界面还需继续打磨。
说真的，Hermes 团队把精力都花在了核心功能上，UI 这块确实有点糙。但你要想，咱是用它干活的，不是拿来看的，对吧？
🔌 接入第三方界面
不想用命令行的话有两个选择：
Hermes WebUI：专门为 Hermes 开发的网页界面，直接对着 Agent 聊，比命令行直观不少，新手友好。
💡 VPS 用户
如果你是在 VPS 上部署，并且已经安装了 Claude 或 Codex 这类 AI 工具，可以直接把 Hermes 的官方文档或者本文扔给它，让它自动读取并帮你执行配置步骤。省去逐行粘贴命令的麻烦，尤其适合环境依赖复杂、需要反复调试的情况。
💰 费用参考
Hermes 可以号称可以跑在 5 美元/月的 VPS 上，也支持 Docker 和 serverless 方案。以下是社区实测的费用参考：
| 配置方案 | 月费用 | 适用场景 |
|---|---|---|
| 基础版（5 美元 VPS） | $5-10 | 个人轻度使用 |
| 标准版（10 美元 VPS） | $10-20 | 日常办公自动化 |
| 进阶版（20 美元 VPS） | $20-40 | 多任务并行 |
为什么同等使用强度下，Hermes 比 OpenClaw 便宜 30%-60%？
原因在架构上：OpenClaw 每次任务都把历史上下文塞进 prompt，记得越多、单次 token 消耗越大，用得越久越贵。Hermes 的记忆系统是按需召回的，成本随时间保持稳定。
⚠️ 社区高频翻车案例：忘了关 Sonnet 跑了一夜。OpenClaw 用户哭晕在厕所😄，Hermes 用户因为架构差异，翻车金额小一个数量级。
🔐 安全性
Hermes 实施了七层防御：用户授权白名单、危险命令人工审批、Docker 容器隔离、凭证过滤保护、内容注入扫描、URL 验证（防 SSRF）、预执行终端攻击检测。高风险操作默认需要人工确认，超时自动拒绝。
接入 IM 平台时，Hermes 支持配对码验证，8 位随机码，1 小时过期，5 次失败后锁定，比手动复制用户 ID 更安全。
配置上密钥和服务解耦管理，复杂度低，减少了配错把自己搞死的概率。
两个使用前需要知道的点：1. 接入 Telegram 后账号就是控制入口，账号安全 = Agent 安全，⚠️建议开启两步验证⚠️
2. Skills 持久存活会被反复调用，有问题的技能需要手动清理
💡 技能文件存在本地，可以随时打开查看和删除；`hermes doctor` 可以定期检查运行状态。
❓ 常见问题
Q：🚨Claude 订阅还能用吗？4 月 7 日起 Anthropic 已调整政策，Hermes 等第三方工具不再走订阅额度，使用 Claude 需要单独按量付费。建议直接用 OpenRouter，注册后有免费模型可用，入门零成本，后续有需要再接付费模型。
Q：安装后输入 hermes 提示 command not found 怎么办？通常是 PATH 没刷新。关掉当前终端窗口，重新打开一个，再试一次。如果还不行，执行 `source ~/.bashrc` 或 `source ~/.zshrc`（取决于你用的 shell）。
Q：Windows 用户怎么办？官方明确不支持 Windows 原生运行。需要先装 WSL2（Windows Subsystem for Linux 2），然后在 WSL2 里按本教程操作，安装命令完全一样。
Q：Bot Token 粘贴进去没有任何显示，是不是出错了？没有出错，这是终端的安全机制，输入密钥类内容时不会回显。直接按回车确认即可。
Q：从 OpenClaw 迁移过来，原来的配置还能用吗？可以，Hermes 内置了迁移命令：
hermes claw migrate 会自动导入原有的技能、记忆和设置，很多命令和 OpenClaw 也大同小异。
Q：/llmwiki 是什么功能？新版本新增的功能，支持 Karpathy wiki 方案——可以快速查阅大模型相关知识，在 IM 对话里直接 /llm_wiki 触发，比手动搜索方便不少。
官方文档 👉🏻 hermes-agent.nousresearch.com/docs GitHub 👉🏻 github.com/NousResearch/hermes-agent
📢 有问题欢迎评论区留言，看到都会回。如果这篇教程对你有帮助，欢迎 关注 + 收藏 + 转发 👏🏻
