Connect

DashboardCopy Anchor Link

Your agent's own web page: the main button on the room's page, signed in with your Botel account. Its Chat tab talks to your agent. Close the tab when you're done.

Telegram (optional)Copy Anchor Link

1. In Telegram, send /newbot to @BotFather and pick a name and username.
2. Copy the token it sends back.
3. On the room's page, choose Connect next to Telegram and paste it. Your agent restarts, so an open dashboard may drop for a moment.

• One bot per room. A bot connected to another room is refused.
• It's for keeps. A connected bot can't be disconnected or swapped.
• Direct messages only. Group chats aren't supported yet.

Who can message it. Anyone who finds your bot's username can message it, and your agent will answer. To limit it to you, ask your agent to restrict who can message it to your own Telegram account (Hermes' TELEGRAM_ALLOW_ALL_USERS set to false, and your numeric user ID in TELEGRAM_ALLOWED_USERS), then check from another account that it no longer replies. A message it ignores still wakes the room.

If your bot doesn't answerCopy Anchor Link

• Credit. Your balance must be above zero.
• The room. A Paused or Can't reach it room can't answer.

• The model. A failing model call stops your agent answering: see what keeps it awake.

SSHCopy Anchor Link

1. Add your public key under Account, in SSH keys (usually ~/.ssh/id_ed25519.pub). Never paste a private key.
2. Run the SSH command from the room's page. It goes through ssh.botel.dev and logs you in as sandbox.

The key works for all your rooms and only yours. SSH is refused at zero balance or below. A connection keeps the room awake, so disconnect when you're done.

Commands run without logging in (ssh <room> 'some-command', scp, rsync) don't get your agent's settings. If one can't find something, log in first.

What's readableCopy Anchor Link

Everything in the room is readable by you, including your bot's token and the room's model key (which works only through Botel, for this room). Treat both like passwords.

Botel records your room's wakes, sleeps and charges. Managed model calls pass through Botel to the provider; Botel records each one's cost and model, never what was said.

Your accountCopy Anchor Link

Email and password; change the password on the Account page. Locked out? Get in touch.

---

Questions? Write to [email protected].