Multi-Channel Setup

Weaver supports simultaneous connections to multiple chat platforms, allowing you to deploy AI agents across your entire communication infrastructure. Each channel can have independent configurations and access controls.

Supported Channels

Weaver supports the following chat platforms (pkg/config/config.go:71):

Telegram - Popular messaging platform with bot API
Discord - Gaming and community platform
Slack - Enterprise team collaboration
WhatsApp - Via bridge server
LINE - Popular in Asia-Pacific region
Feishu (Lark) - Enterprise platform by ByteDance
DingTalk - Enterprise platform by Alibaba
QQ - Chinese instant messaging
OneBot - Universal bot protocol
MaixCam - IoT device integration

Channel Configuration Structure

All channels follow a common configuration pattern (pkg/config/config.go:71):

type ChannelsConfig struct {
    WhatsApp WhatsAppConfig `json:"whatsapp"`
    Telegram TelegramConfig `json:"telegram"`
    Feishu   FeishuConfig   `json:"feishu"`
    Discord  DiscordConfig  `json:"discord"`
    MaixCam  MaixCamConfig  `json:"maixcam"`
    QQ       QQConfig       `json:"qq"`
    DingTalk DingTalkConfig `json:"dingtalk"`
    Slack    SlackConfig    `json:"slack"`
    LINE     LINEConfig     `json:"line"`
    OneBot   OneBotConfig   `json:"onebot"`
}

Telegram Setup

Create a Telegram Bot

Open Telegram and search for @BotFather
Send /newbot command
Follow prompts to set bot name and username
Copy the API token (format: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11)

Configure Weaver

Add Telegram configuration to ~/.weaver/config.json:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11",
      "allow_from": ["123456789"],
      "proxy": ""
    }
  }
}

Or use environment variables:

export TELEGRAM_BOT_TOKEN=123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
export WEAVER_CHANNELS_TELEGRAM_ENABLED=true
export WEAVER_CHANNELS_TELEGRAM_ALLOW_FROM=123456789,987654321

Get Your User ID

To find your Telegram user ID:

Start a chat with your bot
Send any message
Check Weaver logs for the user ID
Add it to allow_from array

Start the Gateway

weaver gateway

Your bot is now online and will respond to messages from allowed users.

Telegram Configuration Reference

From pkg/config/config.go:90:

type TelegramConfig struct {
    Enabled   bool                `json:"enabled" env:"WEAVER_CHANNELS_TELEGRAM_ENABLED"`
    Token     string              `json:"token" env:"WEAVER_CHANNELS_TELEGRAM_TOKEN"`
    Proxy     string              `json:"proxy" env:"WEAVER_CHANNELS_TELEGRAM_PROXY"`
    AllowFrom FlexibleStringSlice `json:"allow_from" env:"WEAVER_CHANNELS_TELEGRAM_ALLOW_FROM"`
}

Discord Setup

Create Discord Application

Go to Discord Developer Portal
Click “New Application”
Give your application a name
Navigate to “Bot” section
Click “Add Bot”
Copy the bot token

Enable Required Intents

In the Bot settings, enable:

Server Members Intent
Message Content Intent

Configure Weaver

{
  "channels": {
    "discord": {
      "enabled": true,
      "token": "YOUR_DISCORD_BOT_TOKEN",
      "allow_from": ["USER_ID_1", "USER_ID_2"]
    }
  }
}

Or via environment:

export DISCORD_BOT_TOKEN=YOUR_DISCORD_BOT_TOKEN
export WEAVER_CHANNELS_DISCORD_ENABLED=true

Invite Bot to Server

Go to OAuth2 → URL Generator in Discord Developer Portal
Select scopes: bot
Select permissions: Send Messages, Read Message History
Copy generated URL and open in browser
Select server and authorize

Discord Configuration Reference

From pkg/config/config.go:106:

type DiscordConfig struct {
    Enabled   bool                `json:"enabled" env:"WEAVER_CHANNELS_DISCORD_ENABLED"`
    Token     string              `json:"token" env:"WEAVER_CHANNELS_DISCORD_TOKEN"`
    AllowFrom FlexibleStringSlice `json:"allow_from" env:"WEAVER_CHANNELS_DISCORD_ALLOW_FROM"`
}

Slack Setup

Create Slack App

Go to Slack API
Click “Create New App” → “From scratch”
Name your app and select workspace

Configure Bot Permissions

Under “OAuth & Permissions”, add scopes:

app_mentions:read
chat:write
channels:history
groups:history
im:history
mpim:history

Enable Socket Mode

Go to “Socket Mode” in sidebar
Enable Socket Mode
Create an app-level token with connections:write scope
Copy the token (starts with xapp-)

