Nextcloud Talk

​

Installation

openclaw plugins install @openclaw/nextcloud-talk

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

​

Configuration rapide (débutant)

1. Installez le plugin (voir ci-dessus).
2. Sur votre serveur Nextcloud, créez un bot :
   ./occ talk:bot:install "OpenClaw" "<shared-secret>" "<webhook-url>" --feature webhook --feature response --feature reaction
   
   Conservez --feature response : sans cette option, les réponses sortantes échouent avec le code 401. Réparez un bot existant avec ./occ talk:bot:state --feature webhook --feature response --feature reaction <botId> 1.
3. Activez le bot dans les paramètres du salon cible.
4. Configurez OpenClaw :
   • Configuration : channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
   • Ou variables d’environnement : NEXTCLOUD_TALK_BOT_SECRET (compte par défaut uniquement)
   Configuration par CLI (--url/--token sont des alias des champs explicites ; nc-talk et nc fonctionnent comme alias de canal) :
   openclaw channels add --channel nextcloud-talk \
     --url https://cloud.example.com \
     --token "<shared-secret>"
   
   Champs explicites équivalents :
   openclaw channels add --channel nextcloud-talk \
     --base-url https://cloud.example.com \
     --secret "<shared-secret>"
   
   Secret stocké dans un fichier :
   openclaw channels add --channel nextcloud-talk \
     --base-url https://cloud.example.com \
     --secret-file /path/to/nextcloud-talk-secret
   
5. Redémarrez le Gateway (ou terminez la configuration).

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

​

Remarques

• Les bots ne peuvent pas initier de messages directs. L’utilisateur doit d’abord envoyer un message au bot.
• L’URL du Webhook doit être accessible depuis le serveur Nextcloud ; définissez webhookPublicUrl lorsque le Gateway se trouve derrière un proxy. Les requêtes Webhook sont signées avec HMAC-SHA256 à l’aide du secret du bot ; les signatures non valides sont rejetées et soumises à une limitation de débit.
• Les téléversements de médias ne sont pas pris en charge par l’API du bot ; les médias sortants sont ajoutés sous forme de ligne Attachment: <url>.
• La charge utile du Webhook ne distingue pas les messages directs des salons ; définissez apiUser + apiPassword pour activer les recherches de type de salon (mises en cache pendant environ 5 minutes). Sans ces paramètres, chaque conversation est traitée comme un salon.
• Les requêtes sortantes passent par la protection SSRF. Pour un hôte Nextcloud situé sur un réseau privé/interne de confiance, autorisez-le avec channels.nextcloud-talk.network.dangerouslyAllowPrivateNetwork: true.
• Lorsque apiUser/apiPassword et webhookPublicUrl sont définis, openclaw channels status interroge le bot et émet un avertissement si la fonctionnalité response est absente.

​

Contrôle d’accès (messages directs)

• Valeur par défaut : channels.nextcloud-talk.dmPolicy = "pairing". Les expéditeurs inconnus reçoivent un code d’association.
• Approuvez-les avec :
  • openclaw pairing list nextcloud-talk
  • openclaw pairing approve nextcloud-talk <CODE>
• Messages directs publics : channels.nextcloud-talk.dmPolicy="open" avec channels.nextcloud-talk.allowFrom=["*"].
• allowFrom correspond uniquement aux identifiants utilisateur Nextcloud (en minuscules) ; les noms d’affichage sont ignorés.

​

Salons (groupes)

• Valeur par défaut : channels.nextcloud-talk.groupPolicy = "allowlist" (mention obligatoire).
• Autorisez les salons avec channels.nextcloud-talk.rooms, indexé par jeton de salon ; "*" définit une valeur générique par défaut :

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

• Clés propres à chaque salon : requireMention (true par défaut), enabled (false désactive le salon), allowFrom (liste d’autorisation des expéditeurs propre au salon), tools (dérogations d’autorisation ou de refus pour les outils), skills (limite les Skills chargées), systemPrompt.
• Pour n’autoriser aucun salon, laissez la liste d’autorisation vide ou définissez channels.nextcloud-talk.groupPolicy="disabled".

​

Fonctionnalités

