OmeniaClaw channels

Verwalten Sie Chat-Kanal-Konten und ihren Laufzeitstatus auf dem Gateway.

Zugehörige Dokumentation:

• Kanal-Guides: Kanäle
• Gateway-Konfiguration: Konfiguration

Häufige Befehle

OmeniaClaw channels listOmeniaClaw channels list --allOmeniaClaw channels statusOmeniaClaw channels capabilitiesOmeniaClaw channels capabilities --channel discord --target channel:123OmeniaClaw channels capabilities --channel discord --target channel:<voice-channel-id>OmeniaClaw channels resolve --channel slack "#general" "@jane"OmeniaClaw channels logs --channel all

channels list zeigt nur Chat-Kanäle an: standardmäßig konfigurierte Konten, mit den Status-Tags installed, configured und enabled pro Konto. Übergeben Sie --all, um auch gebündelte Kanäle anzuzeigen, die noch kein konfiguriertes Konto haben, sowie installierbare Katalogkanäle, die noch nicht auf der Festplatte vorhanden sind. Auth-Provider (OAuth + API-Schlüssel) und Nutzungs-/Kontingent-Snapshots von Modell-Providern werden hier nicht mehr ausgegeben; verwenden Sie OmeniaClaw models auth list für Provider-Auth-Profile und OmeniaClaw status oder OmeniaClaw models list für die Nutzung.

Status / Fähigkeiten / Auflösen / Logs

• channels status: --channel <name>, --probe, --timeout <ms>, --json
• channels capabilities: --channel <name>, --account <id> (nur mit --channel), --target <dest>, --timeout <ms>, --json
• channels resolve: <entries...>, --channel <name>, --account <id>, --kind <auto|user|group>, --json
• channels logs: --channel <name|all>, --lines <n>, --json

channels status --probe ist der Live-Pfad: Bei einem erreichbaren Gateway führt er pro Konto probeAccount und optionale auditAccount-Prüfungen aus, sodass die Ausgabe den Transportstatus plus Prüfergebnisse wie works, probe failed, audit ok oder audit failed enthalten kann. Wenn das Gateway nicht erreichbar ist, fällt channels status auf reine Konfigurationszusammenfassungen statt Live-Prüfausgabe zurück.

Verwenden Sie OmeniaClaw sessions, Gateway sessions.list oder das Agent-Tool sessions_list nicht als Signal für den Socket-Zustand eines Kanals. Diese Oberflächen melden gespeicherte Konversationszeilen, nicht den Laufzeitstatus des Providers. Nach einem Neustart des Discord-Providers kann ein verbundenes, aber inaktives Konto fehlerfrei sein, während bis zum nächsten eingehenden oder ausgehenden Konversationsereignis keine Discord-Sitzungszeile erscheint.

Konten hinzufügen / entfernen

OmeniaClaw channels add --channel telegram --token <bot-token>OmeniaClaw channels add --channel nostr --private-key "$NOSTR_PRIVATE_KEY"OmeniaClaw channels remove --channel telegram --delete

channels remove funktioniert nur mit installierten/konfigurierten Kanal-Plugins. Verwenden Sie für installierbare Katalogkanäle zuerst channels add. Bei laufzeitgestützten Kanal-Plugins fordert channels remove außerdem das laufende Gateway auf, das ausgewählte Konto zu stoppen, bevor die Konfiguration aktualisiert wird. So bleibt beim Deaktivieren oder Löschen eines Kontos der alte Listener nicht bis zum Neustart aktiv.

Häufige nicht interaktive Hinzufüge-Oberflächen sind:

• Bot-Token-Kanäle: --token, --bot-token, --app-token, --token-file
• Signal-/iMessage-Transportfelder: --signal-number, --cli-path, --http-url, --http-host, --http-port, --db-path, --service, --region
• Google Chat-Felder: --webhook-path, --webhook-url, --audience-type, --audience
• Matrix-Felder: --homeserver, --user-id, --access-token, --password, --device-name, --initial-sync-limit
• Nostr-Felder: --private-key, --relay-urls
• Tlon-Felder: --ship, --url, --code, --group-channels, --dm-allowlist, --auto-discover-channels
• --use-env für env-gestützte Authentifizierung des Standardkontos, sofern unterstützt

Wenn ein Kanal-Plugin während eines flaggesteuerten Hinzufüge-Befehls installiert werden muss, verwendet OmeniaClaw die Standard-Installationsquelle des Kanals, ohne den interaktiven Plugin-Installationsprompt zu öffnen.

Wenn Sie OmeniaClaw channels add ohne Flags ausführen, kann der interaktive Assistent Folgendes abfragen:

• Konto-IDs pro ausgewähltem Kanal
• optionale Anzeigenamen für diese Konten
• Route these channel accounts to agents now?

Wenn Sie die sofortige Bindung bestätigen, fragt der Assistent, welcher Agent jedes konfigurierte Kanal-Konto besitzen soll, und schreibt kontobezogene Routing-Bindungen.

Sie können dieselben Routing-Regeln später auch mit OmeniaClaw agents bindings, OmeniaClaw agents bind und OmeniaClaw agents unbind verwalten (siehe Agents).

