
Step one:Hermes Agent What is it
Hermes Agent is onefree and open sourceof AI Intelligent Body(AI Agent), developed by the Nous Research team. It's not like a regular chat robot (such as ChatGPT), it's gonna:
- Remember all your past conversations
- Learn from each mission and create new skills automatically
- Help you do your job: execute orders, browse pages, write documents, manage tasks, etc
- Supporting the connection to Telegram, flybook, Discord, etc., can direct it on the phone
- The more smart the better
It's especially for people who want to have a "Personal AI Assistant" and many people migrate from OpenClaw because it learns better。
Official network document (recommended collection):
https://hermes-agent.nousresearch.com/docs/
GitHub Project:
https://github.com/NousResearch/hermes-agent
Step 2: Preparation (computer environment)
Hermes Agent supports:
- Linux (recommended, simplest)
- macOS
- Windows + WSL2 (available for Windows users)
You need:
- A computer with Internet access (preferably a terminal)
- An API Key (used to call large models, such as Grok, Claude, GPT, etc.) recommends new hands for OpenRouter (support 200+ models, more free of charge) or local models (Olama), but new hands first use cloud API more stable
A simple way to get API Key (as in OpenRouter):
- go to https://openrouter.ai/registered account number
- It's worth a little
- Copy your API Key in dashboard
Step 3: Install Hermes Agent
Open your terminal (command line):
- Mac/Linux: Open directly Terminal
- Windows: recommends installation of WSL2 (search for "Windows Installer WSL") and then operate in Ubuntu; or direct test PowerShell (some tutorial support)
Copy the following command, one-click installation (30 seconds or so):
you're gonna have to go back to work
https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh
After installation, refresh the environment (important!):
~/.bahrc
# If you are a zsh user, use the following line:
~/.zshrc
Validate installation success: input
shemes-help
It works when you see the help
Step 4: First Configuration ( Feeding Wizard)
Enter the following command to start the configuration wizard:
she's setup
It'll ask you step by step:
- Select Model Provider
- Enter your API Key
- Select the default model (recommended by beginner: Claude Sunnet / GPT-4o / or a cheap and good model in OpenRouter)
- configure tools (tools) - defaultly start a common tool
After the configuration, you can change the model at any time with the following command:
♪ hermes model ♪
Step 5: Start chatting
Enter at terminal:
shemes
Then you can talk to your AI Agent
For example, try input:
- "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):
- Open Telegram, search
- send /newbot
- Name the robot and the user
- 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。