Extension Channels - SimpleClaw

Beyond the core channels, SimpleClaw supports additional messaging platforms through extensions. These channels are available as separate plugins that can be enabled as needed.

Available Extension Channels

Matrix

Decentralized communication protocol Matrix is an open standard for decentralized, real-time communication.

Matrix Setup

channels:
  matrix:
    enabled: true
    homeserver: "https://matrix.org"
    accessToken: "your-access-token"

Features:

End-to-end encryption
Federation across servers
Group chats and spaces
Media support

Channel ID: matrix

Microsoft Teams

Enterprise collaboration platform Connect SimpleClaw to Microsoft Teams for organizational use.

Microsoft Teams Setup

channels:
  msteams:
    enabled: true
    # Teams-specific configuration

Features:

Teams and channel integration
Direct messaging
Bot framework integration

Channel ID: msteams

Google Chat

Google Workspace messaging Integrate with Google Chat for Google Workspace environments.

Google Chat Setup

channels:
  googlechat:
    enabled: true
    # Google Chat-specific configuration

Features:

Spaces and rooms
Direct messages
Google Workspace integration

Channel ID: googlechat

Mattermost

Open-source team collaboration Mattermost is a self-hosted Slack alternative.

Mattermost Setup

channels:
  mattermost:
    enabled: true
    url: "https://your-mattermost.com"
    token: "your-bot-token"

Features:

Self-hosted deployment
Channels and direct messages
Slash commands
Webhooks and integrations

Channel ID: mattermost

IRC

Internet Relay Chat Classic IRC protocol support for connecting to IRC networks.

IRC Setup

channels:
  irc:
    enabled: true
    server: "irc.libera.chat"
    port: 6667
    nick: "SimpleClaw"
    channels:
      - "#simpleclaw"

Features:

Multiple network support
Channel and private messages
SASL authentication
SSL/TLS connections

Channel ID: irc

LINE

Popular messaging app in Asia LINE integration for messaging in Asian markets.

LINE Setup

channels:
  line:
    enabled: true
    channelSecret: "your-channel-secret"
    channelAccessToken: "your-access-token"

Features:

Direct and group messages
Rich media support
Stickers and reactions

Channel ID: line

Zalo

Vietnamese messaging platform Integrate with Zalo for Vietnamese market communication.

Zalo Setup

channels:
  zalo:
    enabled: true
    # Zalo-specific configuration

Features:

Official account integration
User messaging
Vietnamese language support

Channel ID: zaloUser Mode: There’s also a zalouser extension for personal Zalo accounts.

Synology Chat

Synology NAS chat platform Connect to Synology Chat on Synology NAS devices.

Synology Chat Setup

channels:
  synology-chat:
    enabled: true
    url: "https://your-nas.com"
    token: "your-token"

Features:

Private cloud messaging
Self-hosted on Synology NAS
Channels and direct messages

Channel ID: synology-chat

Feishu (Lark)

Enterprise collaboration platform Feishu (international brand: Lark) integration for enterprise communication.

Feishu Setup

channels:
  feishu:
    enabled: true
    # Feishu-specific configuration

Features:

Enterprise messaging
Bot integration
Asian market focus

Channel ID: feishu

Nextcloud Talk

Nextcloud integrated chat Chat integration for Nextcloud self-hosted cloud platform.

Nextcloud Talk Setup

channels:
  nextcloud-talk:
    enabled: true
    url: "https://your-nextcloud.com"
    username: "bot-user"
    password: "bot-password"

Features:

Self-hosted
Video calls integration
File sharing

Channel ID: nextcloud-talk

Nostr

Decentralized social protocol Nostr protocol integration for decentralized messaging.

Nostr Setup

channels:
  nostr:
    enabled: true
    relays:
      - "wss://relay.nostr.info"
    privateKey: "your-private-key"

Features:

Decentralized protocol
Relay-based messaging
Cryptographic identity

Channel ID: nostr

Twitch

Live streaming chat Integrate with Twitch chat for streaming platforms.

Twitch Setup

channels:
  twitch:
    enabled: true
    username: "your-bot-name"
    oauth: "oauth:your-token"
    channels:
      - "your-channel"

Features:

Chat integration
Channel moderation
Emotes support

Channel ID: twitch

BlueBubbles

iMessage alternative client BlueBubbles server integration for iMessage access.

BlueBubbles Setup

