Agents & sessions › Telegram bot
Docs › Agents & sessions › Telegram bot

Telegram bot

Spacesheep has one Telegram bot — @TheSpaceSheepBot — that acts as an agent across your spaces and orgs. DM it questions or actions (“list my spaces”, “deploy this”, “share that with…”, “remind me to…”); it runs the same MCP tools and uses your account’s LLM key. There’s nothing to install and no per-org bot to create — the same bot switches accounts depending on where you use it.

Open a direct message with @TheSpaceSheepBot and send:

/start

Tap the link it replies with to connect your Spacesheep account — one tap, done. (Alternatively, grab a one-time code from Settings → Telegram and send /start <code>.) Once linked, anything you DM the bot acts on your personal account.

2. Use it in a group / for an org

Add @TheSpaceSheepBot to a Telegram group, then bind that group to whichever account it should act on:

  • /bind <org-slug> — act on an organization you belong to. For example /bind sheep.
  • /bind — act on your own personal account.
  • /unbind — clear the binding.

After you bind to an org, everything the bot does in that group runs on the org — its spaces, its secrets and LLM key, its permissions — not your personal account. Mention @TheSpaceSheepBot or reply to one of its messages to ask it something.

Heads up: the <org-slug> is the org’s slug (the <slug> in its <slug>.spacesheep.dev URL), not its display name. You must be a member of the org to bind to it. For /summary and group awareness the bot needs to read every message — a group admin disables privacy mode once in @BotFather (/setprivacy → Disable).

Commands

CommandWhereWhat it does
/startDMLink your account (or /start <code> with a code from Settings)
/bind <org-slug>GroupBind the group to an org (omit the slug to bind to your personal account)
/unbindGroupClear the group’s binding
/summaryDM & groupRecap the recent conversation
/unlinkDMDisconnect and revoke the bot’s API key
/helpDM & groupShow the command list
Was this page helpful?