Channels Overview

Channels are interfaces that allow your agents to communicate through different platforms.

Available Channels

Channel	Status	Features
Web UI	✅ Stable	Full dashboard experience
Terminal (TUI)	✅ Stable	Command-line interface
Telegram	✅ Stable	Bot, voice messages, commands
Discord	✅ Stable	Bot, mentions, embeds
Slack	🟡 Beta	App, mentions, blocks
WhatsApp	🟡 Beta	Bridge, basic messaging

Architecture

                    ┌──────────────────────┐
                    │    moxxy Gateway     │
                    └──────────────────────┘
                              │
        ┌─────────────────────┼─────────────────────┐
        │                     │                     │
        ▼                     ▼                     ▼
┌───────────────┐   ┌───────────────────┐   ┌──────────────┐
│    Web UI     │   │ Messaging Bots    │   │    TUI       │
│  (Dashboard)  │   │ TG/DC/SLACK/WA    │   │ (Terminal)   │
└───────────────┘   └───────────────────┘   └──────────────┘
        │                     │                     │
        └─────────────────────┼─────────────────────┘
                              │
                              ▼
                    ┌──────────────────┐
                    │   Agent Pool     │
                    │   (Brain/Skills) │
                    └──────────────────┘

Channel Features

Web UI

The primary interface for interacting with agents.

Features:

• Real-time chat with streaming
• Skills management
• Memory viewer
• Vault management
• Channel configuration
• Schedule management

Access:

moxxy web

Terminal (TUI)

Command-line interface for terminal users.

Features:

• Interactive chat
• Message history
• Slash commands
• Agent switching

Access:

moxxy tui

Telegram

Connect your agent as a Telegram bot.

Features:

• Full bot support
• Voice message transcription
• Bot commands (/start, /skills, /new)
• Pairing mechanism for security

Setup:

moxxy channel telegram --agent default

Discord

Connect your agent as a Discord bot.

Features:

• Server integration
• Mention-based triggering
• Rich embeds
• Channel support

Setup:

moxxy channel discord --agent default

Slack

Connect your agent as a Slack app.

Features:

• Workspace integration
• App mentions
• Block kit support
• DM support

Setup:

moxxy channel slack --agent default

WhatsApp

Connect via WhatsApp bridge.

Features:

• Personal number integration
• Direct messaging
• Group support

Setup:

moxxy channel whatsapp --agent default

Channel Configuration

Multi-Channel Agents

An agent can be connected to multiple channels:

# Connect to Telegram
moxxy channel telegram --agent assistant

# Also connect to Discord
moxxy channel discord --agent assistant

# Also connect to Slack
moxxy channel slack --agent assistant

Channel-Specific Agents

Different agents for different channels:

# Telegram customer support
moxxy channel telegram --agent support

# Discord community bot
moxxy channel discord --agent community

# Slack team assistant
moxxy channel slack --agent team-assistant

Channel Credentials

Store channel tokens in the vault:

# Telegram
moxxy run --agent default --prompt "Store '123456:ABC' in vault as telegram_token"

# Discord
moxxy run --agent default --prompt "Store 'bot_token' in vault as discord_token"

# Slack
moxxy run --agent default --prompt "Store 'xoxb-xxx' in vault as slack_bot_token"

Message Flow

Incoming Messages

User Message → Channel → Gateway → Agent Brain → Response → Channel → User

1. User sends message on channel
2. Channel adapter receives and formats
3. Gateway routes to appropriate agent
4. Brain processes with ReAct loop
5. Response sent back to channel
6. Channel adapter formats and delivers

Rate Limiting

Channels implement rate limiting:

Channel	Limit	Strategy
Telegram	30/sec	Token bucket
Discord	50/sec	Token bucket
Slack	1/sec per channel	Queue
WhatsApp	Varies	Exponential backoff

Channel Commands

Telegram Bot Commands

Command	Description
/start	Pair your account with the bot
/skills	List available skills
/new	Start a fresh session
/help	Show help message

Discord

• Mention the bot to trigger: @Moxxy Hello!
• Bot responds in the same channel

Slack

• Mention the app: @Moxxy help me with this
• DM the app directly

Troubleshooting

Channel Not Responding

1. Check gateway status:

   moxxy gateway status

2. Check channel logs:

   moxxy logs | grep -i telegram

3. Verify credentials in vault

Connection Lost

1. Check network connectivity
2. Verify API token is valid
3. Restart gateway:

   moxxy gateway restart

Rate Limited

1. Reduce message frequency
2. Implement queuing
3. Check channel-specific limits

Best Practices

Channel Selection

• Web UI - Development, administration
• TUI - Terminal users, quick access
• Telegram - Personal use, mobile access
• Discord - Community management
• Slack - Team collaboration
• WhatsApp - Direct customer communication

Security

1. Use pairing for Telegram
2. Limit mentions in Discord/Slack
3. Monitor usage via logs
4. Rotate tokens regularly
5. Use separate agents for different access levels

Performance

1. One channel per agent for isolation
2. Monitor rate limits
3. Queue high-volume messages
4. Use webhooks for integrations