Skip to main content
Your AI agent can live inside messaging apps. Users chat with it like a friend β€” no app to install, no website to visit.

What Is a BotOS?

BotOS is your AI agent wrapped in a messaging app interface. Instead of typing prompts in a terminal, users send normal messages on Telegram, Discord, Slack, or WhatsApp.
ConceptWhat It Means
AgentThe AI brain β€” understands questions, uses tools, generates answers
BotThe messenger β€” receives messages from the app, sends them to the agent, delivers replies
PlatformWhere users chat β€” Telegram, Discord, Slack, or WhatsApp

Step-by-Step: How a Message Flows

StepWhat Happens
1User types a message in their favorite app
2The messaging platform sends it to your bot
3Your bot passes the message to the AI agent
4The agent thinks, searches the web, checks documents β€” whatever you’ve configured
5The agent sends an answer back through the bot
6The user sees the reply in their chat

Which Platform Should I Use?

PlatformBest ForSetup Difficulty
TelegramPersonal bots, public bots, quick prototypes⭐ Easy
DiscordCommunities, gaming, developer groups⭐ Easy
SlackWorkplaces, teams, internal tools⭐⭐ Medium
WhatsAppBusiness communication, customer support⭐⭐⭐ Advanced

Getting Started β€” 3 Ways

Pick the way that fits you best:
No code needed. One command:
# Telegram
praisonai bot telegram --token $TELEGRAM_BOT_TOKEN

# Discord
praisonai bot discord --token $DISCORD_BOT_TOKEN

# Slack
praisonai bot slack --token $SLACK_BOT_TOKEN --app-token $SLACK_APP_TOKEN
A default AI assistant is created automatically.

Adding Superpowers

Your bot can do more than just chat. Add capabilities with simple flags:
CapabilityCLI FlagWhat It Does
Memory--memoryRemembers what users said in previous messages
Knowledge--knowledgeAnswers from your PDF, text, or markdown files
Web Search--webSearches the internet for up-to-date info
Thinking--thinking highTakes more time to give better, deeper answers
# A bot that remembers conversations and searches the web
praisonai bot telegram --token $TOKEN --memory --web

Bot vs Gateway

Two ways to deploy your agent for real-time chat:
BotGateway
PlatformsOne at a timeAll at once
AgentsOne per botMultiple, with routing
Best forQuick start, single platformProduction, multi-channel
Commandpraisonai bot telegrampraisonai gateway --config gateway.yaml
Start with a Bot to get running in minutes. Switch to Gateway when you need multiple platforms or agents.

Best Practices

Telegram is the easiest platform to set up β€” just message @BotFather and get a token in seconds.
Enable --memory so your bot remembers context between messages. Users get a much better experience.
Write bot instructions like you’re talking to a person: β€œYou are a helpful assistant for our customer support team. Be friendly and concise.”
Use Socket Mode or polling for local testing. When ready for production, deploy with Docker and webhook mode.

Messaging Bots

Detailed platform setup guides and configuration options

Bot vs Gateway

Deep dive into deployment models

Bot Commands

Built-in bot commands and custom commands

Agents

Create and configure AI agents