yetone/metaclaw-dist/channel-setup

Channel Setup Guide

This skill guides users through configuring communication channels for MetaClaw.

Supported Channels

Setup Instructions

Slack (Recommended for teams)

1. Go to https://api.slack.com/apps and click "Create New App"
2. Choose "From scratch", name it "MetaClaw", select your workspace
3. Under "OAuth & Permissions", add these Bot Token Scopes:

• chat:write
• app_mentions:read
• im:history
• im:read
• im:write

1. Install the app to your workspace
2. Copy the "Bot User OAuth Token" → set as SLACK_BOT_TOKEN in .env
3. Under "Socket Mode", enable it and generate an app-level token → set as SLACK_APP_TOKEN
4. Under "Event Subscriptions", enable and subscribe to:

• message.im
• app_mention

1. Enable in metaclaw.toml:

[channels.slack]
enabled = true

Discord

1. Go to https://discord.com/developers/applications
2. Create a new application, name it "MetaClaw"
3. Go to "Bot" → Add Bot
4. Enable "Message Content Intent"
5. Copy the token → set as DISCORD_BOT_TOKEN in .env
6. Generate invite URL with permissions: Send Messages, Read Messages
7. Enable in metaclaw.toml:

[channels.discord]
enabled = true

Telegram

1. Message @BotFather on Telegram
2. Send /newbot and follow the prompts
3. Copy the token → set as TELEGRAM_BOT_TOKEN in .env
4. Enable in metaclaw.toml:

[channels.telegram]
enabled = true

Webhook (Generic)

For custom integrations, use the generic webhook channel:

[channels.webhook]
enabled = true
secret = "your-webhook-secret"

POST to http://your-server:8000/webhook/incoming with:

{
  "text": "Your message",
  "user_id": "user123",
  "channel_id": "channel456"
}

Email

[channels.email]
enabled = true

Set in .env:

EMAIL_SMTP_HOST=smtp.gmail.com
EMAIL_SMTP_PORT=587
EMAIL_IMAP_HOST=imap.gmail.com
EMAIL_USERNAME=your@email.com
EMAIL_PASSWORD=your-app-password

Note: For Gmail, use an App Password (not your regular password).

Verification

After configuring, start the server:

metaclaw start

Check the logs for successful channel connections. Send a test message through the configured channel.