Nextcloud Talk

​

Installazione

openclaw plugins install @openclaw/nextcloud-talk

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

​

Configurazione rapida (principianti)

1. Installare il plugin (sopra).
2. Sul server Nextcloud, creare un bot:
   ./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature webhook --feature response --feature reaction
   
   Mantenere --feature response: senza questa opzione, le risposte in uscita restituiscono l’errore 401. Riparare un bot esistente con ./occ talk:bot:state --feature webhook --feature response --feature reaction <botId> 1.
3. Abilitare il bot nelle impostazioni della stanza di destinazione.
4. Configurare OpenClaw:
   • Configurazione: channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
   • Oppure variabili d’ambiente: NEXTCLOUD_TALK_BOT_SECRET (solo account predefinito)
   Configurazione tramite CLI (--url/--token sono alias dei campi espliciti; nc-talk e nc funzionano come alias del canale):
   openclaw channels add --channel nextcloud-talk \
     --url https://cloud.example.com \
     --token "<shared-secret>"
   
   Campi espliciti equivalenti:
   openclaw channels add --channel nextcloud-talk \
     --base-url https://cloud.example.com \
     --secret "<shared-secret>"
   
   Segreto memorizzato in un file:
   openclaw channels add --channel nextcloud-talk \
     --base-url https://cloud.example.com \
     --secret-file /path/to/nextcloud-talk-secret
   
5. Riavviare il Gateway (o completare la configurazione).

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

​

Note

• I bot non possono avviare messaggi diretti. L’utente deve prima inviare un messaggio al bot.
• L’URL del webhook deve essere raggiungibile dal server Nextcloud; impostare webhookPublicUrl quando il Gateway si trova dietro un proxy. Le richieste webhook sono firmate con HMAC-SHA256 usando il segreto del bot; le firme non valide vengono rifiutate e sottoposte a limitazione della frequenza.
• I caricamenti di contenuti multimediali non sono supportati dall’API del bot; i contenuti multimediali in uscita vengono aggiunti come riga Attachment: <url>.
• Il payload del webhook non distingue i messaggi diretti dalle stanze; impostare apiUser + apiPassword per abilitare le ricerche del tipo di stanza (memorizzate nella cache per circa 5 minuti). Senza questi valori, ogni conversazione viene trattata come una stanza.
• Le richieste in uscita passano attraverso la protezione SSRF. Per un host Nextcloud su una rete privata/interna attendibile, abilitarne l’accesso con channels.nextcloud-talk.network.dangerouslyAllowPrivateNetwork: true.
• Con apiUser/apiPassword e webhookPublicUrl impostati, openclaw channels status verifica il bot e avvisa quando manca la funzionalità response.

​

Controllo degli accessi (messaggi diretti)

• Valore predefinito: channels.nextcloud-talk.dmPolicy = "pairing". I mittenti sconosciuti ricevono un codice di associazione.
• Approvare tramite:
  • openclaw pairing list nextcloud-talk
  • openclaw pairing approve nextcloud-talk <CODE>
• Messaggi diretti pubblici: channels.nextcloud-talk.dmPolicy="open" più channels.nextcloud-talk.allowFrom=["*"].
• allowFrom corrisponde solo agli ID utente Nextcloud (in minuscolo); i nomi visualizzati vengono ignorati.

​

Stanze (gruppi)

• Valore predefinito: channels.nextcloud-talk.groupPolicy = "allowlist" (richiede una menzione).
• Consentire le stanze con channels.nextcloud-talk.rooms, indicizzate per token della stanza; "*" imposta un valore predefinito con carattere jolly:

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

• Chiavi per stanza: requireMention (valore predefinito true), enabled (false disabilita la stanza), allowFrom (elenco dei mittenti consentiti per la stanza), tools (sostituzioni di autorizzazione/negazione degli strumenti), skills (limita le Skills caricate), systemPrompt.
• Per non consentire alcuna stanza, mantenere vuoto l’elenco degli elementi consentiti oppure impostare channels.nextcloud-talk.groupPolicy="disabled".

​

Funzionalità

​

Riferimento per la configurazione (Nextcloud Talk)

