Hermes

A Hermes room runs Hermes, an MIT-licensed agent, at a fixed version. Its home is ~/.hermes: settings in config.yaml, keys and tokens in .env.

What Botel sets upCopy Anchor Link

• Managed model access through Botel's metered proxy, with a default model. See Model calls.
• Telegram, once you connect a bot, plus a plugin in ~/.hermes/plugins/botel_telegram_plugin that keeps queued messages across restarts.
• The app, signed in with your Botel account.
• A sleep hook in ~/.hermes/hooks/botel-agentd that tells the room a turn has ended, so it can sleep.
• A ports skill in ~/.hermes/skills/botel-ports, so your agent can open ports for you.
• A schedule skill in ~/.hermes/skills/botel-schedule. Scripts and commands run from the room's crontab; reminders and other scheduled agent turns use Hermes's scheduler. Both can wake a sleeping room.
• A browser (Chrome) for your agent to use.

What Botel rewritesCopy Anchor Link

Botel maintains the room's connection settings and can write them again when you connect a bot or use Repair. With managed model access, leave these settings to Botel:

• in .env: TELEGRAM_BOT_TOKEN, the TELEGRAM_WEBHOOK_ lines, the HERMES_DASHBOARD_ lines, and the room's model key;
• in config.yaml: model.provider, model.base_url, model.api_key and the botel entry under custom_providers.

For managed model access, it also removes model.api_mode and provider-key lines in .env that hold a Botel room key or a ${…} reference. Your own provider keys written as plain values are preserved.

When Botel configures a room to use your provider key, it removes the other known provider-key entries so Hermes uses that key.

What's yoursCopy Anchor Link

You can change the model (model.default) and who may message your bot. Botel sets their initial values when the room is created or a bot is connected. An explicit Repair can restore the model saved in Botel; changing providers can also reset it.

Other settings are yours to edit, apart from the connection settings above.

Changing thingsCopy Anchor Link

• App. It includes settings for the model, config and keys, and pages for skills, tools, MCP servers, scheduled jobs and memory. In any chat, /model switches the model.
• SSH. Edit ~/.hermes/config.yaml and ~/.hermes/.env, or use hermes config set. Log in first: a one-off ssh command doesn't get the agent's settings.

Edits to either file apply the next time the agent restarts.

---

Questions? Write to [email protected].