Bot creation
You create the Telegram bot itself through BotFather.
Telegram setup · Step 1
Create your
Create your
Telegram bot.
Rosi uses your own Telegram bot so you can message it from Telegram. You create the bot, copy its token, and paste the token into Rosi Agent.
You need
One normal Telegram account and BotFather.
Important
Telegram only shows the full bot token once when you create or rotate it.
Next step
After saving the token, send your bot a private message to connect your account.
What happens in this step
Final username
This is the name you search for in Telegram when you message your bot.
Token
The token proves Rosi is allowed to run this bot on your Mac.
What comes next
Once Rosi has the token, send your bot a private message to connect your account.
You do not need to manually type numeric Telegram user ids or group ids into Rosi. Rosi learns those from real Telegram activity later.
How to create the bot and token
1
Open BotFather
In Telegram, search for @BotFather and open that chat.
2
Create the bot
Send /newbot to BotFather and follow the prompts.
- The first prompt is the display name people see in Telegram.
- The second prompt is the username. It must end in bot.
3
Choose the final username carefully
Pick a username you are happy to keep; it is how you find your bot in Telegram.
Examples: rosi_assistant_bot, helloassistant_bot
4
Copy the bot token
BotFather returns a token immediately after creation. Copy the full token and keep it somewhere safe until you paste it into Rosi.
If you lose the token, go back to BotFather later and use /token to generate or reveal a fresh one for the same bot.
5
Paste the token into Rosi Agent
Back in Rosi Agent, paste the bot token, then choose Start Rosi.
How to know this part worked
Once the token is saved, Rosi starts and waits for your first private message.
When Rosi is waiting for your first Telegram message, the token step is done and you are ready for the next guide.
What to check if this fails
The username is rejected
Telegram usernames for bots must end in bot and must still be available.
You lost the token
Return to BotFather and use /token for that bot. Then paste the fresh token into Rosi.
Rosi still says the token is missing
Make sure you pasted the full token, not the bot’s display name or username.
You finished this page
Go to the next guide and send your bot a private message to connect your account.