Wenn Sie einem Kanal, der noch kontenübergreifende Top-Level-Einstellungen für ein Einzelkonto verwendet, ein nicht standardmäßiges Konto hinzufügen, übernimmt OmeniaClaw kontobezogene Top-Level-Werte in die Konto-Map des Kanals, bevor das neue Konto geschrieben wird. Die meisten Kanäle legen diese Werte in channels.<channel>.accounts.default ab, aber gebündelte Kanäle können stattdessen ein vorhandenes passendes hochgestuftes Konto beibehalten. Matrix ist das aktuelle Beispiel: Wenn bereits ein benanntes Konto existiert oder defaultAccount auf ein vorhandenes benanntes Konto verweist, behält die Hochstufung dieses Konto bei, statt ein neues accounts.default zu erstellen.

Das Routing-Verhalten bleibt konsistent:

• Vorhandene nur kanalbezogene Bindungen (ohne accountId) stimmen weiterhin mit dem Standardkonto überein.
• channels add erstellt oder überschreibt im nicht interaktiven Modus keine Bindungen automatisch.
• Die interaktive Einrichtung kann optional kontobezogene Bindungen hinzufügen.

Wenn Ihre Konfiguration bereits in einem gemischten Zustand war (benannte Konten vorhanden und Top-Level-Werte für ein Einzelkonto weiterhin gesetzt), führen Sie OmeniaClaw doctor --fix aus, um kontobezogene Werte in das hochgestufte Konto zu verschieben, das für diesen Kanal ausgewählt wurde. Die meisten Kanäle stufen in accounts.default hoch; Matrix kann stattdessen ein vorhandenes benanntes/standardmäßiges Ziel beibehalten.

Anmelden und Abmelden (interaktiv)

OmeniaClaw channels login --channel whatsappOmeniaClaw channels logout --channel whatsapp

• channels login unterstützt --verbose.
• channels login und logout können den Kanal ableiten, wenn nur ein unterstütztes Login-Ziel konfiguriert ist.
• channels logout bevorzugt den Live-Gateway-Pfad, wenn er erreichbar ist, sodass die Abmeldung jeden aktiven Listener stoppt, bevor der Auth-Status des Kanals gelöscht wird. Wenn kein lokales Gateway erreichbar ist, fällt der Befehl auf die lokale Auth-Bereinigung zurück.
• Führen Sie channels login in einem Terminal auf dem Gateway-Host aus. Agent exec blockiert diesen interaktiven Login-Ablauf; kanalnative Agent-Login-Tools wie whatsapp_login sollten aus dem Chat verwendet werden, wenn sie verfügbar sind.

Fehlerbehebung

• Führen Sie OmeniaClaw status --deep für eine breite Prüfung aus.
• Verwenden Sie OmeniaClaw doctor für geführte Korrekturen.
• OmeniaClaw channels list gibt keine Nutzungs-/Kontingent-Snapshots von Modell-Providern mehr aus. Verwenden Sie dafür OmeniaClaw status (Übersicht) oder OmeniaClaw models list (pro Provider).
• OmeniaClaw channels status fällt auf reine Konfigurationszusammenfassungen zurück, wenn das Gateway nicht erreichbar ist. Wenn ein unterstützter Kanal-Berechtigungsnachweis über SecretRef konfiguriert ist, aber im aktuellen Befehlspfad nicht verfügbar ist, wird dieses Konto mit herabgestuften Hinweisen als konfiguriert gemeldet, statt als nicht konfiguriert angezeigt zu werden.

Fähigkeiten prüfen

Rufen Sie Provider-Fähigkeitshinweise (Intents/Scopes, sofern verfügbar) plus statische Feature-Unterstützung ab:

OmeniaClaw channels capabilitiesOmeniaClaw channels capabilities --channel discord --target channel:123

Hinweise:

• --channel ist optional; lassen Sie es weg, um jeden Kanal aufzulisten (einschließlich Erweiterungen).
• --account ist nur mit --channel gültig.
• --target akzeptiert channel:<id> oder eine reine numerische Kanal-ID und gilt nur für Discord. Bei Discord-Sprachkanälen markiert die Berechtigungsprüfung fehlende ViewChannel, Connect, Speak, SendMessages und ReadMessageHistory.
• Prüfungen sind Provider-spezifisch: Discord-Intents + optionale Kanalberechtigungen; Slack-Bot- + Benutzer-Scopes; Telegram-Bot-Flags + Webhook; Signal-Daemon-Version; Microsoft Teams-App-Token + Graph-Rollen/Scopes (annotiert, wo bekannt). Kanäle ohne Prüfungen melden Probe: unavailable.

Namen zu IDs auflösen

Lösen Sie Kanal-/Benutzernamen über das Provider-Verzeichnis zu IDs auf:

OmeniaClaw channels resolve --channel slack "#general" "@jane"OmeniaClaw channels resolve --channel discord "My Server/#support" "@someone"OmeniaClaw channels resolve --channel matrix "Project Room"

Hinweise:

• Verwenden Sie --kind user|group|auto, um den Zieltyp zu erzwingen.
• Die Auflösung bevorzugt aktive Treffer, wenn mehrere Einträge denselben Namen haben.
• channels resolve ist schreibgeschützt. Wenn ein ausgewähltes Konto über SecretRef konfiguriert ist, dieser Berechtigungsnachweis im aktuellen Befehlspfad jedoch nicht verfügbar ist, gibt der Befehl herabgestufte nicht aufgelöste Ergebnisse mit Hinweisen zurück, statt den gesamten Lauf abzubrechen.
• channels resolve installiert keine Kanal-Plugins. Verwenden Sie channels add --channel <name>, bevor Sie Namen für einen installierbaren Katalogkanal auflösen.

Verwandte Themen

• CLI-Referenz
• Kanalübersicht