Capabilities
Setup
1
Register a Matrix account
Create a bot account on your Matrix homeserver (or matrix.org). Use a dedicated account, not your personal one.
2
Get an access token
Log in and retrieve the access token:
3
Get your User ID
User ID format:
@profclaw-bot:matrix.org4
Configure profClaw
5
Invite the bot to rooms
In Element or any Matrix client, invite
@profclaw-bot:matrix.org to your room.Environment Variables
Configuration Example
- .env
- Self-hosted homeserver
- settings.yml
Notes
- Matrix uses long-polling (
/sync) by default - no public webhook URL required. - E2EE requires the bot’s device to exchange keys with room members. Enable only if needed.
- The bot joins rooms automatically when invited.
- For Synapse homeservers, you can register the bot with admin-level access using the registration token.
- Works with any Matrix client: Element, FluffyChat, Nheko, etc.
Related
- Chat Providers Overview - Compare all 27 supported channels
- Rocket.Chat - Another self-hosted open-source messaging option
- Signal - End-to-end encrypted messaging via signald bridge
- profclaw channels - Enable and test the Matrix connection from the CLI