Nextcloud Talk

Status: gebundelde Plugin (Webhook-bot). Direct messages, ruimtes, reacties en markdown-berichten worden ondersteund.

Gebundelde Plugin

Nextcloud Talk wordt als gebundelde Plugin meegeleverd in huidige OpenClaw-releases, dus normale pakketbuilds hebben geen aparte installatie nodig.

Als je een oudere build gebruikt of een aangepaste installatie die Nextcloud Talk uitsluit, installeer dan het npm-pakket rechtstreeks:

Installeren via CLI (npm-register):

openclaw plugins install @openclaw/nextcloud-talk

Gebruik het kale pakket om de huidige officiële releasetag te volgen. Pin alleen een exacte versie wanneer je een reproduceerbare installatie nodig hebt.

Lokale checkout (bij uitvoeren vanuit een git-repo):

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

Details: Plugins

Snelle setup (beginner)

1. Zorg dat de Nextcloud Talk-Plugin beschikbaar is.

   • Huidige verpakte OpenClaw-releases bundelen deze al.
   • Oudere/aangepaste installaties kunnen deze handmatig toevoegen met de bovenstaande commando's.

2. Maak op je Nextcloud-server een bot aan:

   ./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature webhook --feature response --feature reaction

3. Schakel de bot in de instellingen van de doelruimte in.

4. Configureer OpenClaw:

   • Configuratie: channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
   • Of env: NEXTCLOUD_TALK_BOT_SECRET (alleen standaardaccount)

   CLI-setup:

   openclaw channels add --channel nextcloud-talk \  --url https://cloud.example.com \  --token "<shared-secret>"

   Equivalente expliciete velden:

   openclaw channels add --channel nextcloud-talk \  --base-url https://cloud.example.com \  --secret "<shared-secret>"

   Bestandsgesteund geheim:

   openclaw channels add --channel nextcloud-talk \  --base-url https://cloud.example.com \  --secret-file /path/to/nextcloud-talk-secret

5. Herstart de Gateway (of rond de setup af).

Minimale configuratie:

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

Opmerkingen

• Bots kunnen geen DM's initiëren. De gebruiker moet eerst een bericht naar de bot sturen.
• De Webhook-URL moet bereikbaar zijn voor de Gateway; stel webhookPublicUrl in als deze zich achter een proxy bevindt.
• Media-uploads worden niet ondersteund door de bot-API; media wordt als URL's verzonden.
• De Webhook-payload maakt geen onderscheid tussen DM's en ruimtes; stel apiUser + apiPassword in om opzoekacties voor ruimtetypes in te schakelen (anders worden DM's als ruimtes behandeld).

Toegangsbeheer (DM's)

• Standaard: channels.nextcloud-talk.dmPolicy = "pairing". Onbekende afzenders krijgen een koppelingscode.
• Goedkeuren via:
  • openclaw pairing list nextcloud-talk
  • openclaw pairing approve nextcloud-talk <CODE>
• Openbare DM's: channels.nextcloud-talk.dmPolicy="open" plus channels.nextcloud-talk.allowFrom=["*"].
• allowFrom matcht alleen Nextcloud-gebruikers-ID's; weergavenamen worden genegeerd.

Ruimtes (groepen)

• Standaard: channels.nextcloud-talk.groupPolicy = "allowlist" (vermelding vereist).
• Zet ruimtes op de allowlist met channels.nextcloud-talk.rooms:

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

• Om geen ruimtes toe te staan, laat je de allowlist leeg of stel je channels.nextcloud-talk.groupPolicy="disabled" in.

Mogelijkheden

Configuratiereferentie (Nextcloud Talk)

Volledige configuratie: Configuratie

Provideropties:

• channels.nextcloud-talk.enabled: inschakelen/uitschakelen van kanaalopstart.
• channels.nextcloud-talk.baseUrl: URL van de Nextcloud-instantie.
• channels.nextcloud-talk.botSecret: gedeeld botgeheim.
• channels.nextcloud-talk.botSecretFile: geheim pad naar regulier bestand. Symlinks worden geweigerd.
• channels.nextcloud-talk.apiUser: API-gebruiker voor opzoekacties van ruimtes (DM-detectie).
• channels.nextcloud-talk.apiPassword: API-/app-wachtwoord voor opzoekacties van ruimtes.
• channels.nextcloud-talk.apiPasswordFile: bestandspad voor API-wachtwoord.
• channels.nextcloud-talk.webhookPort: listenerpoort voor Webhooks (standaard: 8788).
• channels.nextcloud-talk.webhookHost: Webhook-host (standaard: 0.0.0.0).
• channels.nextcloud-talk.webhookPath: Webhook-pad (standaard: /nextcloud-talk-webhook).
• channels.nextcloud-talk.webhookPublicUrl: extern bereikbare Webhook-URL.
• channels.nextcloud-talk.dmPolicy: pairing | allowlist | open | disabled.
• channels.nextcloud-talk.allowFrom: DM-allowlist (gebruikers-ID's). open vereist "*".
• channels.nextcloud-talk.groupPolicy: allowlist | open | disabled.
• channels.nextcloud-talk.groupAllowFrom: groeps-allowlist (gebruikers-ID's).
• channels.nextcloud-talk.rooms: instellingen en allowlist per ruimte.
• Statische toegangsgroepen voor afzenders kunnen vanuit allowFrom en groupAllowFrom worden gerefereerd met accessGroup:<name>.
• channels.nextcloud-talk.historyLimit: geschiedenisluit voor groepen (0 schakelt uit).
• channels.nextcloud-talk.dmHistoryLimit: geschiedenisluit voor DM's (0 schakelt uit).
• channels.nextcloud-talk.dms: overschrijvingen per DM (historyLimit).
• channels.nextcloud-talk.textChunkLimit: chunkgrootte voor uitgaande tekst (tekens).
• channels.nextcloud-talk.chunkMode: length (standaard) of newline om te splitsen op lege regels (alineagrenzen) vóór chunking op lengte.
• channels.nextcloud-talk.blockStreaming: block-streaming uitschakelen voor dit kanaal.
• channels.nextcloud-talk.blockStreamingCoalesce: afstemming voor coalescing van block-streaming.
• channels.nextcloud-talk.mediaMaxMb: limiet voor inkomende media (MB).

Gerelateerd

• Kanalenoverzicht — alle ondersteunde kanalen
• Koppeling — DM-authenticatie en koppelingsflow
• Groepen — gedrag van groepschats en gating op vermeldingen
• Kanaalroutering — sessieroutering voor berichten
• Beveiliging — toegangsmodel en hardening