Install App to Workspace

Go to “OAuth & Permissions”
Click “Install to Workspace”
Copy the Bot User OAuth Token (starts with xoxb-)

Configure Weaver

{
  "channels": {
    "slack": {
      "enabled": true,
      "bot_token": "xoxb-YOUR-BOT-TOKEN",
      "app_token": "xapp-YOUR-APP-TOKEN",
      "allow_from": ["U01234ABCDE"]
    }
  }
}

Or via environment:

export WEAVER_CHANNELS_SLACK_BOT_TOKEN=xoxb-YOUR-BOT-TOKEN
export WEAVER_CHANNELS_SLACK_APP_TOKEN=xapp-YOUR-APP-TOKEN
export WEAVER_CHANNELS_SLACK_ENABLED=true

Slack Configuration Reference

From pkg/config/config.go:133:

type SlackConfig struct {
    Enabled   bool                `json:"enabled" env:"WEAVER_CHANNELS_SLACK_ENABLED"`
    BotToken  string              `json:"bot_token" env:"WEAVER_CHANNELS_SLACK_BOT_TOKEN"`
    AppToken  string              `json:"app_token" env:"WEAVER_CHANNELS_SLACK_APP_TOKEN"`
    AllowFrom FlexibleStringSlice `json:"allow_from" env:"WEAVER_CHANNELS_SLACK_ALLOW_FROM"`
}

LINE Setup

Create LINE Channel

Go to LINE Developers Console
Create a new provider or use existing
Create a Messaging API channel
Note your Channel Secret and Channel Access Token

Configure Webhook

LINE requires a public webhook endpoint:

{
  "channels": {
    "line": {
      "enabled": true,
      "channel_secret": "YOUR_CHANNEL_SECRET",
      "channel_access_token": "YOUR_ACCESS_TOKEN",
      "webhook_host": "0.0.0.0",
      "webhook_port": 18791,
      "webhook_path": "/webhook/line",
      "allow_from": []
    }
  }
}

Set Webhook URL

In LINE Developers Console:

Go to Messaging API settings
Set Webhook URL to https://your-domain.com:18791/webhook/line
Enable “Use webhook”
Disable “Auto-reply messages”

Use Environment Variables

export LINE_CHANNEL_SECRET=YOUR_CHANNEL_SECRET
export LINE_CHANNEL_ACCESS_TOKEN=YOUR_ACCESS_TOKEN
export WEAVER_CHANNELS_LINE_ENABLED=true

LINE Configuration Reference

From pkg/config/config.go:140:

type LINEConfig struct {
    Enabled            bool                `json:"enabled" env:"WEAVER_CHANNELS_LINE_ENABLED"`
    ChannelSecret      string              `json:"channel_secret" env:"WEAVER_CHANNELS_LINE_CHANNEL_SECRET"`
    ChannelAccessToken string              `json:"channel_access_token" env:"WEAVER_CHANNELS_LINE_CHANNEL_ACCESS_TOKEN"`
    WebhookHost        string              `json:"webhook_host" env:"WEAVER_CHANNELS_LINE_WEBHOOK_HOST"`
    WebhookPort        int                 `json:"webhook_port" env:"WEAVER_CHANNELS_LINE_WEBHOOK_PORT"`
    WebhookPath        string              `json:"webhook_path" env:"WEAVER_CHANNELS_LINE_WEBHOOK_PATH"`
    AllowFrom          FlexibleStringSlice `json:"allow_from" env:"WEAVER_CHANNELS_LINE_ALLOW_FROM"`
}

Access Control

All channels support the allow_from field to restrict access to specific users:

Flexible String Format

From pkg/config/config.go:13, allow_from accepts both strings and numbers:

{
  "allow_from": [
    "123456789",
    987654321,
    "user-id-string"
  ]
}

Unrestricted Access

To allow all users (not recommended for production):

{
  "allow_from": []
}

Multi-Channel Configuration Example

Run agents on multiple platforms simultaneously:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "${TELEGRAM_BOT_TOKEN}",
      "allow_from": ["123456789", "987654321"]
    },
    "discord": {
      "enabled": true,
      "token": "${DISCORD_BOT_TOKEN}",
      "allow_from": ["USER_ID_1"]
    },
    "slack": {
      "enabled": true,
      "bot_token": "${SLACK_BOT_TOKEN}",
      "app_token": "${SLACK_APP_TOKEN}",
      "allow_from": ["U01234ABCDE"]
    },
    "line": {
      "enabled": true,
      "channel_secret": "${LINE_CHANNEL_SECRET}",
      "channel_access_token": "${LINE_CHANNEL_ACCESS_TOKEN}",
      "webhook_host": "0.0.0.0",
      "webhook_port": 18791,
      "webhook_path": "/webhook/line"
    }
  },
  "gateway": {
    "host": "0.0.0.0",
    "port": 18790
  }
}

