Aller au contenu
Guides

Composants et approbations Discord dans OpenClaw

Conteneurs components v2, boutons, sélecteurs, formulaires et blocs de fichiers, durées de vie des rappels, le sélecteur de modèle, et les approbations d’exécution par boutons

6 min de lecture

Un oui ou non d’un humain devrait être un bouton, pas une réponse tapée. OpenClaw prend en charge les conteneurs Discord components v2 pour les messages d’agent par la charge de composants de l’outil de message, et les résultats d’interaction reviennent à l’agent comme messages entrants ordinaires sous les réglages de réponse existants. La même mécanique porte les approbations d’exécution dans Discord sous forme de boutons. Voici les blocs pris en charge et leurs limites, les durées de vie et l’accès des rappels, les fichiers et les formulaires, le sélecteur de modèle, les règles de components v2, et la configuration des approbations.

Composants

  • Les composants sont une extension propre à Discord de l’outil de message partagé, exposée dès que Discord est configuré, même quand un autre canal est courant ; pour un message riche qui doit fonctionner sur plusieurs canaux, la charge de présentation est la forme portable qu’OpenClaw adapte à chaque cible.
  • Blocs pris en charge : texte, section, séparateur, actions, galerie de médias et fichier ; une rangée d’actions contient jusqu’à cinq boutons ou un seul sélecteur, les boutons acceptent les emoji y compris les boutons de lien, et les types de sélecteurs sont chaîne, utilisateur, rôle, mentionnable et canal.
  • Les composants sont à usage unique par défaut, et une option de réutilisation laisse les boutons, sélecteurs et formulaires servir plusieurs fois jusqu’à expiration ; les envois, modifications et réponses de commandes natives attendent la fin de l’enregistrement des rappels, consommer un choix à usage unique retire ses rappels frères avant qu’une autre interaction puisse les résoudre, et si la persistance est indisponible OpenClaw le signale et garde un repli en mémoire pour le processus. Une liste d’utilisateurs autorisés par bouton, identifiants, étiquettes ou joker, restreint qui peut cliquer, avec un refus éphémère pour les autres.
  • Les rappels expirent après trente minutes par défaut, réglables pour le compte par défaut ou par compte nommé en millisecondes jusqu’à vingt-quatre heures ; des durées plus longues conviennent aux flux de relecture mais élargissent la fenêtre pendant laquelle un ancien message peut encore déclencher une action, donc la documentation recommande la durée la plus courte qui convient.
Les invites d’approbation incluent le texte de la commande, donc n’activez la livraison en canal que dans des canaux de confiance.

Fichiers, formulaires, le sélecteur

Les blocs de fichier doivent pointer vers une référence de pièce jointe et la pièce jointe elle-même est fournie par les champs de média ou de chemin pour un seul fichier, avec la galerie de médias pour plusieurs, une surcharge de nom de fichier quand le nom envoyé doit correspondre à la référence, et des légendes qui préservent l’ordre des blocs de texte. Un formulaire modal se déclare avec jusqu’à cinq champs de type texte, case à cocher, bouton radio, sélecteur, sélecteur de rôle ou d’utilisateur, et OpenClaw ajoute automatiquement le bouton de déclenchement ; l’exemple de la documentation combine un conteneur réutilisable avec un bouton d’approbation limité à un utilisateur, un bouton de refus, un sélecteur de chaîne et un formulaire de détails. Les commandes de modèle et de modèles ouvrent un sélecteur interactif avec des menus de fournisseur, de modèle et d’environnement et une étape de validation, éphémère et utilisable seulement par l’utilisateur qui l’invoque ; Discord limite les menus à vingt-cinq options, donc les modèles découverts dynamiquement ne sont montrés que pour les fournisseurs ajoutés à la liste d’autorisation de la politique de modèles, et l’ancienne commande d’ajout depuis le chat est dépréciée. OpenClaw utilise components v2 pour les approbations d’exécution et les marqueurs inter-contextes, les embeds sont ignorés quand components v2 est présent et ne sont pas recommandés, et les aperçus d’URL simples sont supprimés par défaut avec une option par message pour laisser un seul lien sortant se déployer.

Approbations

  • Discord prend en charge le traitement des approbations par boutons en messages privés et peut éventuellement publier les invites dans le canal d’origine ; la configuration a un indicateur d’activation qui doit valoir vrai ou auto, une liste d’approbateurs facultative qui retombe sur les propriétaires de commandes, une cible message privé, canal ou les deux valant message privé par défaut, des filtres d’agent et de session, et une option de nettoyage après résolution. Les approbations natives exigent au moins un approbateur résolu, et Discord ne déduit jamais les approbateurs des listes de canaux ou de messages privés.
  • Pour les commandes de groupe sensibles réservées au propriétaire comme les diagnostics et l’export de trajectoire, les invites et les résultats partent en privé, en message privé Discord d’abord quand le propriétaire qui invoque a une route de propriétaire Discord et sinon vers la première route de propriétaire sur un autre canal. Avec canal ou les deux comme cible, l’invite est visible dans le canal, seuls les approbateurs résolus peuvent utiliser les boutons, les autres reçoivent un refus éphémère, et un identifiant de canal qui ne peut pas être dérivé de la clé de session retombe sur le message privé.
  • Discord rend les boutons d’approbation partagés utilisés par les autres canaux, en ajoutant le routage en message privé des approbateurs et la diffusion en canal ; quand les boutons sont présents ils sont le chemin principal, une commande d’approbation manuelle n’est proposée que quand les approbations par chat sont indisponibles, un environnement natif inactif garde visible l’invite d’approbation déterministe, et un environnement actif qui ne peut livrer aucune carte envoie un avis dans le même chat avec la commande exacte. Les approbations se résolvent par le contrat client partagé de la passerelle et expirent après trente minutes par défaut.

OpenClaw sur Discord est le canal auquel ces surfaces appartiennent, et Les approbations d’exécution d’OpenClaw le flux d’approbation d’exécution que les boutons présentent.

Deux règles à retenir

Restreignez les boutons cliquables avec des utilisateurs autorisés et gardez des durées de vie de rappels courtes ; un bouton que n’importe qui peut presser pendant une journée est un piège même sur un serveur privé. Modèles et fournisseurs d’OpenClaw couvre les fournisseurs parmi lesquels le sélecteur choisit, et Les commandes slash d’OpenClaw les commandes natives auxquelles le sélecteur et les approbations se rattachent.

Sur Diali

Sur Diali, les approbations d’exécution vous atteignent sur Discord sous les mêmes boutons partagés, en message privé par défaut, et les composants sont disponibles pour l’assistant dès que le bot Discord est connecté ; la durée de vie des rappels et les règles d’approbateurs sont les valeurs amont par défaut. OpenClaw hébergé sur Diali est l’assistant et La sécurité chez Diali décrit la frontière qu’une approbation protège.

  • Cinq boutons ou un sélecteur par rangée, usage unique par défaut.
  • Des rappels de trente minutes, plafonnés à une journée.
  • Les approbateurs sont explicites ; le message privé est la cible par défaut.
Commencer

Arrêtez de lire, construisez le vôtre

Configurez un agent, choisissez un canal, et faites-le travailler dans l’application que vous gardez déjà ouverte.