Updated: 2026-07-24
A game bot for Telegram is an agent that does more than reply — it HOSTS a match in the group: opens a lobby on command, deals roles by direct message, keeps the phases and timers, and announces results. Corpis ships mafia, crocodile, quiz and spy, plus a builder for your own games; the host speaks in your agent's character, not as a faceless bot. To run it you need an agent with a connected Telegram bot, added to the group.
Connect a Telegram bot to the agent. In the agent settings open the "Telegram" tab, paste a @BotFather token and click "Connect". If you have no bot yet, create one with /newbot in @BotFather.
Enable games. On the "Games" tab in the agent settings turn on the subsystem and pick the games you want — mafia, crocodile, quiz, spy. You can also describe in words which games to enable and the assistant sets them up.
Add the bot to the group. Open your Telegram group and add the bot as an ordinary member by its @username. The game commands appear in the bot menu right away.
For crocodile, give the bot admin rights. If you plan to play crocodile, make the bot a group administrator — otherwise it will not see players' guesses. The right to delete messages is not required.
Start a game with a command. Send the game command in the group: /mafia, /croco, /quiz or /spy. The bot opens a lobby as one message with join buttons.
Gather players and begin. Let players join with the lobby button. On the timer the match starts automatically once enough players are in, and the initiator can press "Start now".
Rules, timers, vote counting, role dealing and the win check are computed by a deterministic engine on the server — the match does not depend on what the model might "make up". This protects the game from the usual LLM-bot failures: leaked roles, a stuck phase, an invented outcome.
The agent's brain handles the narrative: how the night is announced in mafia, how the vote ends, and for crocodile it picks the words for a given theme. Quiz questions are generated by the agent's brain too, so the quiz sounds in its character and can be about anything — from your subject area to the character's universe.
The game bot is the same agent of yours with a connected Telegram bot. First connect the bot with a @BotFather token on the "Telegram" tab in the agent settings, then enable the games you want on the "Games" tab. After that, add the bot to your group as an ordinary member — and the game commands become available in the chat.
One bot hosts matches across many groups at once: each match keeps its own state and survives a restart. A single chat runs one match at a time.
Mafia, quiz and spy only need the bot to be in the group: the whole game runs through commands, buttons and direct messages. But crocodile catches guesses from ordinary chat messages — and without admin rights Telegram does not hand those messages to the bot.
So for crocodile make the bot a group administrator. It does not need the right to delete messages — only access to members' messages. If you start crocodile without admin rights, the bot honestly asks for them and does not begin the match.
You need an agent with a connected Telegram bot: connect the bot with a @BotFather token, enable games on the "Games" tab, and add the bot to the group. Then send /mafia — the bot opens a lobby and players join with a button.
Crocodile reads guesses from ordinary group messages, and Telegram only hands such messages to a bot that is an administrator. Make the bot a group admin — it does not need the right to delete messages for this.
Yours. A deterministic engine runs the rules, timers and scoring, while every line the host says — the night announcement in mafia, the quiz questions, and for crocodile the words for a given theme — is generated by your agent's brain in its character.
One bot hosts matches across many groups at once, and each group can enable any of the four games plus your own games from the builder. A single chat runs one active match at a time.