Installation FAQ

Installation and setup answers for supported environments, command flow, and troubleshooting.

Common questions about install, configuration, integrations, and errors.

Does Hermes Agent run on Windows?

Yes. Windows 10/11 supports the official native PowerShell installer, and WSL2 remains available when you need a Linux toolchain.

Do I need a proxy or VPN?

Depends on the provider. Several providers offer direct access in restricted regions; OpenAI / Anthropic typically require a proxy.

How do I connect Hermes to messaging platforms?

Through the Hermes Gateway module. The integration guides cover the full path from bot registration to production deploy.

What does "bundled and community Skills" mean and how do I use them?

Hermes maintains the bundled catalog and Skills Hub with a broad catalog of reusable modules (code review, data queries, doc generation, etc.). Use `hermes skills install <name>` to install one. See the Skills system guide.

What do I run after install?

In order: `hermes setup --portal` (configure Nous and the Tool Gateway with one OAuth) → `hermes doctor` (self-check) → `hermes` (start using). See Quickstart.

Can I migrate from OpenClaw?

Yes. `hermes migrate` converts the configuration in one shot, and there is a Skills compatibility map. See the OpenClaw migration guide.

How do I troubleshoot install errors?

Run `hermes doctor` first — it checks 12 common issues. If that does not resolve it, see the FAQ error section for 20+ common errors and fixes.