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.

​

Plugin intégré

openclaw plugins install @openclaw/nextcloud-talk

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

​

Configuration rapide (débutant)

1. Assurez-vous que le plugin Nextcloud Talk est disponible.
   • Les versions OpenClaw empaquetées actuelles l’intègrent déjà.
   • Les installations plus anciennes/personnalisées peuvent l’ajouter manuellement avec les commandes 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
   
3. Activez le bot dans les paramètres du salon cible.
4. Configurez OpenClaw :
   • Config : channels.nextcloud-talk.baseUrl + channels.nextcloud-talk.botSecret
   • Ou variable d’environnement : NEXTCLOUD_TALK_BOT_SECRET (compte par défaut uniquement)
   Configuration CLI :
   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 adossé à 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",
    },
  },
}

​

Notes

• 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 par le Gateway ; définissez webhookPublicUrl si vous êtes derrière un proxy.
• Les téléversements de médias ne sont pas pris en charge par l’API du bot ; les médias sont envoyés sous forme d’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 (sinon, les messages directs sont traités comme des salons).

​

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

• Par défaut : channels.nextcloud-talk.dmPolicy = "pairing". Les expéditeurs inconnus reçoivent un code d’association.
• Approuver via :
  • openclaw pairing list nextcloud-talk
  • openclaw pairing approve nextcloud-talk <CODE>
• Messages directs publics : channels.nextcloud-talk.dmPolicy="open" plus channels.nextcloud-talk.allowFrom=["*"].
• allowFrom correspond uniquement aux ID utilisateur Nextcloud ; les noms d’affichage sont ignorés.

​

Salons (groupes)

• Par défaut : channels.nextcloud-talk.groupPolicy = "allowlist" (contrôlé par mention).
• Autorisez des salons avec channels.nextcloud-talk.rooms :

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

• Pour n’autoriser aucun salon, gardez la liste d’autorisation vide ou définissez channels.nextcloud-talk.groupPolicy="disabled".

​

Capacités

​

Référence de configuration (Nextcloud Talk)

• channels.nextcloud-talk.enabled : activer/désactiver le démarrage du canal.
• channels.nextcloud-talk.baseUrl : URL de l’instance Nextcloud.
• channels.nextcloud-talk.botSecret : secret partagé du bot.
• channels.nextcloud-talk.botSecretFile : chemin de secret de fichier régulier. Les liens symboliques sont rejetés.
• channels.nextcloud-talk.apiUser : utilisateur API pour les recherches de salons (détection des messages directs).
• channels.nextcloud-talk.apiPassword : mot de passe API/application pour les recherches de salons.
• channels.nextcloud-talk.apiPasswordFile : chemin du fichier de mot de passe API.
• channels.nextcloud-talk.webhookPort : port de l’écouteur webhook (par défaut : 8788).
• channels.nextcloud-talk.webhookHost : hôte du webhook (par défaut : 0.0.0.0).
• channels.nextcloud-talk.webhookPath : chemin du webhook (par défaut : /nextcloud-talk-webhook).
• channels.nextcloud-talk.webhookPublicUrl : URL de webhook accessible de l’extérieur.
• channels.nextcloud-talk.dmPolicy : pairing | allowlist | open | disabled.
• channels.nextcloud-talk.allowFrom : liste d’autorisation des messages directs (ID utilisateur). open nécessite "*".
• channels.nextcloud-talk.groupPolicy : allowlist | open | disabled.
• channels.nextcloud-talk.groupAllowFrom : liste d’autorisation de groupe (ID utilisateur).
• channels.nextcloud-talk.rooms : paramètres par salon et liste d’autorisation.
• Les groupes d’accès d’expéditeurs statiques peuvent être référencés depuis allowFrom et groupAllowFrom avec accessGroup:<name>.
• channels.nextcloud-talk.historyLimit : limite d’historique de groupe (0 désactive).
• channels.nextcloud-talk.dmHistoryLimit : limite d’historique des messages directs (0 désactive).
• channels.nextcloud-talk.dms : remplacements par message direct (historyLimit).
• channels.nextcloud-talk.textChunkLimit : taille des blocs de texte sortant (caractères).
• channels.nextcloud-talk.chunkMode : length (par défaut) ou newline pour découper sur les lignes vides (limites de paragraphes) avant le découpage par longueur.
• channels.nextcloud-talk.blockStreaming : désactiver le streaming de blocs pour ce canal.
• channels.nextcloud-talk.blockStreamingCoalesce : réglage de la coalescence du streaming de blocs.
• channels.nextcloud-talk.mediaMaxMb : plafond des médias entrants (Mo).

​

Associé

• Vue d’ensemble des canaux — tous les canaux pris en charge
• Association — authentification des messages directs et flux d’association
• Groupes — comportement des discussions de groupe et contrôle par mention
• Routage des canaux — routage des sessions pour les messages
• Sécurité — modèle d’accès et renforcement