Advanced Channel Configuration

WhatsApp (via Bridge)

From pkg/config/config.go:84:

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "bridge_url": "ws://localhost:3001",
      "allow_from": ["1234567890"]
    }
  }
}

Requires a WhatsApp bridge server (e.g., whatsapp-web.js).

Feishu (Lark)

From pkg/config/config.go:97:

{
  "channels": {
    "feishu": {
      "enabled": true,
      "app_id": "YOUR_APP_ID",
      "app_secret": "YOUR_APP_SECRET",
      "encrypt_key": "YOUR_ENCRYPT_KEY",
      "verification_token": "YOUR_VERIFICATION_TOKEN",
      "allow_from": []
    }
  }
}

DingTalk

From pkg/config/config.go:126:

{
  "channels": {
    "dingtalk": {
      "enabled": true,
      "client_id": "YOUR_CLIENT_ID",
      "client_secret": "YOUR_CLIENT_SECRET",
      "allow_from": []
    }
  }
}

OneBot Protocol

From pkg/config/config.go:150:

{
  "channels": {
    "onebot": {
      "enabled": true,
      "ws_url": "ws://127.0.0.1:3001",
      "access_token": "YOUR_TOKEN",
      "reconnect_interval": 5,
      "group_trigger_prefix": ["@bot", "!"],
      "allow_from": []
    }
  }
}

Supports QQ, Kaiheila, and other platforms via OneBot v11/v12 protocol.

Running the Gateway

Start with All Configured Channels

weaver gateway

Weaver will:

Load configuration from ~/.weaver/config.json
Connect to all enabled channels
Start listening for messages
Health check available at http://localhost:18790/health

Verify Connections

Check logs for successful channel connections:

INFO  Telegram channel connected
INFO  Discord channel connected
INFO  Slack channel connected
INFO  Gateway started on 0.0.0.0:18790

Test Each Channel

Send a test message from each platform to verify agent responses.

Troubleshooting

Channel Won't Connect

Verify API tokens are correct
Check enabled: true is set
Review Weaver logs for error messages
Ensure network connectivity to platform APIs

Bot Doesn't Respond

Check if your user ID is in allow_from list
Verify bot has necessary permissions
For Discord/Slack: Ensure bot is in the channel/server
Check Weaver logs for incoming message events

Webhook Errors (LINE, Feishu)

Ensure webhook port is open and accessible
Use a reverse proxy (nginx) for HTTPS
Verify webhook URL is set correctly in platform console
Check firewall rules

Environment Variables Not Loaded

Use .env file in working directory
Export variables before running weaver gateway
Check variable names match exact format (case-sensitive)
Restart gateway after changing environment

Next Steps

Configure OAuth Authentication for secure provider access
Set up Docker Deployment for production multi-channel hosting
Learn about Spawning Agents for advanced channel workflows

Get Started

Core Concepts

Guides

Features

Multi-Channel Setup

Supported Channels

Channel Configuration Structure

Telegram Setup

Telegram Configuration Reference

Discord Setup

Discord Configuration Reference

Slack Setup

Slack Configuration Reference

LINE Setup

LINE Configuration Reference

Access Control

Flexible String Format

Unrestricted Access

Multi-Channel Configuration Example

Advanced Channel Configuration

WhatsApp (via Bridge)

Feishu (Lark)

DingTalk

OneBot Protocol

Running the Gateway

Troubleshooting

Next Steps

Get Started

Core Concepts

Guides

Features

Documentation Index

​Supported Channels

​Channel Configuration Structure

​Telegram Setup

​Telegram Configuration Reference

​Discord Setup

​Discord Configuration Reference

​Slack Setup

​Slack Configuration Reference

​LINE Setup

​LINE Configuration Reference

​Access Control

​Flexible String Format

​Unrestricted Access

​Multi-Channel Configuration Example

​Advanced Channel Configuration

​WhatsApp (via Bridge)

​Feishu (Lark)

​DingTalk

​OneBot Protocol

​Running the Gateway

​Troubleshooting

​Next Steps

Supported Channels

Channel Configuration Structure

Telegram Setup

Telegram Configuration Reference

Discord Setup

Discord Configuration Reference

Slack Setup

Slack Configuration Reference

LINE Setup

LINE Configuration Reference

Access Control

Flexible String Format

Unrestricted Access

Multi-Channel Configuration Example

Advanced Channel Configuration

WhatsApp (via Bridge)

Feishu (Lark)

DingTalk

OneBot Protocol

Running the Gateway

Troubleshooting

Next Steps