PraisonAI Claw

Connect your AI agents to Telegram, Discord, Slack and more — all from a single command

PraisonAI Claw connects your AI agents to Telegram, Discord, Slack, and more messaging platforms — all from a single command. Install once, launch the dashboard, and add channels from the UI.

Quick Start

1. Install

   pip install "praisonai[claw]"

2. Set your API key

   export OPENAI_API_KEY="your-api-key-here"

3. Launch

   praisonai claw

   Open http://localhost:8082 — the dashboard is live.

Connect a Channel (via UI)

The easiest way to add a messaging channel is through the dashboard:

1. Open the Channels page

   In the dashboard sidebar, click 📡 Channels.

2. Click + Add Channel

   Select a platform from the dropdown:

   Platform	Token needed
   ✈️ Telegram	Bot Token (from @BotFather)
   🎮 Discord	Bot Token (from Developer Portal)
   💬 Slack	Bot Token + App Token
   📱 WhatsApp	Access Token + Phone Number ID
   🔒 Signal	Phone Number + API URL
   💼 Google Chat	Service Account + Space Name
   🟣 Nostr	Private Key + Relay URL

3. Paste your token and click Add

   The dashboard shows setup steps for each platform right in the form. Once added, your bot starts automatically — you’ll see a ● Connected status.

4. Test the connection

   Click 🔍 Test on any channel card to verify your bot is responding. You can also Disable, Restart, or Delete channels from the same card.

Get Platform Tokens

Telegram

1. Open Telegram → search @BotFather
2. Send /newbot → follow the prompts
3. Copy the Bot Token

Discord

1. Go to discord.com/developers → New Application
2. Go to Bot → Reset Token → copy it
3. Enable Message Content Intent under Privileged Gateway Intents
4. Go to OAuth2 → URL Generator → select bot scope → invite to your server

Slack

1. Go to api.slack.com/apps → Create New App → From Scratch
2. OAuth & Permissions → add scopes: chat:write, app_mentions:read
3. Enable Socket Mode → copy the App Token (xapp-...)
4. Install to Workspace → copy the Bot Token (xoxb-...)

CLI Options

praisonai claw                        # Dashboard on port 8082
praisonai claw --port 9000            # Custom port
praisonai claw --host 127.0.0.1      # Localhost only
praisonai claw --app my-dashboard.py  # Custom app file
praisonai claw --reload               # Auto-reload on changes

Dashboard Pages

The praisonai claw dashboard comes with 13 built-in pages:

What’s Included

pip install "praisonai[claw]" installs:

Related

• Bot Operating System — bot architecture and lifecycle
• AgentOS — operating system for AI agents