Hermes Agent Installation & Configuration Guide

Deploying and configuring AI Agents across multiple platforms often involves challenges like OS compatibility issues, complex management of interaction endpoints, and the hassle of migrating data from legacy systems. The Hermes Agent installation guide systematically addresses these problems, providing a clear path from environment preparation to functional verification.

Core Capabilities and Key Steps

The core of this skill is a structured deployment and migration solution:
- Cross-System Compatibility: It clearly outlines installation paths for Linux/macOS versus Windows, supporting multiple methods such as Git Bash, WSL, and PowerShell to ensure a consistent environment.
- Dual-Mode Interaction Endpoints: It integrates a CLI (Command-Line Interface) and a messaging gateway. The CLI is for local quick debugging, while the gateway connects to major platforms like Telegram, Discord, and Slack for seamless conversations.
- Unified Command Management: A set of cross-entrypoint commands (e.g., /model, /personality) is designed, allowing users to execute the same operations in the terminal or chat windows, reducing the learning curve.
- Seamless Data Migration: For users migrating from OpenClaw, it offers an automatic detection and import mechanism to transfer settings, memories, skills, and API keys in one go, avoiding repetitive configuration.

Key steps revolve around "confirmation" and "choice": Before installation, users must verify default paths (e.g., ~/.hermes/hermes-agent) and the Python version; then they select either command-line deployment (based on uv and virtual environments) or Docker deployment based on their environment. The migration process is automatically triggered within the hermes setup wizard.

Applicability Boundaries and Considerations

This guide primarily serves the initial installation of Hermes Agent and migration in specific scenarios. Key points to note:
- Hard Dependencies: Command-line deployment strictly requires Python 3.11 or above; the Docker method requires a pre-installed Docker engine.
- Configuration Isolation: All configurations and logs are stored by default in the ~/.hermes directory. During uninstallation, users can choose to retain configurations for easy upgrades or reinstallation.
- Platform-Specific Configuration: Setting up the messaging gateway (hermes gateway setup) may vary by platform (e.g., WhatsApp requires additional verification), so referring to the corresponding documentation is necessary.
- Migration Limitations: The automatic migration feature is designed exclusively for OpenClaw. When migrating from other systems, API keys and skill lists must be handled manually.

In summary, this skill reduces deployment complexity through standardized checklists and step-by-step guidance, but users still need to make necessary preparations based on their specific environments.