Start messaging bots with a single command. Supports Telegram, Discord, and Slack with full capability options.
Quick Start
# Telegram
praisonai bot telegram --token $TELEGRAM_BOT_TOKEN
# Discord
praisonai bot discord --token $DISCORD_BOT_TOKEN
# Slack (requires both tokens)
praisonai bot slack --token $SLACK_BOT_TOKEN --app-token $SLACK_APP_TOKEN
Command Reference
praisonai bot <platform> [OPTIONS]
| Platform | Required Tokens |
|---|
telegram | --token |
discord | --token |
slack | --token + --app-token |
Capability Options
Enable agent capabilities via CLI flags:
Model & Agent
| Option | Description |
|---|
--agent FILE | Agent YAML configuration file |
--model, -m MODEL | LLM model (e.g., gpt-4o, claude-sonnet-4-20250514, gemini/gemini-2.0-flash) |
--thinking MODE | Thinking mode: off, minimal, low, medium, high |
Browser
| Option | Description |
|---|
--browser | Enable browser control tool |
--browser-profile NAME | Browser profile name (default: default) |
--browser-headless | Run browser in headless mode |
Web Search
| Option | Description |
|---|
--web | Enable web search with provider-specific tools |
--web-provider PROVIDER | Search provider: duckduckgo, tavily, serper |
| Option | Description |
|---|
--tools TOOL... | Enable additional tools by name (e.g., DuckDuckGoTool WikipediaTool) |
--skills SKILL... | Enable specific skills |
--skills-dir DIR | Custom skills directory path |
Memory & Knowledge
| Option | Description |
|---|
--memory | Enable persistent memory |
--memory-provider PROVIDER | Memory provider (default: default) |
--knowledge | Enable knowledge/RAG |
--knowledge-sources SOURCE... | Knowledge sources to load |
--session-id ID | Session ID for conversation continuity |
--user-id ID | User ID for memory isolation |
Execution
| Option | Description |
|---|
--sandbox | Enable sandbox execution mode |
--exec | Enable exec tool explicitly |
--auto-approve | Auto-approve all tool executions (skip confirmation prompts) |
Audio (TTS/STT)
| Option | Description |
|---|
--tts | Enable TTS tool for text-to-speech |
--tts-voice VOICE | TTS voice: alloy, echo, fable, onyx, nova, shimmer |
--tts-model MODEL | TTS model (default: openai/tts-1) |
--auto-tts | Auto-convert all responses to speech |
--stt | Enable STT tool for speech-to-text |
--stt-model MODEL | STT model (default: openai/whisper-1) |
Default Tools (Always Enabled):
execute_command - Run shell commandssearch_web - Web search with auto-fallback providers
The --exec and --web flags add additional provider-specific tools on top of defaults.
Examples
Basic Bot
praisonai bot telegram --token $TELEGRAM_BOT_TOKEN
With Custom Agent
praisonai bot slack --token $SLACK_BOT_TOKEN --app-token $SLACK_APP_TOKEN --agent agents.yaml
name: support-bot
instructions: |
You are a customer support assistant.
Be helpful and concise.
llm: gpt-4o-mini
tools:
- search_web
With Full Capabilities
praisonai bot telegram --token $TOKEN \
--agent agents.yaml \
--browser \
--web \
--memory \
--model gpt-4o
praisonai bot discord --token $TOKEN \
--tools DuckDuckGoTool WikipediaTool GitHubTool
With Knowledge Base
praisonai bot slack --token $SLACK_BOT_TOKEN --app-token $SLACK_APP_TOKEN \
--knowledge \
--memory
With Auto-Approve (Trusted Environment)
# Auto-approve all tool executions - useful for trusted environments
praisonai bot slack --token $SLACK_BOT_TOKEN --app-token $SLACK_APP_TOKEN \
--auto-approve \
--exec \
--web
Use --auto-approve only in trusted environments. This skips all confirmation prompts for tool executions.
With TTS/STT (Voice)
# Enable TTS tool - agent can convert text to speech
praisonai bot telegram --token $TOKEN --tts
# Auto-convert all responses to speech
praisonai bot telegram --token $TOKEN --auto-tts --tts-voice nova
# Full voice capabilities
praisonai bot telegram --token $TOKEN --tts --stt --memory
Environment Variables
| Variable | Description |
|---|
TELEGRAM_BOT_TOKEN | Telegram bot token from @BotFather |
DISCORD_BOT_TOKEN | Discord bot token |
SLACK_BOT_TOKEN | Slack Bot User OAuth Token (xoxb-...) |
SLACK_APP_TOKEN | Slack App-Level Token (xapp-...) |
OPENAI_API_KEY | OpenAI API key for LLM |
Agent YAML Schema
name: my-bot
instructions: |
You are a helpful assistant.
Be concise and friendly.
llm: gpt-4o-mini
tools:
- search_web
- DuckDuckGoTool
memory: true
knowledge:
- ./docs/
