Hermes Agent安装完整教程：零基础踩坑指南

第一步：Hermes Agent 到底是什么？

Hermes Agent 是一个开源的 AI智能体（AI Agent），由 Nous Research 团队开发。它不像普通聊天机器人（比如 ChatGPT），它会：

记住你过去的所有对话（长期记忆）从每次任务中自己学习，自动创建新“技能”帮你真正做事：执行命令、浏览网页、写文件、管理任务等支持连接 Telegram、飞书、Discord 等聊天软件，在手机上就能指挥它干活越用越聪明（自我进化）

它特别适合想拥有一个“私人 AI 助手”的人，很多人从 OpenClaw 迁移过来，因为它学习能力更强。

官网文档（推荐收藏）：

https://hermes-agent.nousresearch.com/docs/

GitHub 项目：

https://github.com/NousResearch/hermes-agent

第二步：准备工作（电脑环境）

Hermes Agent 支持：

Linux（推荐，最简单）macOSWindows + WSL2（Windows 用户可以用这个）

你需要：

一台能上网的电脑（最好有终端）一个 API Key（用来调用大模型，比如 Grok、Claude、GPT 等）推荐新手用 OpenRouter（支持 200+ 模型，免费额度多）或者用本地模型（Ollama），但新手先用云端 API 更稳

获取 API Key 的简单方法（以 OpenRouter 为例）：

去 https://openrouter.ai/注册账号充值一点钱（几美元就够用很久）在 dashboard 里复制你的 API Key（一串很长的字符）

第三步：安装 Hermes Agent（最简单的一键安装）

打开你的终端（命令行）：

Mac/Linux：直接打开 TerminalWindows：推荐安装 WSL2（搜索“Windows 安装 WSL”），然后在 Ubuntu 里操作；或者直接试 PowerShell（有些教程支持）

复制下面这条命令，一键安装（30 秒左右）：

curl -fsSL  | bash

https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh

安装完后，刷新一下环境（很重要！）：

source ~/.bashrc

# 如果你是 zsh 用户，用下面这行：

source ~/.zshrc

验证安装成功：输入

hermes --help

看到帮助信息就成功了?

第四步：首次配置（喂饭式向导）

输入下面命令，启动配置向导：

hermes setup

它会一步一步问你：

选择模型提供商（Model Provider）输入你的 API Key选择默认模型（新手推荐：Claude Sonnet / GPT-4o  / 或者 OpenRouter 里的便宜好用模型）配置工具（tools）—— 默认开启常用工具就行

配置完后，你可以用下面命令随时改模型：

hermes model

第五步：开始聊天！（最简单的使用方式）

在终端输入：

hermes

然后就可以和你的 AI Agent 聊天了！

比如试试输入：

“你好，介绍一下你自己”“帮我搜索今天天气”“创建一个文件夹叫 test，并写一个 hello.txt 文件”

它会调用工具帮你做事，还会记住这次对话。

第六步：让它在手机上用（推荐！连接 Telegram 或飞书）

这样你就可以随时在手机上指挥它干活了。

以 Telegram 为例（最简单）：

打开 Telegram，搜索@BotFather发送 /newbot给机器人起名字和用户名（比如 MyHermesBot）BotFather 会给你一个 Bot Token（类似 123456:ABCDEF…），复制下来

然后在终端输入：

hermes gateway

或者用配置命令设置 Telegram Token。

具体配置可以输入：

hermes config set TELEGRAM_BOT_TOKEN 你的token在这里

启动网关：

hermes gateway telegram

然后在 Telegram 里搜索你的机器人，开始聊天！它会 24/7 在线（如果你的电脑/VPS 一直开着）。

飞书接入类似，也有官方文档，手把手教程很多。

第七步：常用命令（记住这几个就够了）

hermes → 进入交互式聊天hermes setup → 一站式配置向导hermes model → 切换模型hermes tools → 配置可用工具hermes config set KEY 值 → 设置单个配置hermes claw migrate → 如果你以前用 OpenClaw，可以一键迁移数据

第八步：小白常见问题 & 建议

1.安装卡住了？

多等一会儿，第一次会下载很多东西（网络慢的话可以用科学上网）

2. 没 API Key 怎么办？

先用免费额度，或者试本地 Ollama（但本地需要好电脑）。

3.想 24/7 一直在线？

荐买个便宜 VPS（DigitalOcean、阿里云、腾讯云 5-10 美元/月），在 VPS 上安装。

4. 想学更多？

官方文档：YouTube/B站搜 “Hermes Agent 教程” 或 “Hermes Agent 飞书” 有很多视频从简单任务开始练习：让它帮你整理文件、监控 RSS、写周报等https://hermes-agent.nousresearch.com/docs/

5. 从 OpenClaw 迁移？

直接用 hermes claw migrate 命令，很平滑。