Was macht matrix-skill?
Agentische Fähigkeit für die Matrix-Chat-Kommunikation. Senden Sie Nachrichten im Namen von Benutzern in Matrix-Räume mittels Access-Token-Authentifizierung. Funktioniert mit jedem Matrix-Homeserver.
Installation
- Stellen Sie sicher, dass Sie Zugriff auf einen Matrix-Homeserver haben (z. B. matrix.org, Self-Hosted).
- Generieren Sie ein Zugriffstoken für Ihren Matrix-Benutzer:
- Melden Sie sich bei Ihrer Matrix-Client-App an (z. B. Element).
- Gehen Sie zu den Einstellungen > Hilfe & Info > Zugriffstoken.
- Setzen Sie die Umgebungsvariable
MATRIX_ACCESS_TOKENauf Ihr Token. - (Optional) Setzen Sie
MATRIX_HOMESERVER_URL, wenn Ihr Homeserver nicht der Standard ist (standardmäßig:https://matrix-client.matrix.org).
Verwendung
Senden einer Nachricht an einen Matrix-Raum
Um eine Nachricht an einen bestimmten Raum zu senden:
from matrix_skill import send_message
# Senden Sie eine Nachricht an einen Raum mithilfe seiner ID oder seines Alias
send_message(
room_id="!yourroomid:matrix.org",
message="Hallo von meinem KI-Agenten!"
)
Authentifizierung
Die Fähigkeit authentifiziert sich mit dem Zugriffstoken, das in der Umgebungsvariablen MATRIX_ACCESS_TOKEN bereitgestellt wird. Wenn kein Homeserver angegeben ist, wird standardmäßig https://matrix-client.matrix.org verwendet.
Unterstützte Plattformen
- Jeder Matrix-Homeserver
- Claude Code
- Cursor
- Codex
Konfiguration
| Umgebungsvariable | Beschreibung | Standardwert |
|---|---|---|
MATRIX_ACCESS_TOKEN | Zugriffstoken für Matrix-Authentifizierung | (erforderlich) |
MATRIX_HOMESERVER_URL | Basis-URL des Matrix-Homeservers | https://matrix-client.matrix.org |
Beispiele
Beispiel 1: Senden einer Begrüßungsnachricht an einen Raum
from matrix_skill import send_message
send_message(
room_id="#mein-team:matrix.org",
message="Hallo Team! Der KI-Agent ist jetzt online."
)
Beispiel 2: Senden einer Warnung
from matrix_skill import send_message
warnung = "Achtung: Hohe CPU-Auslastung erkannt auf Server-42."
send_message(
room_id="!warnungen:matrix.org",
message=warnung
)
Fehlerbehandlung
Wenn ein Fehler auftritt (z. B. ungültiges Token, Raum nicht gefunden), gibt die Fähigkeit einen klaren Fehler zurück. Überprüfen Sie Ihre Umgebungsvariablen und Raum-ID.
Lizenz
Dieses Projekt ist unter der MIT-Lizenz lizenziert.