Matrix - profClaw

Matrix is an open-source, federated communication protocol. profClaw connects as a Matrix bot user, joining rooms and responding to messages across any Matrix homeserver.

Capabilities

Feature	Supported
Direct messages	Yes
Room messages	Yes
End-to-end encryption	Optional
File uploads	Yes
Reactions	Yes
Federation	Yes (any homeserver)
Room allowlist	Yes

Setup

Create a bot account on your Matrix homeserver (or matrix.org). Use a dedicated account, not your personal one.

Get an access token

curl -X POST https://matrix.org/_matrix/client/r0/login \
  -H "Content-Type: application/json" \
  -d '{"type":"m.login.password","user":"profclaw-bot","password":"your-password"}'
# Copy the access_token from the response

Get your User ID

User ID format: @profclaw-bot:matrix.org

Configure profClaw

MATRIX_HOMESERVER_URL=https://matrix.org
MATRIX_ACCESS_TOKEN=syt_...
MATRIX_USER_ID=@profclaw-bot:matrix.org

Invite the bot to rooms

In Element or any Matrix client, invite @profclaw-bot:matrix.org to your room.

Environment Variables

string

required

Your Matrix homeserver URL (e.g., https://matrix.org or https://your-homeserver.com).

string

required

Bot user access token. Format: syt_...

string

required

Bot user ID. Format: @username:homeserver.com

string

Device ID for E2EE sessions. Auto-generated if not set.

boolean

Enable end-to-end encryption. Defaults to false. Requires additional setup.

string

Comma-separated list of room IDs the bot will respond in. Leave empty to allow all rooms.

Configuration Example

.env
Self-hosted homeserver
settings.yml

MATRIX_HOMESERVER_URL=https://matrix.org
MATRIX_ACCESS_TOKEN=syt_cHJvZmNsYXc_...
MATRIX_USER_ID=@profclaw:matrix.org
# Optional: restrict to specific rooms
MATRIX_ALLOWED_ROOM_IDS=!roomid1:matrix.org,!roomid2:matrix.org

MATRIX_HOMESERVER_URL=https://matrix.yourdomain.com
MATRIX_ACCESS_TOKEN=syt_...
MATRIX_USER_ID=@profclaw:yourdomain.com

chat:
  matrix:
    homeserver_url: "${MATRIX_HOMESERVER_URL}"
    access_token: "${MATRIX_ACCESS_TOKEN}"
    user_id: "${MATRIX_USER_ID}"
    enable_encryption: false

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.

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

​Capabilities

​Setup

​Environment Variables

​Configuration Example

​Notes

​Related

Capabilities

Setup

Environment Variables

Configuration Example

Notes

Related