Skip to main content
Interactive wizard that configures messaging bots and sets up the daemon services to run them.

​
Quick Start

1

Run the onboard wizard

Launch the interactive bot setup wizard:
praisonai onboard
The wizard prompts you to choose a platform and walks you through token setup.
2

Pick your platform

Select from the supported messaging platforms:
Choose a platform:
1. Telegram
2. Discord  
3. Slack
4. WhatsApp
Each platform has different token requirements and setup steps.
3

Paste your token

Follow the platform-specific instructions to get your bot token, then paste it when prompted:
Enter your bot token: <paste_token_here>
The wizard validates the token and installs the daemon service.

​
How It Works

The onboarding process follows these phases:
PhaseDescription
Platform SelectionChoose Telegram, Discord, Slack, or WhatsApp
Token EntryPaste the bot token for your chosen platform
ValidationWizard tests the token with the platform API
Daemon InstallSets up the platform daemon (launchd/systemd/Windows Task)
ConfigurationWrites config files to ~/.praisonai/
CompletionShows the ✅ Done panel with all connection details

​
What Gets Installed

When onboarding completes successfully, the wizard installs:
ComponentLocationPurpose
Platform daemonSystem service (launchd/systemd/Windows Task)Keeps bot running in background
Bot configuration~/.praisonai/config/Stores tokens and settings
Gateway auth token~/.praisonai/gateway/Authentication for web dashboard
Dashboard URLPrinted in Done panelLocal web interface

​
The ✅ Done Panel

When onboarding completes, you’ll see a comprehensive summary panel: 
✅ Bot onboarding complete!

Dashboard: http://127.0.0.1:8082 (localhost only)
Start bot: praisonai bot start
Gateway status: praisonai gateway status
Health check: curl http://127.0.0.1:8080/health
Info endpoint: curl http://127.0.0.1:8080/info
Auth token: abc123...

Run 'praisonai doctor' if you encounter any issues.
This panel contains everything you need to:
  • Access the web dashboard
  • Start/stop your bot
  • Check service health
  • Authenticate API requests

​
Re-running Onboarding

The wizard is idempotent - safe to run multiple times: 
# Update an existing bot's token
praisonai onboard

# Switch from Telegram to Discord
praisonai onboard
Re-running the wizard will:
  • Update tokens and configurations in place
  • Restart the daemon service with new settings
  • Preserve existing chat histories and agent memory

​
Relationship to Setup

PraisonAI has two configuration commands that run in sequence:
  • praisonai setup - Configures LLM providers (OpenAI, Anthropic, etc.)
  • praisonai onboard - Configures messaging bots (Telegram, Discord, etc.)
Both are called automatically by the installer, but can be run independently.

​
Common Patterns

​
Skip onboarding during install

# Skip during installation
curl -fsSL https://praison.ai/install.sh | bash -s -- --no-onboard

# Or via environment variable
PRAISONAI_NO_ONBOARD=1 curl -fsSL https://praison.ai/install.sh | bash

​
Run onboarding separately later

# Install first without onboarding
curl -fsSL https://praison.ai/install.sh | bash -s -- --no-onboard

# Set up LLM keys
praisonai setup

# Set up messaging bot when ready
praisonai onboard

​
Switch platforms

# Currently using Telegram, switch to Discord
praisonai onboard
# Choose Discord and enter Discord bot token

​
Re-generate auth token

# Run onboarding again to get a fresh auth token
praisonai onboard

​
Which Platform Should I Use?

Choose based on:
PlatformBest ForSetup DifficultyFeatures
TelegramPersonal use, experimentationEasyRich bot API, inline keyboards
DiscordGaming communities, developer teamsMediumVoice channels, rich embeds
SlackBusiness teams, professional workflowsMediumThread support, workspace integration
WhatsAppCustomer support, global reachHardBusiness accounts required

​
Best Practices

Telegram has the simplest setup process and most permissive API limits. Use it for initial testing before moving to your target platform.
Bot tokens are stored in ~/.praisonai/config/. Ensure this directory has proper permissions (600) and exclude it from version control.
After onboarding, visit the dashboard URL from the Done panel to confirm the web interface is working and authentication is set up correctly.
If bots aren’t responding or services seem down, run praisonai doctor for diagnostic information and common fixes.

Installation Guide

Complete installer documentation including onboarding flow

Dashboard

Web dashboard for managing agents and monitoring bots

Bot Security

Security best practices for messaging bots

Quick Install

One-liner installation including onboarding prompt