Nextcloud Talk

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Gebündeltes Plugin

openclaw plugins install @openclaw/nextcloud-talk

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

​

Schnelle Einrichtung (Anfänger)

1. Stellen Sie sicher, dass das Nextcloud Talk-Plugin verfügbar ist.
   • Aktuelle paketierte OpenClaw-Releases bündeln es bereits.
   • Ältere/benutzerdefinierte Installationen können es mit den obigen Befehlen manuell hinzufügen.
2. Erstellen Sie auf Ihrem Nextcloud-Server einen Bot:
   ./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature webhook --feature response --feature reaction
   
3. Aktivieren Sie den Bot in den Einstellungen des Zielraums.
4. Konfigurieren Sie OpenClaw:
   • Konfiguration: channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
   • Oder Umgebung: NEXTCLOUD_TALK_BOT_SECRET (nur Standardkonto)
   CLI-Einrichtung:
   openclaw channels add --channel nextcloud-talk \
     --url https://cloud.example.com \
     --token "<shared-secret>"
   
   Entsprechende explizite Felder:
   openclaw channels add --channel nextcloud-talk \
     --base-url https://cloud.example.com \
     --secret "<shared-secret>"
   
   Dateigestütztes Geheimnis:
   openclaw channels add --channel nextcloud-talk \
     --base-url https://cloud.example.com \
     --secret-file /path/to/nextcloud-talk-secret
   
5. Starten Sie den Gateway neu (oder schließen Sie die Einrichtung ab).

{
  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 für den Gateway erreichbar sein; setzen Sie webhookPublicUrl, wenn sie hinter einem Proxy liegt.
• Medien-Uploads werden von der Bot-API nicht unterstützt; Medien werden als URLs gesendet.
• Die Webhook-Nutzlast unterscheidet nicht zwischen Direktnachrichten und Räumen; setzen Sie apiUser + apiPassword, um Raumtyp-Abfragen zu aktivieren (andernfalls werden Direktnachrichten als Räume behandelt).

​

Zugriffskontrolle (Direktnachrichten)

• Standard: channels.nextcloud-talk.dmPolicy = "pairing". Unbekannte Absender erhalten einen Pairing-Code.
• Genehmigen über:
  • openclaw pairing list nextcloud-talk
  • openclaw pairing approve nextcloud-talk <CODE>
• Öffentliche Direktnachrichten: channels.nextcloud-talk.dmPolicy="open" plus channels.nextcloud-talk.allowFrom=["*"].
• allowFrom gleicht nur Nextcloud-Benutzer-IDs ab; Anzeigenamen werden ignoriert.

​

Räume (Gruppen)

• Standard: channels.nextcloud-talk.groupPolicy = "allowlist" (durch Erwähnungen gesteuert).
• Räume mit channels.nextcloud-talk.rooms in die Zulassungsliste aufnehmen:

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

• Um keine Räume zuzulassen, lassen Sie die Zulassungsliste leer oder setzen Sie channels.nextcloud-talk.groupPolicy="disabled".

​

Fähigkeiten

​

Konfigurationsreferenz (Nextcloud Talk)

• channels.nextcloud-talk.enabled: Aktivieren/Deaktivieren des Kanalstarts.
• channels.nextcloud-talk.baseUrl: URL der Nextcloud-Instanz.
• channels.nextcloud-talk.botSecret: gemeinsames Geheimnis des Bots.
• channels.nextcloud-talk.botSecretFile: Pfad zu einer regulären Datei mit dem Geheimnis. Symlinks werden abgelehnt.
• channels.nextcloud-talk.apiUser: API-Benutzer für Raumabfragen (Direktnachrichtenerkennung).
• channels.nextcloud-talk.apiPassword: API-/App-Passwort für Raumabfragen.
• channels.nextcloud-talk.apiPasswordFile: Pfad zur API-Passwortdatei.
• 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.
• channels.nextcloud-talk.allowFrom: Zulassungsliste für Direktnachrichten (Benutzer-IDs). open erfordert "*".
• channels.nextcloud-talk.groupPolicy: allowlist | open | disabled.
• channels.nextcloud-talk.groupAllowFrom: Zulassungsliste für Gruppen (Benutzer-IDs).
• channels.nextcloud-talk.rooms: Einstellungen und Zulassungsliste pro Raum.
• Statische Absender-Zugriffsgruppen können aus allowFrom und groupAllowFrom mit accessGroup:<name> referenziert werden.
• channels.nextcloud-talk.historyLimit: Verlaufsgrenze für Gruppen (0 deaktiviert).
• channels.nextcloud-talk.dmHistoryLimit: Verlaufsgrenze für Direktnachrichten (0 deaktiviert).
• channels.nextcloud-talk.dms: Überschreibungen pro Direktnachricht (historyLimit).
• channels.nextcloud-talk.textChunkLimit: Größe ausgehender Textabschnitte (Zeichen).
• channels.nextcloud-talk.chunkMode: length (Standard) oder newline, um vor dem Aufteilen nach Länge an Leerzeilen (Absatzgrenzen) zu teilen.
• channels.nextcloud-talk.blockStreaming: Block-Streaming für diesen Kanal deaktivieren.
• channels.nextcloud-talk.blockStreamingCoalesce: Abstimmung der Block-Streaming-Zusammenführung.
• channels.nextcloud-talk.mediaMaxMb: Grenze für eingehende Medien (MB).

​

Verwandte Themen

• Kanalübersicht — alle unterstützten Kanäle
• Pairing — Authentifizierung für Direktnachrichten und Pairing-Ablauf
• Gruppen — Gruppenchat-Verhalten und Erwähnungssteuerung
• Kanal-Routing — Sitzungs-Routing für Nachrichten
• Sicherheit — Zugriffsmodell und Härtung