Skip to content
Diese Seite wurde mit KI-Unterstützung erstellt und übersetzt. Falls Ihnen Ungenauigkeiten auffallen, helfen Sie gerne bei der Verbesserung. Auf GitHub bearbeiten

prx channel

Verwalten Sie die Messaging-Kanäle, mit denen sich PRX verbindet. Kanäle sind die Brücken zwischen Messaging-Plattformen (Telegram, Discord, Slack usw.) und der PRX-Agent-Laufzeit.

Verwendung

bash
prx channel <UNTERBEFEHL> [OPTIONS]

Unterbefehle

prx channel list

Alle konfigurierten Kanäle und deren aktuellen Status auflisten.

bash
prx channel list [OPTIONS]
FlagKurzStandardBeschreibung
--json-jfalseAusgabe als JSON
--verbose-vfalseDetaillierte Verbindungsinformationen anzeigen

Beispielausgabe:

 Name         Type       Status      Uptime
 telegram-main  telegram   connected   3d 14h
 discord-dev    discord    connected   3d 14h
 slack-team     slack      error       --
 cli            cli        stopped     --

prx channel add

Neue Kanalkonfiguration interaktiv oder über Flags hinzufügen.

bash
prx channel add [OPTIONS]
FlagKurzStandardBeschreibung
--type-tKanaltyp (z.B. telegram, discord, slack)
--name-nautomatisch generiertAnzeigename für den Kanal
--tokenBot-Token oder API-Schlüssel
--enabledtrueKanal sofort aktivieren
--interactive-itrueInteraktiven Assistenten verwenden
bash
# Interaktiver Modus (geführte Eingabeaufforderungen)
prx channel add

# Nicht-interaktiv mit Flags
prx channel add --type telegram --name my-bot --token "123456:ABC-DEF"

prx channel remove

Kanalkonfiguration entfernen.

bash
prx channel remove <NAME> [OPTIONS]
FlagKurzStandardBeschreibung
--force-ffalseBestätigungsaufforderung überspringen
bash
prx channel remove slack-team
prx channel remove slack-team --force

prx channel start

Einen bestimmten Kanal starten (oder neu starten), ohne den Daemon neu zu starten.

bash
prx channel start <NAME>
bash
# Einen fehlerhaften Kanal neu starten
prx channel start slack-team

Dieser Befehl sendet eine Steuernachricht an den laufenden Daemon. Der Daemon muss laufen, damit dieser Befehl funktioniert.

prx channel doctor

Diagnose der Kanalverbindungen ausführen. Prüft Token-Gültigkeit, Netzwerkverbindung, Webhook-URLs und Berechtigungen.

bash
prx channel doctor [NAME]

Wird NAME weggelassen, werden alle Kanäle geprüft.

bash
# Alle Kanäle prüfen
prx channel doctor

# Bestimmten Kanal prüfen
prx channel doctor telegram-main

Beispielausgabe:

 telegram-main
   Token valid ...................... OK
   API reachable ................... OK
   Webhook URL configured ......... OK
   Bot permissions ................. OK (read, send, edit, delete)

 slack-team
   Token valid ...................... OK
   API reachable ................... FAIL (timeout after 5s)
   Suggestion: Check network connectivity or Slack API status

Beispiele

bash
# Vollständiger Workflow: hinzufügen, überprüfen, starten
prx channel add --type discord --name dev-server --token "MTIz..."
prx channel doctor dev-server
prx channel start dev-server

# Kanäle als JSON für Skripte auflisten
prx channel list --json | jq '.[] | select(.status == "error")'

Verwandte Themen

  • Kanalübersicht -- ausführliche Kanaldokumentation
  • prx daemon -- der Daemon, der Kanalverbindungen ausführt
  • prx doctor -- vollständige Systemdiagnose einschließlich Kanälen

Released under the Apache-2.0 License.