Hermes Agent Tutorial

  • 44 min
Hermes Agent Tutorial Plays from YouTube

A free, step-by-step tutorial by Ferdy. Watch it right here or on YouTube.

Text To Copy And Paste In Your Terminal

cd /docker/hermes-agent-

docker compose exec -it hermes-agent /bin/bash

hermes setup



Let OpenRouter automatically choose the best model for each task

/model openrouter/auto

Hermes Agent tutorial: set up your own AI agent with Telegram

I have been using the Hermes AI agent for a while now and three things stand out. First, the cost: I pay a fraction of what I paid with OpenClaw. Second, skills: Hermes writes its own skills and improves them over time, which is safer than installing skills from other people. Third, it grows with you. The more you work with it, the better it understands you.

In this tutorial I set up Hermes on a VPS, connect it to Telegram, let OpenRouter pick the right AI model, and then show four real use cases: daily trend reports, YouTube research, making a website ready for SEO and AI search, and drafting replies to my emails.

What you need

  • A VPS to run the agent 24/7. I use Hostinger’s one-click Hermes hosting.
  • An OpenRouter account with some credits and an API key
  • Telegram (free) on your phone or computer
  • The commands at the top of this page

Hermes itself is free and open source. You only pay for the server and for the AI model credits it uses.

Step 1: Get a VPS with Hermes

  1. Go to the Hermes hosting page and click Choose plan. Pick KVM 1. It has handled everything I wanted to do with Hermes, and you can upgrade later.
  2. Enter the coupon code FERDY for an extra 10% discount and choose a period. Longer periods give more discount. There is a 30 day money back guarantee.
  3. Register, fill in your details and pay.
  4. In the Hostinger panel, save the password it shows you somewhere safe and click Deploy.

You land in the Docker Manager. Think of your VPS as a box with containers: one can run OpenClaw, one Hermes, and a Traefik container keeps the others safe. Already have a Hostinger VPS? Go to Docker Manager, Compose, One-click deploy, search for Hermes Agent, select it and deploy.

Step 2: Run the Hermes setup with OpenRouter

Click Terminal. It looks old fashioned, but you only have to type or paste what I do. Use the commands at the top of this page: first go to the Hermes Docker folder (add the four characters that belong to your container), then open the container, then type hermes setup. Choose the quick setup.

Hermes asks which provider to use. You can pick Anthropic or OpenAI, but I choose OpenRouter. It has all the models in one place and you can switch between them easily.

  1. Create an account at OpenRouter and verify your email.
  2. Click Buy credits, add a payment method and a starting amount. I started with $25, which is more than enough to begin.
  3. Go to API keys, create a key called Hermes. You can set an optional monthly credit limit, so it stops when you reach it.
  4. Copy the key, keep it private and paste it in the terminal. You will not see anything appear, because it is treated like a password. Press Enter.
  5. Choose a model. The more expensive, the more powerful. For the setup I picked DeepSeek, the cheapest one that is not free.

Step 3: Connect Hermes to Telegram

  1. Choose Set up messaging and select Telegram (Discord, Slack and Matrix are also options).
  2. In Telegram, search for BotFather, create a new bot, give it a name and a username that ends in “bot”. I called mine Walter White.
  3. Copy the bot token and paste it in the terminal.
  4. Hermes asks for allowed user IDs. Do not skip this, or anyone who finds your bot can chat with it on your credits. Search Telegram for the userinfobot, start it, copy your ID and paste it.
  5. Type hermes to start the agent. Then run hermes gateway install and hermes gateway run to link the terminal with Telegram.
  6. Open your bot in Telegram. If it says “unknown command start”, that is fine. Just type hello.

To save money, let OpenRouter pick the model per task with the /model openrouter/auto command at the top of this page. You do not need the most expensive model to chat. In the end I stayed with DeepSeek V4 Pro, one of the cheapest, and it did everything I asked.

Step 4: Put your agent to work

Daily trending GitHub projects

As a YouTuber I want to be early with new tools. I asked my agent for a daily overview at 8 a.m. of GitHub projects that gained the most stars in 24 hours, ranked by potential for a great tutorial. It set up a cron job. Then I improved it: use the daily stars from github.com/trending and give me a top three instead of a top ten.

Trending YouTube videos

A second cron job shows me on Mondays, Wednesdays and Fridays the top five trending videos about AI and making websites from the last 48 hours, with a short explanation of why each one performs so well.

Make a website ready for SEO and AI search

In WordPress, go to Users, Edit Profile and create an application password. That way you never share your real login. I gave Hermes the login URL, the application name and the password and asked it to make my website future proof for SEO and AI. It created an llms.txt file, added schema, improved SEO titles and descriptions, and created its own WordPress SEO skill that gets better with every website. Want to do this yourself? Try the SEO and AI search prompt.

Draft replies to your emails

I get many collaboration emails. I gave Hermes access to my webmail and told it: reply friendly and respectfully, every day at 7 a.m. show me yesterday’s emails, and never send anything, only save drafts. It figured out how to create drafts by itself. I open them in my mail app, adjust them a little and send them. I also told it to stop using the long dashes that make text look AI written.

Tips: costs and safety

  • Check your usage in OpenRouter under Activity now and then. A short test with a pricier model cost me more than a full day on DeepSeek. After about a month of cron jobs on DeepSeek I had spent only a few dollars (in the video it was $3.85).
  • Always restrict your bot to your own Telegram user ID.
  • Never let your agent send emails without your approval. Drafts only.
  • If you share a password with your agent in a chat, change it afterwards.
  • Not sure what to do with your agent? Ask it: “How can I make the best use of you in my business?”

Frequently asked questions

Is Hermes AI free?

Yes, Hermes is free and open source. You pay for the place it runs, like a VPS, and for the credits of the AI model it uses.

What is the difference between Hermes and OpenClaw?

Both are AI agents. For me Hermes is much cheaper to run, and it writes and improves its own skills instead of relying on external skills that could contain malware. If you want to try OpenClaw too, Hostinger also has OpenClaw hosting.

Can I run Hermes on my own computer?

Yes, on your computer or a spare one. I prefer a VPS because it is online 24/7, so cron jobs keep running when my laptop is off.

Why does my bot say “unknown command start”?

Hermes does not use the /start command. Nothing is broken. Just send a normal message like hello.

Leave your comment

Your email address will not be published. Required fields are marked *

Never miss
a tutorial

Every tutorial lives on YouTube. Subscribe and never miss a new one.

Black Friday A full year of Hostinger web hosting + free domain for about $30 with coupon code FERDY1 year hosting + free domain: about $30 with code FERDY Ends Dec 14 Get the deal Ad