> ## Documentation Index
> Fetch the complete documentation index at: https://praison.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<Steps>
  <Step title="Install">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    pip install "praisonai[claw]"
    ```
  </Step>

  <Step title="Set your API key">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    export OPENAI_API_KEY="your-api-key-here"
    ```
  </Step>

  <Step title="Launch">
    ```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
    praisonai claw
    ```

    Open **[http://localhost:8082](http://localhost:8082)** — the dashboard is live.
  </Step>
</Steps>

## Connect a Channel (via UI)

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

<Steps>
  <Step title="Open the Channels page">
    In the dashboard sidebar, click **📡 Channels**.
  </Step>

  <Step title="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           |
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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](https://discord.com/developers/applications) → **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](https://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

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
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:

| Page               | What it does                           |
| ------------------ | -------------------------------------- |
| 💬 **Chat**        | AI agent chat with streaming           |
| 📡 **Channels**    | Connect and manage messaging platforms |
| 🤖 **Agents**      | Create and manage AI agents            |
| ⚡ **Skills**       | Browse tools and plugins               |
| 🧠 **Memory**      | View and manage agent memory           |
| 📚 **Knowledge**   | Knowledge base and RAG                 |
| 🛡️ **Guardrails** | Input/output safety rules              |
| ⏰ **Cron**         | Scheduled agent jobs                   |
| 📋 **Sessions**    | Conversation history                   |
| 📈 **Usage**       | Token usage and costs                  |
| ⚙️ **Config**      | Runtime configuration                  |
| 📜 **Logs**        | Server logs                            |
| 🐛 **Debug**       | System debug info                      |

## What's Included

`pip install "praisonai[claw]"` installs:

| Component              | What you get                                                   |
| ---------------------- | -------------------------------------------------------------- |
| **Dashboard**          | Full web UI with 13+ admin pages                               |
| **Bot Channels**       | Telegram, Discord, Slack, WhatsApp, Signal, Google Chat, Nostr |
| **Agent Runtime**      | Multi-agent orchestration with 100+ tools                      |
| **Gateway**            | API server with SSE streaming                                  |
| **Web Search**         | Tavily, Crawl4AI, DuckDuckGo                                   |
| **Session Management** | Per-user conversation isolation                                |

## Related

* [Bot Operating System](/docs/concepts/bot-os) — bot architecture and lifecycle
* [AgentOS](/docs/concepts/agentos) — operating system for AI agents