Hermes Agent complete course, zero basic pedestal guide

Step one:Hermes Agent 到底是什么？

Hermes Agent 是一个Open Sourceof AI Agent（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（推荐，最简单）
• macOS
• Windows + WSL2（Windows 用户可以用这个）

你需要：

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

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

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

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

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

• Mac/Linux：直接打开 Terminal
• Windows：推荐安装 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 聊天了！

比如试试输入：

• "Hello, introduce yourself."
• Help me search for today's weather
• "create a folder called test and write a hello.txt file"

It'll use tools to do your job, and it'll remember this conversation。

Step six: Put it on the phone. Connect Telegram or Flying Book)

So you can always direct it on the phone。

Take Telegram as an example (simple):

1. Open Telegram, search
2. send /newbot
3. Name the robot and the user
4. BotFather will give you a Bot Token, copy it

Enter at the terminal:

♪ hermes gateway ♪

Or set up Telegram Token with a configuration command。

Specific configurations can be entered:

here's your token

Launch gateway:

i'm sorry

Then search your robot in Telegram and start talking! It'll be 24/7 online。

Flying books have similar access to official documents and a lot of hands-on courses。

Step 7: Common commands

• heremes poach into interactive chat
• hermes setup one-stop configuration wizard
• hermes model → switch model
• hermes tools configuration available tools
• set a single configuration for hermes config set KEY values
• if you used to use OpenClaw, you could move data by one

Step 8: Common White Issues & Recommendations

Installation stuck

• It'll be a lot of downloads for the first time

No. What about API Key

• It's free of charge, or a local Ollama (but it needs a good computer)。

Think 24/7's been on line

A cheap VPS (Digital Ocean, Ariyun, telecommunication cloud 5-10/month) is offered for installation on VPS。

You want to learn more

• Official document: YouTube/B searches for "Hermes Agent" or "Hermes Agent Flying Books" with many videos starting with simple tasks: it helps you organize documents, monitor RSS, write weekly newspapers, etc
• https://hermes-agent.nousresearch.com/docs/

Moving from OpenClaw

• directly using hermes claw migrate command, very smooth。