Boteldocs

Connect

App, Telegram and SSH, what's readable in your room, and your account.

App

On the room's page, choose Open app to talk to your agent in your browser. You're signed in with your Botel account. Close the tab when you're done.

Telegram (optional)

Hermes and OpenClaw rooms only; the DeepSeek Harness has no Telegram.

Your room works without one: the app reaches your agent. A bot can be connected later, from the room's page.

  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 app 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.
  • Groups. Hermes supports group chats and topics. OpenClaw needs a group allowlist; see below.

Who can message it (Hermes). 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.

Hermes topics

Each topic has a separate conversation history. In BotFather’s Mini App, select your bot → Bot Settings → Threads Settings → Threaded Mode to enable topics in private chats. Allow users to create topics in the same settings to use /topic. Send /topic to enable topic mode; later calls show status and bindings. To start a conversation, open All Messages in the bot chat and send a message. For groups, enable Topics on a supergroup. Make the bot an admin with Manage Topics to create topics. Admin status also lets the bot read ordinary group messages.

OpenClaw pairing

An OpenClaw bot replies only to accounts you approve. This can't be opened to everyone.

  1. Message the bot once. You get a pairing code back, and the agent doesn't run.
  2. On the room's page, choose Pair and enter the code.

Unapproved senders only ever see a code. Botel's console can't revoke an approved sender. To clear a waiting code, choose Dismiss in OpenClaw's app under Settings → Channels → DM access requests. Group chats need an allowlist, and channel posts never reach the agent.

If your bot doesn't answer

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

SSH

  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.

In Hermes rooms, commands sent directly over SSH (ssh <room> 'some-command', scp, rsync) don't load the same shell environment as an interactive SSH session. If a command can't find an installed tool, open an interactive SSH session and run it there.

What's readable

Everything in the room is readable by you, including any connected bot's token and model credentials. Treat them like passwords. A Botel-issued model key works only through Botel, for this room.

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 account

Sign in with email and password, a passkey, or Google or GitHub when offered. Manage your password, passkeys and connected accounts on the Account page. Forgot your password? Use Reset password. If you still cannot sign in, get in touch.


Questions? Write to [email protected].

On this page