Developer and self-hosted

Nextcloud Talk

Nextcloud Talk ist ein herunterladbares Kanal-Plugin (@openclaw/nextcloud-talk), das OpenClaw über einen Talk-Webhook-Bot mit einer selbst gehosteten Nextcloud-Instanz verbindet. Direktnachrichten, Räume, Reaktionen und Markdown-Nachrichten werden unterstützt; Medien werden als URLs versendet.

Installation

bash

openclaw plugins install @openclaw/nextcloud-talk

Verwenden Sie die reine Paketangabe, um dem aktuellen offiziellen Release-Tag zu folgen. Legen Sie nur dann eine exakte Version fest, wenn Sie eine reproduzierbare Installation benötigen.

Aus einem lokalen Checkout (Entwicklungsabläufe):

bash

openclaw plugins install ./path/to/local/nextcloud-talk-plugin

Starten Sie den Gateway nach der Installation neu. Details: Plugins

Schnelleinrichtung (Einsteiger)

Installieren Sie das Plugin (siehe oben).
Erstellen Sie auf Ihrem Nextcloud-Server einen Bot:
bash
```
./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature webhook --feature response --feature reaction
```
Behalten Sie --feature response bei: Ohne diese Option schlagen ausgehende Antworten mit 401 fehl. Reparieren Sie einen vorhandenen Bot mit ./occ talk:bot:state --feature webhook --feature response --feature reaction <botId> 1.
Aktivieren Sie den Bot in den Einstellungen des Zielraums.
Konfigurieren Sie OpenClaw:
- Konfiguration: channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
- Oder Umgebungsvariable: NEXTCLOUD_TALK_BOT_SECRET (nur für das Standardkonto)
CLI-Einrichtung (--url/--token sind Aliasse für die expliziten Felder; nc-talk und nc funktionieren als Kanal-Aliasse):
bash
```
openclaw channels add --channel nextcloud-talk \  --url https://cloud.example.com \  --token "<shared-secret>"
```
Entsprechende explizite Felder:
bash
```
openclaw channels add --channel nextcloud-talk \  --base-url https://cloud.example.com \  --secret "<shared-secret>"
```
Dateibasierter geheimer Wert:
bash
```
openclaw channels add --channel nextcloud-talk \  --base-url https://cloud.example.com \  --secret-file /path/to/nextcloud-talk-secret
```
Starten Sie den Gateway neu (oder schließen Sie die Einrichtung ab).

Minimale Konfiguration:

json5

{  channels: {    "nextcloud-talk": {      enabled: true,      baseUrl: "https://cloud.example.com",      botSecret: "shared-secret",      dmPolicy: "pairing",    },  },}

Hinweise

Bots können keine Direktnachrichten initiieren. Der Benutzer muss dem Bot zuerst eine Nachricht senden.
Die Webhook-URL muss vom Nextcloud-Server erreichbar sein; legen Sie webhookPublicUrl fest, wenn sich der Gateway hinter einem Proxy befindet. Webhook-Anfragen werden mit dem geheimen Bot-Wert per HMAC-SHA256 signiert; ungültige Signaturen werden abgelehnt und einer Ratenbegrenzung unterzogen.
Medien-Uploads werden von der Bot-API nicht unterstützt; ausgehende Medien werden als Zeile Attachment: <url> angehängt.
Die Webhook-Nutzlast unterscheidet nicht zwischen Direktnachrichten und Räumen; legen Sie apiUser + apiPassword fest, um Abfragen des Raumtyps zu aktivieren (etwa 5 Minuten zwischengespeichert). Ohne diese Angaben wird jede Unterhaltung als Raum behandelt.
Ausgehende Anfragen durchlaufen den SSRF-Schutz. Für einen Nextcloud-Host in einem vertrauenswürdigen privaten/internen Netzwerk aktivieren Sie dies mit channels.nextcloud-talk.network.dangerouslyAllowPrivateNetwork: true.
Wenn apiUser/apiPassword und webhookPublicUrl festgelegt sind, prüft openclaw channels status den Bot und warnt, wenn die Funktion response fehlt.

Zugriffskontrolle (Direktnachrichten)

Standard: channels.nextcloud-talk.dmPolicy = "pairing". Unbekannte Absender erhalten einen Kopplungscode.
Genehmigen Sie über:
- openclaw pairing list nextcloud-talk
- openclaw pairing approve nextcloud-talk <CODE>
Öffentliche Direktnachrichten: channels.nextcloud-talk.dmPolicy="open" zusammen mit channels.nextcloud-talk.allowFrom=["*"].
allowFrom gleicht nur Nextcloud-Benutzer-IDs ab (in Kleinbuchstaben); Anzeigenamen werden ignoriert.

Räume (Gruppen)

Standard: channels.nextcloud-talk.groupPolicy = "allowlist" (Erwähnung erforderlich).
Nehmen Sie Räume mit channels.nextcloud-talk.rooms in die Zulassungsliste auf, indiziert nach Raum-Token; "*" legt einen Platzhalterstandard fest:

