Channels: Matrix

Matrix is a Tier 2 channel. Wayland connects as a Matrix user on a homeserver you choose, using an access token rather than a password.

Before you start (prerequisites and accounts)

• A Matrix account on a homeserver (for example matrix.org or a self-hosted server).
• The Wayland desktop app running with a model provider connected.

Create the credentials (on the provider side)

1. Note your homeserver URL, for example https://matrix.org.
2. Note your full user ID, for example @bot:matrix.org.
3. Obtain an access token for that account. Most clients expose it in their advanced or developer settings, or you can request one from the homeserver login API.

Connect it in Wayland (Settings -> Channels -> Matrix)

1. Open Settings -> Channels and choose Matrix.
2. Enter the Homeserver URL.
3. Enter the User ID.
4. Paste the Access token.
5. Save.

Verify (status goes from idle to connected, send a test message)

After saving, the status moves from idle to connected. Invite the account to a room or message it directly, then confirm a reply.

Route to an assistant or team

Set the assistant and default model on the Matrix page. Inbound Matrix messages route to that assistant.

Troubleshooting

An expired or revoked access token is the usual cause of failures. Reissue the token and confirm the homeserver URL. See Channel Connection Issues.

Next

• Channels
• Create a Custom Assistant
• FAQ and Troubleshooting