Skip to main content

​
Matrix

Connect to a Matrix homeserver so users can chat with your agents via any Matrix client (Element, FluffyChat, etc.).

​
Setup

  1. Create a bot account on your Matrix homeserver
  2. Note the homeserver URL, username, and password
  3. In Pawz, go to Settings → Channels
  4. Select Matrix
  5. Enter:
    • Homeserver URL — e.g., https://matrix.org
    • Username — bot’s Matrix ID (e.g., @pawz-bot:matrix.org)
    • Password — bot account password
  6. Start the channel

​
Configuration

FieldRequiredDescription
Homeserver URLYesMatrix server URL
UsernameYesBot’s Matrix user ID
PasswordYesBot account password
DM policyYesWho can message the bot
Allowed usersFor allowlistMatrix user IDs

​
Features

  • DMs and room messages
  • Per-user sessions with memory
  • Prompt injection scanning
  • Agent routing via channel routing rules
  • Auto-join on invite
:::info End-to-end encryption supported The Matrix bridge uses matrix-sdk with vodozemac for Olm/Megolm encryption. Messages in E2EE rooms are automatically decrypted and replies are automatically encrypted. Device keys and room sessions are persisted in a local SQLite crypto store (~/Documents/Paw/matrix-store/), so key continuity is maintained across restarts. :::

​
Tips

  • For self-hosted Matrix (Synapse, Dendrite), use your server’s URL
  • Invite the bot to rooms where you want it active
  • Use Element or any Matrix client to test