← Home

Hermes Agent Hub

Hermes Agent: The Complete Guide

Hermes Agent is the open-source AI agent framework from Nous Research. It runs on your own hardware, talks through Telegram, Discord, WhatsApp, and a built-in web UI, uses any mainstream LLM provider, and ships with skills, memory, and a scheduler. Everything you need to understand it, install it, and ship it is here.

What Is Hermes Agent?

Hermes Agent is an open-source AI agent runtime. It pairs an LLM with a set of built-in channels, tools, and skills so you can deploy a personal AI — one that chats, remembers, runs code, browses the web, and works across Telegram, Discord, WhatsApp, Slack, and a web UI.

The project is maintained by Nous Research and sits alongside their Hermes model series. The model and the agent share a name but are separate things: the models are LLMs you can run anywhere; the agent is the harness that gives an LLM (any provider) a real job.

What You Can Actually Do With It

  • Multi-channel chat — Telegram, Discord, WhatsApp, Slack, WebSocket, and a web UI, all from one config.
  • BYO model — any provider with an OpenAI-compatible API: Anthropic, OpenAI, Google, DeepSeek, Groq, Moonshot, OpenRouter, Ollama, vLLM, and more.
  • Skills — web search, shell, file ops, image gen, and a growing catalog of community extensions.
  • Memory — cross-session recall that builds up over time, with a dedicated memory browser in the web UI.
  • Approvals — force the agent to wait for your OK before running shell commands or writing files.
  • Scheduling — cron-style triggers so the agent can do recurring work unattended.

Hermes Agent vs OpenClaw

Both are chat-first AI agent frameworks with overlapping feature surfaces. Quick mental model:

  • OpenClaw — larger plugin ecosystem (3,200+ ClawHub skills), heavier config, more mature multi-channel support, originated in the personal-assistant space.
  • Hermes Agent — leaner, closer to the Nous Research model research ecosystem, strong on local/self-hosted deployment.

If you want the full rundown: OpenClaw vs Hermes Agent comparison and Deploy Hermes vs OpenClaw Launch.

How to Install Hermes Agent

Docker Compose (easiest)

One YAML, one docker compose up -d, gateway online. Copy-paste recipe, volume layout, TLS with Caddy, and the gotchas to avoid are in the Hermes Agent docker-compose guide.

Direct Docker

If you prefer raw docker run, the deploy Hermes Agent guide covers single-container setup, environment variables, and the credentials directory that Telegram silently needs.

Managed (skip the ops)

Hermes hosting on OpenClaw Launch runs the same Hermes gateway on managed infrastructure: warm-pool deploys, auto-TLS, backups, 10-second deploy, $3 first month, $6/mo after. Same configuration, same channels, same skills — no VPS.

The Web UI

Hermes ships a browser dashboard on the gateway port (default http://localhost:8642/ui). Inside you get a chat pane with tool-call introspection, a skills manager, an approvals queue for sensitive actions, a memory browser, and live logs.

Full walkthrough including how to reach it from your phone, the auth model, and the security pitfalls: Hermes Agent web UI guide.

Memory

Hermes has persistent memory baked in — the agent remembers prior conversations across restarts, can build up a profile of whoever it talks to, and lets you inspect or edit what it remembers. Storage layout, backup strategy, and how to tune recall quality: Hermes Agent memory guide.

Common Questions

Is Hermes Agent free?

The framework is open source. Running it locally is free. You pay for whichever LLM provider you plug in (or zero, if you run local models via Ollama or vLLM). Managed hosting on OpenClaw Launch is $3 first month, $6/mo after.

Does Hermes Agent work with my model?

Almost certainly yes. Anything with an OpenAI-compatible chat completions API works, which covers Anthropic (Claude), OpenAI, Google (Gemini), DeepSeek, Groq, Moonshot, Zhipu, vLLM, Ollama, OpenRouter, and most custom inference endpoints.

Telegram / Discord / WhatsApp?

All three are first-class channels. Bring your own bot token, set dmPolicy: "pairing" for Telegram (so random strangers can't use your bot), and you're live. The deploy guide covers each channel's quirks.

Is Hermes Agent the same as the Hermes LLM?

No. Nous Research makes both, but they're separate projects. The Hermes model series (Hermes 4, Hermes 3, etc.) are LLMs you can run with any agent framework. The Hermes Agent is a runtime that can use any LLM, not just the Hermes models.

Every Hermes Guide in One Place

The Chinese-Language Hub

Looking for Chinese documentation? Hermes Agent 中文介绍 covers 什么是 Hermes Agent,和 OpenClaw 的区别、安装、Web UI、飞书接入 in full.

Skip the Ops, Keep the Hermes

Deploy a managed Hermes Agent gateway in 10 seconds. Same features, zero server setup.

Hermes Hosting