channels:
  bluebubbles:
    enabled: true
    url: "http://your-server:1234"
    password: "your-password"

Features:

iMessage without macOS
Remote iMessage server
Cross-platform access

Channel ID: bluebubbles

Tlon (Urbit)

Urbit messaging Integration with Urbit/Tlon decentralized platform.

Tlon Setup

channels:
  tlon:
    enabled: true
    # Tlon-specific configuration

Features:

Urbit OS integration
Peer-to-peer messaging
Decentralized identity

Channel ID: tlon

Voice Channels

Voice Call

Telephony integration Voice call support through telephony providers (Twilio, Telnyx, Plivo).

Voice Call Setup

channels:
  voice-call:
    enabled: true
    provider: "twilio"  # or telnyx, plivo
    accountSid: "your-account-sid"
    authToken: "your-auth-token"
    phoneNumber: "+1234567890"

Supported Providers:

Twilio
Telnyx
Plivo

Features:

Inbound/outbound calls
TTS (text-to-speech)
STT (speech-to-text)
Interactive voice response

Channel ID: voice-call

Installing Extension Channels

Most extension channels are included with SimpleClaw. To enable:

# Check available extensions
simpleclaw extensions list

# Enable specific channel
simpleclaw config set channels.<channel-id>.enabled true

Extension Development

Developers can create custom channel extensions. Extension channels are located in the extensions/ directory of the SimpleClaw repository. Extension structure:

extensions/your-channel/
├── src/
│   ├── channel.ts       # Channel plugin implementation
│   └── runtime.ts       # Runtime helpers
├── index.ts             # Plugin entry point
├── package.json         # Extension metadata
└── simpleclaw.plugin.json  # Plugin configuration

Key files:

simpleclaw.plugin.json: Declares channel ID and config schema
src/channel.ts: Implements ChannelPlugin interface
index.ts: Exports plugin for SimpleClaw to load

Configuration Reference

Each extension channel has its own configuration schema defined in simpleclaw.plugin.json. Check the specific extension directory for:

Configuration options
Authentication requirements
Capability matrix
Setup instructions

Extension source code: ~/workspace/source/extensions/<channel-name>/

Feature Matrix

Channel	DMs	Groups	Threads	Media	E2EE	Self-Hosted
Matrix	✓	✓	✓	✓	✓	✓
Teams	✓	✓	✓	✓	—	—
Google Chat	✓	✓	✓	✓	—	—
Mattermost	✓	✓	✓	✓	—	✓
IRC	✓	✓	—	—	—	✓
LINE	✓	✓	—	✓	—	—
Zalo	✓	✓	—	✓	—	—
Synology Chat	✓	✓	—	✓	—	✓
Feishu	✓	✓	✓	✓	—	—
Nextcloud Talk	✓	✓	—	✓	✓	✓
Nostr	✓	✓	—	✓	✓	✓
Twitch	—	✓	—	—	—	—
BlueBubbles	✓	✓	—	✓	—	—
Tlon	✓	✓	—	✓	✓	✓
Voice Call	✓	—	—	✓	—	—

Getting Help

For extension-specific issues:

Check extension README: extensions/<channel>/README.md
Review source code: extensions/<channel>/src/
Check SimpleClaw documentation
Open GitHub issue with channel/<channel-name> label

Next Steps

Core Channels

Learn about core messaging channels

Configuration

Detailed configuration reference

Extension Development

Build custom channel plugins

Security

Configure security policies

Documentation Index

​Available Extension Channels

​Matrix

​Microsoft Teams

​Google Chat

​Mattermost

​IRC

​LINE

​Zalo

​Synology Chat

​Feishu (Lark)

​Nextcloud Talk

​Nostr

​Twitch

​BlueBubbles

​Tlon (Urbit)

​Voice Channels

​Voice Call

​Installing Extension Channels

​Extension Development

​Configuration Reference

​Feature Matrix

​Getting Help

​Next Steps

Core Channels

Configuration

Extension Development

Security

Available Extension Channels

Matrix

Microsoft Teams

Google Chat

Mattermost

IRC

LINE

Zalo

Synology Chat

Feishu (Lark)

Nextcloud Talk

Nostr

Twitch

BlueBubbles

Tlon (Urbit)

Voice Channels

Voice Call

Installing Extension Channels

Extension Development

Configuration Reference

Feature Matrix

Getting Help

Next Steps