English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this pageOpen in PerplexityAsk questions about this page

Developer and self-hosted

Nextcloud Talk

Statut : plugin intégré (bot webhook). Les messages directs, les salons, les réactions et les messages markdown sont pris en charge.

Plugin intégré

Nextcloud Talk est fourni comme plugin intégré dans les versions actuelles d’OpenClaw ; les builds empaquetés normaux ne nécessitent donc pas d’installation séparée.

Si vous utilisez un build plus ancien ou une installation personnalisée qui exclut Nextcloud Talk, installez directement le package npm :

Installation via la CLI (registre npm) :

bash
openclaw plugins install @openclaw/nextcloud-talk

Utilisez le package nu pour suivre le tag de version officiel actuel. Épinglez une version exacte uniquement lorsque vous avez besoin d’une installation reproductible.

Checkout local (lors de l’exécution depuis un dépôt git) :

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

Détails : Plugins

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 :

    bash
    ./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 :

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

    Champs explicites équivalents :

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

    Secret adossé à un fichier :

    bash
    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).

Configuration minimale :

json5
{  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 &lt;CODE&gt;
  • 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 :
json5
{  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

Fonctionnalité Statut
Messages directs Pris en charge
Salons Pris en charge
Threads Non pris en charge
Médias URL uniquement
Réactions Pris en charge
Commandes natives Non pris en charge

Référence de configuration (Nextcloud Talk)

Configuration complète : Configuration

Options du fournisseur :

  • 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é

Was this useful?