​

Référence de configuration (Nextcloud Talk)

• channels.nextcloud-talk.enabled : active ou désactive le démarrage du canal.
• channels.nextcloud-talk.baseUrl : URL de l’instance Nextcloud.
• channels.nextcloud-talk.botSecret : secret partagé du bot (chaîne ou référence de secret).
• channels.nextcloud-talk.botSecretFile : chemin du secret dans un fichier ordinaire. Les liens symboliques sont rejetés.
• channels.nextcloud-talk.apiUser : utilisateur de l’API pour les recherches de salons (détection des messages directs) et la vérification d’état.
• channels.nextcloud-talk.apiPassword : mot de passe d’API/d’application pour les recherches de salons.
• channels.nextcloud-talk.apiPasswordFile : chemin du fichier contenant le mot de passe d’API.
• channels.nextcloud-talk.webhookPort : port d’écoute du Webhook (valeur par défaut : 8788).
• channels.nextcloud-talk.webhookHost : hôte du Webhook (valeur par défaut : 0.0.0.0).
• channels.nextcloud-talk.webhookPath : chemin du Webhook (valeur par défaut : /nextcloud-talk-webhook).
• channels.nextcloud-talk.webhookPublicUrl : URL du Webhook accessible depuis l’extérieur.
• channels.nextcloud-talk.dmPolicy : pairing | allowlist | open | disabled (valeur par défaut : association). open nécessite allowFrom=["*"].
• channels.nextcloud-talk.allowFrom : liste d’autorisation des messages directs (identifiants utilisateur).
• channels.nextcloud-talk.groupPolicy : allowlist | open | disabled (valeur par défaut : liste d’autorisation).
• channels.nextcloud-talk.groupAllowFrom : liste d’autorisation des expéditeurs de salons (identifiants utilisateur) ; utilise allowFrom si cette option n’est pas définie.
• channels.nextcloud-talk.rooms : paramètres et liste d’autorisation propres à chaque salon (voir ci-dessus).
• Les groupes statiques d’accès des expéditeurs peuvent être référencés depuis allowFrom et groupAllowFrom avec accessGroup:<name>.
• channels.nextcloud-talk.historyLimit : limite de l’historique des groupes (0 le désactive).
• channels.nextcloud-talk.dmHistoryLimit : limite de l’historique des messages directs (0 le désactive).
• channels.nextcloud-talk.dms : dérogations propres à chaque conversation directe, indexées par identifiant utilisateur (historyLimit).
• channels.nextcloud-talk.textChunkLimit : taille des segments de texte sortant en caractères (valeur par défaut : 4000).
• channels.nextcloud-talk.streaming.chunkMode : length (valeur par défaut) ou newline pour effectuer la segmentation sur les lignes vides (limites de paragraphes) avant la segmentation selon la longueur.
• channels.nextcloud-talk.streaming.block.enabled : active ou désactive la diffusion par blocs pour ce canal.
• channels.nextcloud-talk.streaming.block.coalesce : réglage de la fusion pour la diffusion par blocs.
• channels.nextcloud-talk.responsePrefix : préfixe des réponses sortantes.
• channels.nextcloud-talk.markdown.tables : mode de rendu des tableaux Markdown (off | bullets | code | block).
• channels.nextcloud-talk.mediaMaxMb : limite des médias entrants (Mo).
• channels.nextcloud-talk.network.dangerouslyAllowPrivateNetwork : autorise les hôtes Nextcloud privés/internes à franchir la protection SSRF.
• channels.nextcloud-talk.accounts.<id> : dérogations propres à chaque compte (mêmes clés) ; defaultAccount sélectionne le compte par défaut. Les variables d’environnement NEXTCLOUD_TALK_BOT_SECRET / NEXTCLOUD_TALK_API_PASSWORD s’appliquent uniquement au compte par défaut.

​

Voir aussi

• Présentation des canaux — tous les canaux pris en charge
• Association — authentification des messages directs et processus d’association
• Groupes — comportement des discussions de groupe et obligation de mention
• Routage des canaux — routage des sessions pour les messages
• Sécurité — modèle d’accès et renforcement de la sécurité