• channels.nextcloud-talk.enabled: abilita/disabilita l’avvio del canale.
• channels.nextcloud-talk.baseUrl: URL dell’istanza Nextcloud.
• channels.nextcloud-talk.botSecret: segreto condiviso del bot (stringa o riferimento a un segreto).
• channels.nextcloud-talk.botSecretFile: percorso del segreto in un file normale. I collegamenti simbolici vengono rifiutati.
• channels.nextcloud-talk.apiUser: utente API per la ricerca delle stanze (rilevamento dei messaggi diretti) e la verifica dello stato.
• channels.nextcloud-talk.apiPassword: password API/dell’app per la ricerca delle stanze.
• channels.nextcloud-talk.apiPasswordFile: percorso del file della password API.
• channels.nextcloud-talk.webhookPort: porta del listener webhook (valore predefinito: 8788).
• channels.nextcloud-talk.webhookHost: host del webhook (valore predefinito: 0.0.0.0).
• channels.nextcloud-talk.webhookPath: percorso del webhook (valore predefinito: /nextcloud-talk-webhook).
• channels.nextcloud-talk.webhookPublicUrl: URL del webhook raggiungibile dall’esterno.
• channels.nextcloud-talk.dmPolicy: pairing | allowlist | open | disabled (valore predefinito: associazione). open richiede allowFrom=["*"].
• channels.nextcloud-talk.allowFrom: elenco dei messaggi diretti consentiti (ID utente).
• channels.nextcloud-talk.groupPolicy: allowlist | open | disabled (valore predefinito: elenco degli elementi consentiti).
• channels.nextcloud-talk.groupAllowFrom: elenco dei mittenti consentiti nelle stanze (ID utente); se non impostato, utilizza allowFrom.
• channels.nextcloud-talk.rooms: impostazioni ed elenco degli elementi consentiti per stanza (vedere sopra).
• I gruppi statici di accesso dei mittenti possono essere richiamati da allowFrom e groupAllowFrom con accessGroup:<name>.
• channels.nextcloud-talk.historyLimit: limite della cronologia dei gruppi (0 la disabilita).
• channels.nextcloud-talk.dmHistoryLimit: limite della cronologia dei messaggi diretti (0 la disabilita).
• channels.nextcloud-talk.dms: sostituzioni per messaggio diretto indicizzate per ID utente (historyLimit).
• channels.nextcloud-talk.textChunkLimit: dimensione dei segmenti di testo in uscita in caratteri (valore predefinito: 4000).
• channels.nextcloud-talk.streaming.chunkMode: length (valore predefinito) o newline per suddividere in corrispondenza delle righe vuote (limiti dei paragrafi) prima della segmentazione per lunghezza.
• channels.nextcloud-talk.streaming.block.enabled: abilita o disabilita lo streaming a blocchi per questo canale.
• channels.nextcloud-talk.streaming.block.coalesce: regolazione dell’unione nello streaming a blocchi.
• channels.nextcloud-talk.responsePrefix: prefisso delle risposte in uscita.
• channels.nextcloud-talk.markdown.tables: modalità di rendering delle tabelle Markdown (off | bullets | code | block).
• channels.nextcloud-talk.mediaMaxMb: limite dei contenuti multimediali in ingresso (MB).
• channels.nextcloud-talk.network.dangerouslyAllowPrivateNetwork: consente agli host Nextcloud privati/interni di superare la protezione SSRF.
• channels.nextcloud-talk.accounts.<id>: sostituzioni per account (stesse chiavi); defaultAccount seleziona il valore predefinito. Le variabili d’ambiente NEXTCLOUD_TALK_BOT_SECRET / NEXTCLOUD_TALK_API_PASSWORD si applicano solo all’account predefinito.

​

Argomenti correlati

• Panoramica dei canali — tutti i canali supportati
• Associazione — autenticazione dei messaggi diretti e flusso di associazione
• Gruppi — comportamento delle chat di gruppo e requisito di menzione
• Instradamento dei canali — instradamento delle sessioni per i messaggi
• Sicurezza — modello di accesso e rafforzamento della sicurezza