Hermes Agent: The Self-Improving Open-Source AI Agent - A Complete Technical Guide & OpenClaw Migration Handbook
Published on April 6, 2026
1. Introduction
In 2026, the landscape of personal AI assistants fundamentally changed. The conversation shifted from โcan AI answer my questions?โ to โcan AI remember what it learned yesterday and do it better tomorrow?โ Stateless chatbots - even powerful ones - require users to re-explain context, re-teach preferences, and re-describe workflows session after session. The emerging category of persistent, self-improving agents aims to solve this problem by running continuously on user-controlled infrastructure, accumulating knowledge and capabilities over time.
In late March 2026, Nous Research - the AI research lab known for the Hermes family of fine-tuned LLMs - released Hermes Agent, an open-source (MIT-licensed) autonomous agent framework built around a simple thesis:
An AI agent should learn from completed work and get measurably better the longer it runs.
Hermes Agent enters a competitive space already occupied by OpenClaw (formerly Clawdbot/Moltbot), the viral personal AI assistant created by Peter Steinberger that has accumulated over 349,000 GitHub stars. This guide provides a thorough, balanced examination of Hermes Agent - what it does well, where it falls short, how it compares to OpenClaw feature-by-feature, and how to migrate if you decide to switch.
Disclaimer: Both projects are under active development and evolving rapidly. The information here is accurate as of April 6, 2026, based on primary source documentation from both projectsโ official repositories and websites.
2. What Is Hermes Agent?
Hermes Agent is a self-hosted, persistent AI agent that runs on your own server (or a $5 VPS) and connects to your messaging platforms. It is not a coding copilot bound to an IDE, nor a chatbot wrapper around a single API. According to its official documentation:
- It lives on your server - not in a vendorโs cloud. Your data, conversations, and learned skills stay on your infrastructure.
- It remembers everything - persistent memory files (
MEMORY.md,USER.md) are injected into every session. Long-term history is searchable via SQLite FTS5 with LLM-powered summarization. - It auto-generates skills - after successfully completing a complex task, the agent can synthesize the workflow into a reusable skill document following the open agentskills.io standard.
- It reaches you everywhere - a single gateway process connects the agent to Telegram, Discord, Slack, WhatsApp, Signal, Email, SMS (Twilio), Matrix, Mattermost, Home Assistant, DingTalk, Feishu/Lark, WeCom, and the terminal CLI.
Key Differentiators from Traditional Chatbots
| Aspect | Traditional Chatbot | Hermes Agent |
|---|---|---|
| State | Stateless or session-scoped | Persistent across sessions and platforms |
| Learning | None; relies on new prompts | Closed learning loop; auto-generates skills |
| Execution | Limited or no system access | Full terminal, filesystem, browser, code execution |
| Platform | Single interface (web/app) | Multi-platform gateway (14+ channels + CLI) |
| Infrastructure | Vendor-hosted | Self-hosted (VPS, Docker, local, serverless) |
| Model lock-in | Tied to one provider | Any OpenAI-compatible API; switch via hermes model |
3. Core Features & Capabilities
Persistent Memory & Closed Learning Loop
The central design principle. Hermes uses a layered memory architecture:
MEMORY.md- Environment facts and lessons learned, injected into every system prompt. Kept intentionally concise to force curation over accumulation.USER.md- User preferences, communication styles, and relationship context.- SQLite FTS5 session search - Full-text indexed conversation history with LLM summarization, enabling retrieval of relevant context from weeks or months ago.
- Honcho dialectic user modeling - An optional integration with Honcho (by Plastic Labs) for deeper user preference modeling across sessions. Honcho uses a โpeer paradigmโ and reasoning models to build high-fidelity representations of user identity, values, and mental states over time.
- Procedural memory (Skills) - Successful workflows are converted into reusable skill documents, forming the agentโs โhow-toโ knowledge base.
- Pluggable Memory Provider Interface (v0.7.0) - Memory has been transitioned to an extensible plugin system. Users can choose different backends (Honcho, vector stores, custom databases) and register them via the plugin system.
The closed learning loop operates as follows: the agent executes a task โ evaluates the outcome โ synthesizes a skill document โ stores it โ retrieves and applies the skill when a similar task recurs. Periodic โnudgeโ cycles (triggered by heartbeat prompts) trigger memory consolidation, skill refinement, and output cleanup.
Auto-Generated & Community Skills
- The agent creates skills autonomously from experience, stored as Markdown files following the agentskills.io open format. The
agentskills.iostandard uses a folder structure with a mandatorySKILL.mdfile containing YAML frontmatter metadata and Markdown instructions. Skills are designed for progressive disclosure: at startup, only thenameanddescriptionare loaded; full instructions are loaded on demand to minimize token usage. - 40+ bundled skills covering MLOps, GitHub workflows, research pipelines, and more.
- Community skills can be installed from ClawHub, LobeHub, and GitHub repositories.
- Users can trigger skills via
/skillsto list all available skills or/<skill-name>to invoke a specific one.
Multi-Platform Gateway
A single gateway process connects the agent to multiple messaging surfaces:
- Telegram, Discord, Slack, WhatsApp, Signal, Email, SMS (via Twilio), Matrix, Mattermost, Home Assistant, DingTalk, Feishu/Lark, WeCom, CLI
- Start a conversation on one platform and continue on another - the agentโs session is tied to an ID, not a specific platform.
- The gateway runs as a systemd service for always-on availability.
- Setup:
hermes gateway setup(interactive wizard) โhermes gateway(start) โhermes gateway install(systemd service). - The agent can also act as an OpenAI-compatible API server, allowing connection from frontends like Open WebUI, LobeChat, or LibreChat.
Natural-Language Cron Scheduling & Unattended Automations
- Schedule recurring tasks using natural language (e.g., โEvery morning at 8 AM, summarize my inbox and send it to Telegramโ).
- Tasks run unattended through the gateway, even when you are not actively chatting.
- Managed via
/cronor the scheduling tools.
Subagents, Parallelization & Python RPC
- The agent can spawn isolated subagents with their own conversation contexts, terminal environments, and Python RPC scripts.
- Subagents run in parallel with zero context cost to the main agent - meaning delegated tasks do not bloat the primary conversation.
- Useful for pipeline-style work: research in one subagent, code generation in another, testing in a third.
Real Sandboxing
Five execution backends with genuine security isolation:
| Backend | Description |
|---|---|
| Local | Direct execution on the host (fastest, least isolated) |
| Docker | Container-based with read-only root, dropped capabilities, namespace isolation |
| SSH | Execute on a remote machine via SSH tunnel |
| Singularity | HPC-friendly container runtime (common in academic/research environments) |
| Modal | Serverless GPU execution that costs nearly nothing when idle |
Docker-based sandboxing includes read-only root filesystems, dropped Linux capabilities, and Linux namespace isolation.
40+ Built-In Tools
Including but not limited to:
- Web search and browser automation (with the new Camoufox anti-detection backend in v0.7.0)
- Terminal and filesystem access
- Vision (image analysis) and image generation
- Text-to-speech (TTS)
- Code execution in sandboxed environments
- Subagent delegation and parallel task management
- Task planning and cron scheduling
- Multi-model reasoning (query multiple LLMs and compare)
- Memory read/write/search tools
Research Tooling
A distinguishing feature from Nous Researchโs ML research background:
- Batch trajectory generation - Run the agent against problem sets with parallel workers and checkpointing.
- Atropos RL integration - Connect to Tinker-Atropos for reinforcement learning training loops. Atropos acts as a trajectory API server coordinating environment interactions and computing advantages, while the Tinker training service handles model weights, LoRA training, and optimizer steps. This enables GRPO (Group Relative Policy Optimization) training with LoRA adapters directly through the agentโs tool interface.
- ShareGPT export - Export trajectories with compression for fine-tuning datasets.
Supported Models
Hermes Agent is model-agnostic. Switch providers with hermes model - no code changes:
- Nous Portal - OAuth-based access to Nous-hosted models
- OpenRouter - 200+ models via API key
- z.ai/GLM, Kimi/Moonshot, MiniMax
- OpenAI, Anthropic, or any OpenAI-compatible endpoint (including locally hosted via Ollama, vLLM, etc.)
4. Architecture & Technical Deep Dive
How the Closed Learning Loop Works
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ User Request โ
โโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ 1. Skill Retrieval โ
โ Query existing skill documents โ
โ for relevant procedures โ
โโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ 2. Task Execution โ
โ Execute using tools, subagents, โ
โ terminal, browser, etc. โ
โโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ 3. Outcome Evaluation โ
โ Assess success/failure of task โ
โโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ 4. Skill Synthesis โ
โ Convert successful workflow into โ
โ reusable agentskills.io document โ
โโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ 5. Memory Consolidation โ
โ Update MEMORY.md, USER.md โ
โ Index in SQLite FTS5 โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ Periodic nudges (heartbeat-triggered maintenance cycles) run between sessions to consolidate memories, clean up artifacts, and refine or merge skills. This creates a compounding effect - the agent improves with use, not just during active interaction.
Skill System & Memory Stack
Skills are Markdown files that describe procedures, tool invocations, and expected outcomes. They follow the open agentskills.io specification, making them portable between agents and shareable with the community. The specification is complementary to the Model Context Protocol (MCP) - while MCP focuses on how an agent connects to external tools and data, Agent Skills teach the agent how to use those tools and perform specific tasks effectively.
Memory layers:
- Prompt-level (
MEMORY.md+USER.md) โ Always injected. Concise. Curated. - Session search (SQLite FTS5 + LLM summarization) โ Searchable history across all past conversations.
- Procedural (Skill documents) โ โHow-toโ knowledge. The agentโs learned methods.
- Honcho user modeling โ Dialectic modeling of user preferences and personality (optional, via Honcho). Honcho treats all entities as โpeersโ and uses continual learning with reasoning models to derive explicit/deductive conclusions about user identity and values.
Runtime Environments & Security
The agent supports five runtime backends (local, Docker, SSH, Singularity, Modal). Docker-based sandboxing enforces:
- Read-only root filesystem
- Dropped Linux capabilities (e.g.,
CAP_NET_RAW,CAP_SYS_ADMIN) - Linux namespace isolation (PID, network, mount)
v0.7.0 security additions:
- Secret exfiltration blocking - scans browser URLs and LLM responses for credential patterns (base64, URL-encoded secrets, prompt injection attempts)
- Expanded credential directory redaction (
.docker,.azure,.config/gh) - Sandbox output redaction for
execute_code - Supply chain hardening - dependency management improvements, removal of compromised packages, and updated CI workflows
CLI + Gateway Design
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Terminal (hermes CLI) โ
โโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Hermes Agent Core โ
โ (Python 3.11, uv-managed venv) โ
โ โ
โ โโโโโโโโโโโโ โโโโโโโโโโโโ โ
โ โ Memory โ โ Skills โ โ
โ โ System โ โ System โ โ
โ โโโโโโโโโโโโ โโโโโโโโโโโโ โ
โ โโโโโโโโโโโโ โโโโโโโโโโโโ โ
โ โ 40+ Toolsโ โ Subagentsโ โ
โ โโโโโโโโโโโโ โโโโโโโโโโโโ โ
โโโโโโโโโโโโโโโโโโโโฌโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ Messaging Gateway โ
โ (systemd service, always-on) โ
โ โ
โ Telegram โ Discord โ Slack โ WhatsApp โ
โ Signal โ Email โ SMS โ Matrix โ
โ Mattermost โ Home Assistant โ DingTalk โ
โ Feishu/Lark โ WeCom โ CLI โ
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ v0.7.0 (โThe Resilience Releaseโ) - Key Additions
Released April 3, 2026, v0.7.0 brought significant improvements across stability, security, and extensibility:
- Camoufox Anti-Detection Browser - A new local browser backend using Camoufox for stealth web research and scraping with reduced risk of anti-bot blocking. Supports persistent sessions and VNC URL discovery for visual debugging.
- Pluggable Memory Provider Interface - Memory backends are now extensible via a plugin system (Honcho, vector stores, custom databases).
- Same-Provider Credential Pools - Configure multiple API keys for the same provider with automatic โleast-usedโ rotation to improve reliability and avoid rate limits.
- Inline Diff Previews - File write and patch operations display inline diffs in the tool activity feed, allowing visual confirmation of changes.
- Gateway Hardening - Fixes for race conditions, flood control, stuck sessions, and approval routing.
- ACP (Agent Client Protocol) / Client-Provided MCP Servers - Editor integrations (VS Code, Zed, JetBrains) can register MCP servers that Hermes automatically picks up as tools.
- API Server Session Continuity - Real-time streaming of tool progress with persistent sessions across requests via session headers.
- New slash commands -
/yolo(toggle dangerous command approvals),/btw(ephemeral side questions without impacting conversation context),/profile(show active profile info).
Notable Directory Structure
hermes-agent/
โโโ agent/ # Core agent logic
โโโ tools/ # Built-in tool implementations
โโโ skills/ # Bundled skill documents
โโโ optional-skills/# Additional skills
โโโ gateway/ # Messaging gateway (Telegram, Discord, etc.)
โโโ cron/ # Scheduling system
โโโ environments/ # Sandbox backend definitions
โโโ hermes_cli/ # CLI commands and subcommands
โโโ plugins/ # Plugin system
โโโ docker/ # Docker configurations
โโโ docs/ # Documentation source
โโโ scripts/ # Install and setup scripts
โโโ tests/ # Test suite
โโโ tinker-atropos/ # RL integration (git submodule) 5. Detailed Comparison: Hermes Agent vs. OpenClaw
Feature Comparison Table
| Feature | Hermes Agent | OpenClaw | Notes |
|---|---|---|---|
| GitHub Stars | ~26,000 | ~349,000 | OpenClaw has massive community adoption |
| Commits / Maturity | ~3,300 commits, 7 releases | ~27,500 commits, continuous releases | OpenClaw is older and more battle-tested |
| License | MIT | MIT | Both fully open-source |
| Language | Python (93.4%) | TypeScript / Node.js | Different ecosystems |
| Memory System | Layered: MEMORY.md + USER.md + SQLite FTS5 + Honcho + Skills | Session-based with SOUL.md, file-based persistence | Hermes has deeper, multi-layered memory |
| Self-Improvement | Built-in closed learning loop; auto-generates skills | Skills can be authored by the agent but no structured learning loop | Core differentiator for Hermes |
| Skill System | agentskills.io format; bundled + community + auto-generated | Skills/plugins with ClawHub marketplace; extensive community library | OpenClaw has a larger existing library |
| Messaging Channels | 14+ (Telegram, Discord, Slack, WhatsApp, Signal, Email, SMS, Matrix, Mattermost, Home Assistant, DingTalk, Feishu/Lark, WeCom, CLI) | 20+ (WhatsApp, Telegram, Discord, Slack, Signal, iMessage, Teams, Matrix, IRC, LINE, Feishu, Google Chat, Nostr, WeChat, WebChat, and more) | OpenClaw supports more channels, but Hermes covers the most common platforms |
| Native Apps | CLI + OpenAI-compatible API server | macOS menu bar app, iOS app, Android app | OpenClaw has native companion apps |
| Voice Support | TTS (text-to-speech), voice message transcription | Voice Wake, Talk Mode, TTS, live voice on iOS/Android | OpenClaw has richer voice integration |
| Live Canvas | Not available | A2UI: agent-driven visual workspace | Unique to OpenClaw |
| Browser Control | Built-in + Camoufox anti-detection (v0.7.0) | Dedicated openclaw-managed Chrome/Chromium with CDP | Both capable; Hermes adds stealth browsing |
| Sandboxing | 5 backends (Local, Docker, SSH, Singularity, Modal) | Docker-based sandbox, Podman, host execution | Hermes offers more sandbox variety |
| Scheduling | Natural-language cron via CLI/gateway | Cron + wakeups + webhooks + Gmail Pub/Sub | Both support scheduling; OpenClaw adds webhook/Gmail triggers |
| Subagents | Isolated subagents with own contexts + Python RPC | Multi-agent routing with workspace isolation | Both support delegation |
| Research Tooling | Trajectory generation, Atropos RL, ShareGPT export | Not a core focus | Unique to Hermes |
| Model Flexibility | Nous Portal, OpenRouter, OpenAI, Anthropic, custom endpoints | Anthropic, OpenAI, Google, OpenRouter, local models, OAuth subscriptions | Both highly flexible |
| Model Failover | Credential pool rotation (v0.7.0) | Built-in model failover with auth profile rotation | Both handle failover |
| Installation | One-liner bash script + hermes setup wizard | npm install -g openclaw + openclaw onboard wizard | Both straightforward |
| OS Support | Linux, macOS, WSL2 (no native Windows) | macOS, Linux, Windows (via Node.js/WSL2) | OpenClaw has broader OS support |
| Runtime | Python 3.11 + uv | Node.js 22.16+ / 24 | Different stacks |
| Update Mechanism | hermes update (git pull + reinstall) | openclaw update --channel stable\|beta\|dev | OpenClaw has channels for stability tiers |
| Security Track Record | No public CVEs; sandbox-first design | CVE-2026-25253 (RCE, CVSS 8.8) and other security incidents reported | Hermes has a cleaner security record to date |
| Migration Path | hermes claw migrate imports OpenClaw data | N/A | One-way migration from OpenClaw to Hermes |
| Community Size | Smaller, Nous Research Discord | Very large, dedicated Discord + showcase + ClawHub | OpenClaw has a larger, more established community |
Narrative Comparison
Where Hermes Agent Excels
Self-improvement is a real, structural feature - not marketing language. The closed learning loop, periodic nudges, and automatic skill synthesis are baked into the architecture. OpenClawโs agent can write skills, but there is no equivalent automated feedback cycle.
Memory architecture is deeper - the layered stack (prompt-level files โ SQLite FTS5 โ procedural skills โ pluggable memory providers โ Honcho user modeling) provides richer long-term context than OpenClawโs session-based memory. The v0.7.0 pluggable memory interface makes this even more extensible.
Sandbox variety - five distinct execution backends (including Singularity for HPC and Modal for serverless GPU) give users fine-grained control over isolation and cost.
Research tooling - trajectory generation, Atropos RL integration (with GRPO training via LoRA adapters), and ShareGPT export are features aimed at ML researchers and agent-training workflows. No competitor offers this natively.
Security posture - as of April 2026, Hermes has no public CVEs. OpenClaw has faced significant security incidents, including CVE-2026-25253 - a high-severity (CVSS 8.8) remote code execution vulnerability where improper validation of the
gatewayUrlparameter allowed attackers to steal authentication tokens via crafted links, bypass localhost protections, and execute arbitrary commands. The vulnerability affected all versions prior to 2026.1.29. Hermesโs sandbox-first design, v0.7.0 secret exfiltration blocking, and supply chain hardening reflect a security-conscious approach.Lightweight runtime - Python + uv makes for a minimal footprint. It can run on a $5 VPS.
Editor integration - the v0.7.0 ACP (Agent Client Protocol) allows VS Code, Zed, and JetBrains extensions to register MCP servers that Hermes automatically discovers and uses as tools.
Where OpenClaw Excels
Channel breadth is unmatched - with 20+ messaging channels (including iMessage, Microsoft Teams, LINE, IRC, Nostr, WeChat, Google Chat), OpenClaw is the clear leader for multi-platform reach. Hermes supports 14+ channels, covering the most common platforms but missing some niche ones like iMessage and IRC.
Native companion apps - macOS menu bar app, iOS app, and Android app provide a polished, platform-native experience. Hermes is CLI-based with an OpenAI-compatible API server for connecting UI frontends.
Live Canvas (A2UI) - an agent-driven visual workspace unique to OpenClaw and not available in Hermes.
Voice Wake and Talk Mode - continuous voice interaction on macOS/iOS/Android with wake word support. Hermes has TTS and voice message transcription but lacks real-time voice interaction with wake word detection.
Community and ecosystem - 349,000 stars, 70,000 forks, 27,000+ commits, and a mature ClawHub marketplace. The OpenClaw community is significantly larger and more active.
Windows support - OpenClaw runs natively on Windows via Node.js. Hermes requires WSL2.
Battle-tested at scale - with ~27,500 commits and continuous releases, OpenClaw has been through more real-world stress testing. Hermes, at ~3,300 commits and 7 releases, is comparatively younger.
When to Choose Each
Choose Hermes Agent if: You prioritize long-term learning and continuous improvement; you want your agent to get better at your specific workflows over weeks and months; you need research/ML training tooling; you want strong sandbox isolation options; you prefer Python-based tooling; you want editor integration via ACP/MCP; or you are security-conscious and want a smaller attack surface.
Choose OpenClaw if: You need broad messaging platform coverage (especially iMessage, Teams, IRC, or LINE); you want native mobile apps and live voice interaction with wake words; you prefer a larger community and skill marketplace; you need the Live Canvas for visual workflows; or you are already invested in the Node.js ecosystem.
Use both: Some power users deploy both - OpenClaw for its superior multi-channel orchestration and native apps, and Hermes for research-heavy, learning-intensive tasks. The
hermes claw migratecommand makes bridging the two straightforward.
6. Migration from OpenClaw - Step-by-Step Handbook
Hermes Agent includes a first-class migration path for OpenClaw users. The hermes claw migrate command can import your persona, memories, skills, API keys, messaging settings, and workspace instructions.
Automatic Detection During Setup
When you run hermes setup for the first time, the setup wizard automatically detects an existing ~/.openclaw directory and offers to migrate before configuration begins.
hermes setup
# If ~/.openclaw is detected, you'll be prompted:
# "OpenClaw installation detected. Would you like to migrate? [Y/n]" Manual Migration Commands
If you have already installed Hermes and want to migrate later:
# Full interactive migration (recommended)
hermes claw migrate
# Preview what would be migrated without making changes
hermes claw migrate --dry-run
# Migrate only user data (no secrets/API keys)
hermes claw migrate --preset user-data
# Overwrite any existing Hermes files that conflict
hermes claw migrate --overwrite
# See all available options
hermes claw migrate --help What Gets Migrated
| Source (OpenClaw) | Destination (Hermes) | Notes |
|---|---|---|
SOUL.md (persona file) | Hermes persona configuration | Your agentโs personality and instructions |
MEMORY.md and USER.md | Hermes memory files | Accumulated memories and user preferences |
| User-created skills | ~/.hermes/skills/openclaw-imports/ | Skills are placed in a dedicated import directory |
| Command allowlist | Hermes approval patterns | Approved commands carry over |
| Platform configs (Telegram, Discord, etc.) | Hermes gateway configuration | Messaging settings, allowed users, working directory |
| API keys | Hermes secrets store | Allowlisted: Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs |
| TTS assets (audio files) | Hermes workspace | Workspace audio files |
AGENTS.md (workspace instructions) | Hermes workspace (with --workspace-target) | Requires explicit flag |
Interactive Migration Skill
For a guided, agent-assisted migration experience, use the built-in openclaw-migration skill:
hermes
# Then in the chat:
/openclaw-migration This skill walks you through the migration interactively, showing dry-run previews before making changes.
Post-Migration Checklist
- Verify persona - Run
hermesand confirm the agentโs personality matches your expectations. - Check API keys - Run
hermes config setor check your configuration to ensure API keys transferred correctly. - Test messaging - Start the gateway (
hermes gateway) and send a test message from each connected platform. - Review imported skills - Check
~/.hermes/skills/openclaw-imports/to ensure your custom skills look correct. - Run diagnostics - Execute
hermes doctorto surface any configuration issues. - Update memory - The agentโs memory files may need minor adjustments for Hermesโs format. Review
MEMORY.mdandUSER.mdin your Hermes config directory.
Known Gotchas
- OpenClaw skills are TypeScript/Node.js - while Hermes imports skill definitions (the Markdown/instruction layer), any skills with inline TypeScript code will need to be rewritten in Python or as tool invocations.
- Channel differences - if you use iMessage, Teams, IRC, or other channels only supported by OpenClaw, those configurations will not migrate (Hermes does not support those channels).
--overwriteis destructive - if you have already customized your Hermes configuration, the--overwriteflag will replace existing files. Use--dry-runfirst.- Workspace instructions require
--workspace-target-AGENTS.mdfiles are not migrated by default; you must explicitly pass this flag.
7. Installation & Quickstart
One-Liner Installer
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash This handles everything: installs uv, Python 3.11, clones the repository, sets up dependencies, and adds the hermes command to your PATH. No prerequisites except git. No sudo required.
Supported platforms: Linux, macOS, WSL2.
After installation, reload your shell:
source ~/.bashrc # or: source ~/.zshrc Setup Wizard
hermes setup The interactive setup wizard walks you through:
- Model provider selection (Nous Portal, OpenRouter, or custom endpoint)
- API key configuration
- Memory and personality setup
- Gateway configuration (optional)
- OpenClaw migration (if
~/.openclawis detected)
Model Selection
hermes model Interactive picker for model provider and specific model. Switch at any time - no code changes, no restarts needed.
Gateway Setup (Multi-Platform)
# Interactive gateway setup wizard
hermes gateway setup
# Start the messaging gateway
hermes gateway
# Install as a systemd service (always-on)
hermes gateway install The wizard walks you through connecting Telegram, Discord, Slack, WhatsApp, Matrix, or any of the other supported platforms. The gateway runs as a systemd service.
Start Chatting
hermes Full interactive CLI with tools, memory, and skills. Use /new to start a new conversation, /skills to list available skills, /model to switch models mid-conversation, /yolo to toggle dangerous command approvals, /btw for ephemeral side questions, and Ctrl+C to interrupt.
Updating
hermes update Pulls the latest changes from the repository and reinstalls dependencies.
Diagnostics
hermes doctor Diagnoses common issues with configuration, dependencies, and connectivity.
Windows (WSL2) Notes
Native Windows is not supported. Install WSL2 and run all commands from the WSL2 terminal:
# From PowerShell (install WSL2 first)
wsl --install
# Then from the WSL2 terminal
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash 8. Real-World Daily Use Cases
The self-improving nature of Hermes shines in workflows that recur and evolve. Here are concrete examples drawn from the community:
1. Automated Research Pipelines
Ask the agent to research a topic, synthesize findings, and produce a report. The first time takes extensive back-and-forth. By the third time, the agent has generated a research-pipeline skill that remembers your preferred sources, citation format, and output structure. Subsequent research requests execute faster and more consistently.
2. DevOps Monitoring & Incident Response
Configure a cron job: โEvery 30 minutes, check the health of my staging server and alert me on Telegram if anything is down.โ The agent learns the specific health check commands for your stack, builds skills around interpreting log output, and improves its alert formatting over time based on your feedback.
3. Personal Knowledge Management
Use the agent as a โsecond brainโ - tell it things throughout the day via Telegram or Discord. It stores information in its memory system and can retrieve it later. โWhat was the name of that restaurant I mentioned last Tuesday?โ Unlike a simple note app, the agent cross-references context from different conversations and platforms.
4. Code Review & Refactoring Assistance
Point the agent at a codebase and ask for reviews. It uses subagents to parallelize - one reviews architecture, another checks for security issues, a third runs the test suite. Skills accumulate for your specific stackโs patterns and common pitfalls.
5. Content Creation Pipeline
โDraft a blog post about X, check the facts, generate a header image, and format it in Markdown.โ The agent learns your writing style (via USER.md), preferred image generation prompts, and formatting conventions. Each subsequent content request benefits from the accumulated preferences.
6. Email & Calendar Triage
Connect the agent to your email (via gateway) and ask it to triage your inbox every morning. It learns which senders are high-priority, which newsletters to summarize vs. skip, and how you prefer briefings formatted.
7. Multi-Model Reasoning for Complex Decisions
For decisions requiring multiple perspectives, the agent can query several LLMs in parallel (e.g., Claude for analysis, GPT-4 for creative options, Gemini for fact-checking) and synthesize the results. Skills remember which models performed best for different task types.
8. ML Experiment Management
For researchers: use the trajectory generation and Atropos RL integration to run agent evaluations at scale. Generate ShareGPT-format datasets for fine-tuning. The research tooling is a genuine differentiator - not available in competing agent frameworks.
9. Smart Home Automation
Connect Hermes to Home Assistant via the gateway and control IoT devices, automate routines, and build context-aware home management skills. The agent learns your preferences over time - adjusting lighting, temperature, and device schedules based on accumulated observations.
9. Conclusion & Recommendation
A Balanced Assessment
Hermes Agent introduces a genuinely novel architectural concept to the personal AI agent space: the automated, closed learning loop that transforms completed work into reusable procedural knowledge. This is not a superficial feature - it is designed into the memory stack, the skill system, and the agentโs periodic maintenance cycles. The v0.7.0 release (โThe Resilience Releaseโ) demonstrates the projectโs rapid maturation with pluggable memory providers, editor integration via ACP, anti-detection browsing, and significant security hardening.
However, it is a younger project (v0.7.0, ~3,300 commits) entering a space dominated by OpenClaw (~27,500 commits, 349k stars). OpenClawโs advantages in channel breadth (20+ vs. 14+), native apps (macOS/iOS/Android), voice interaction with wake words, community size, and overall maturity are substantial.
Who Should Use Hermes Agent Today
- ML researchers and developers who want built-in trajectory generation and RL training integration with GRPO and LoRA support.
- Users who prioritize self-improvement - if you find yourself repeatedly re-teaching your AI assistant the same workflows, Hermesโs learning loop addresses this directly.
- Security-conscious users - Hermesโs sandbox-first design and clean security track record (no public CVEs) make it appealing for environments where security is non-negotiable.
- OpenClaw users hitting friction - if you use OpenClaw and feel the agent isnโt โlearningโ enough between sessions, Hermesโs memory architecture may be the upgrade you need. The migration path (
hermes claw migrate) makes switching low-risk. - Developers using VS Code, Zed, or JetBrains - the ACP integration enables seamless editor-to-agent communication via MCP servers.
Who Should Stay on OpenClaw
- Users who rely on iMessage, Teams, LINE, IRC, Nostr, WeChat, or any of the channels only OpenClaw supports.
- Users who depend on the macOS/iOS/Android native apps, Live Canvas, or Voice Wake.
- Users who want the largest possible community and skill marketplace.
- Teams and multi-user setups where OpenClawโs multi-agent routing and group channel management are essential.
Getting Started
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
hermes setup
hermes - GitHub: github.com/NousResearch/hermes-agent
- Website: hermes-agent.nousresearch.com
- Docs: hermes-agent.nousresearch.com/docs
- Discord: discord.gg/NousResearch
Sources & References
All information in this guide was sourced from the following primary sources, accessed on April 6, 2026:
- Hermes Agent Official Website - hermes-agent.nousresearch.com
- Hermes Agent GitHub Repository - github.com/NousResearch/hermes-agent (~26k stars, 3.5k forks, 3,316 commits, MIT license)
- Hermes Agent v0.7.0 Release Notes - github.com/NousResearch/hermes-agent/releases/tag/v2026.4.3 (April 3, 2026, โThe Resilience Releaseโ)
- Hermes Agent Documentation - hermes-agent.nousresearch.com/docs
- OpenClaw Official Website - openclaw.ai
- OpenClaw GitHub Repository - github.com/openclaw/openclaw (349k stars, 70k forks, 27,458 commits, MIT license)
- OpenClaw Documentation - docs.openclaw.ai
- agentskills.io - agentskills.io (open skill format specification)
- Honcho (Plastic Labs) - github.com/plastic-labs/honcho
- CVE-2026-25253 - NIST NVD (OpenClaw RCE vulnerability, CVSS 8.8, fixed in v2026.1.29)
This guide is not affiliated with Nous Research or OpenClaw. Both projects are independent open-source efforts under the MIT license. Evaluate both on their merits for your specific use case.
Comments
Sign in to join the discussion!
Your comments help others in the community.