json5

{  channels: {    "nextcloud-talk": {      rooms: {        "room-token": { requireMention: true },      },    },  },}

Schlüssel pro Raum: requireMention (standardmäßig true), enabled (false deaktiviert den Raum), allowFrom (Absender-Zulassungsliste pro Raum), tools (werkzeugspezifische Zulassungs-/Ablehnungsüberschreibungen), skills (begrenzt geladene Skills), systemPrompt.
Um keine Räume zuzulassen, lassen Sie die Zulassungsliste leer oder legen Sie channels.nextcloud-talk.groupPolicy="disabled" fest.

Funktionen

Funktion	Status
Direktnachrichten	Unterstützt
Räume	Unterstützt
Threads	Nicht unterstützt
Medien	Nur URLs
Reaktionen	Unterstützt
Native Befehle	Nicht unterstützt

Konfigurationsreferenz (Nextcloud Talk)

Vollständige Konfiguration: Konfiguration

Provider-Optionen:

channels.nextcloud-talk.enabled: Aktiviert/deaktiviert den Kanalstart.
channels.nextcloud-talk.baseUrl: URL der Nextcloud-Instanz.
channels.nextcloud-talk.botSecret: Gemeinsamer geheimer Bot-Wert (Zeichenfolge oder Geheimnisreferenz).
channels.nextcloud-talk.botSecretFile: Pfad zu einer regulären Datei mit dem geheimen Wert. Symbolische Verknüpfungen werden abgelehnt.
channels.nextcloud-talk.apiUser: API-Benutzer für Raumabfragen (Erkennung von Direktnachrichten) und die Statusprüfung.
channels.nextcloud-talk.apiPassword: API-/App-Passwort für Raumabfragen.
channels.nextcloud-talk.apiPasswordFile: Dateipfad für das API-Passwort.
channels.nextcloud-talk.webhookPort: Port des Webhook-Listeners (Standard: 8788).
channels.nextcloud-talk.webhookHost: Webhook-Host (Standard: 0.0.0.0).
channels.nextcloud-talk.webhookPath: Webhook-Pfad (Standard: /nextcloud-talk-webhook).
channels.nextcloud-talk.webhookPublicUrl: Extern erreichbare Webhook-URL.
channels.nextcloud-talk.dmPolicy: pairing | allowlist | open | disabled (Standard: pairing). open erfordert allowFrom=["*"].
channels.nextcloud-talk.allowFrom: Zulassungsliste für Direktnachrichten (Benutzer-IDs).
channels.nextcloud-talk.groupPolicy: allowlist | open | disabled (Standard: allowlist).
channels.nextcloud-talk.groupAllowFrom: Absender-Zulassungsliste für Räume (Benutzer-IDs); verwendet allowFrom, wenn nicht festgelegt.
channels.nextcloud-talk.rooms: Einstellungen und Zulassungsliste pro Raum (siehe oben).
Statische Absender-Zugriffsgruppen können aus allowFrom und groupAllowFrom mit accessGroup:<name> referenziert werden.
channels.nextcloud-talk.historyLimit: Verlaufslimit für Gruppen (0 deaktiviert es).
channels.nextcloud-talk.dmHistoryLimit: Verlaufslimit für Direktnachrichten (0 deaktiviert es).
channels.nextcloud-talk.dms: Überschreibungen pro Direktnachricht, indiziert nach Benutzer-ID (historyLimit).
channels.nextcloud-talk.textChunkLimit: Größe ausgehender Textabschnitte in Zeichen (Standard: 4000).
channels.nextcloud-talk.chunkMode: length (Standard) oder newline, um vor der längenbasierten Aufteilung an Leerzeilen (Absatzgrenzen) zu teilen.
channels.nextcloud-talk.blockStreaming: Deaktiviert Block-Streaming für diesen Kanal.
channels.nextcloud-talk.blockStreamingCoalesce: Feinabstimmung der Zusammenführung beim Block-Streaming.
channels.nextcloud-talk.responsePrefix: Präfix für ausgehende Antworten.
channels.nextcloud-talk.markdown.tables: Darstellungsmodus für Markdown-Tabellen (off | bullets | code | block).
channels.nextcloud-talk.mediaMaxMb: Obergrenze für eingehende Medien (MB).
channels.nextcloud-talk.network.dangerouslyAllowPrivateNetwork: Erlaubt privaten/internen Nextcloud-Hosts, den SSRF-Schutz zu passieren.
channels.nextcloud-talk.accounts.<id>: Kontospezifische Überschreibungen (dieselben Schlüssel); defaultAccount wählt das Standardkonto aus. Die Umgebungsvariablen NEXTCLOUD_TALK_BOT_SECRET / NEXTCLOUD_TALK_API_PASSWORD gelten nur für das Standardkonto.