Aller au contenu
Guides

L’exec en arrière-plan et l’outil de processus d’OpenClaw

Comment une commande passe en arrière-plan après le délai de rendu, le registre de sessions avec ses plafonds de sortie et ses durées de vie, les environnements de travailleur qui survivent à un tour, et les neuf actions de l’outil

7 min de lecture

Le travail de longue haleine est là où un outil shell devient utile ou devient un fardeau. La réponse d’OpenClaw est de passer la commande en arrière-plan, de rendre un identifiant de session, et de donner à l’agent un outil séparé pour l’interroger, l’alimenter et la tuer. Les détails qui comptent sont ceux qui décident si la sortie survit, si le processus survit, et ce que l’agent doit faire au lieu de dormir.

Passage en fond et conservation

  • Une exécution au premier plan renvoie directement la sortie conservée et signale quand une sortie antérieure a dépassé le plafond agrégé ; quand la commande passe en arrière-plan, explicitement ou en dépassant le délai de rendu, l’outil renvoie un statut en cours, un identifiant de session et une courte fin de sortie, et les exécutions de fond héritent quand même du délai exec configuré sauf si l’appel fournit le sien.
  • Rendre un identifiant de session n’arrête pas le délai du processus : pour un service persistant sur la passerelle ou dans un bac à sable, lancez la commande en fond avec le délai désactivé et arrêtez-la plus tard avec l’action de terminaison, les limites de cycle de vie de l’hôte et du travailleur restant applicables.
  • La sortie reste en mémoire jusqu’au plafond agrégé par session tant que la session n’est pas interrogée ou effacée ; les sessions terminées expirent selon une durée mesurée depuis la fin, chaque exec capturant le réglage de conservation de son agent à l’admission, et le registre garde au plus 50 sessions terminées et deux millions de caractères, en évinçant les plus anciennes d’abord tandis que la session terminée la plus récente garde son agrégat plafonné.
  • Les réglages existent en clés de configuration plutôt qu’en variables d’environnement : le délai de passage en fond est de dix secondes, le délai par appel de 1800 secondes, la durée de nettoyage de 30 minutes, la notification de sortie est active par défaut et dépose un événement système plus une demande de battement, et un réglage supplémentaire peut aussi notifier les exécutions réussies sans sortie.
L’interrogation sert au statut à la demande, pas à une boucle d’attente. Si le travail doit avoir lieu plus tard, utilisez le planificateur.

Travailleurs, nettoyage et outil de processus

Sur un nœud appairé ou un travailleur infonuagique adossé à un nœud, les processus de fond appartiennent à l’environnement de la session : terminer ou annuler un tour laisse tourner les commandes déjà passées en fond, un tour ultérieur dans le même environnement peut les interroger, les alimenter ou les arrêter, et les commandes au premier plan s’arrêtent toujours quand leur tour est annulé. Le travailleur conservé occupe un emplacement de nœud, le réutiliser n’en demande pas un second, et dès qu’un tour se termine sans commande de fond vivante le travailleur sort. Déplacer ou retirer l’environnement, remplacer sa propriété ou arrêter le nœud arrête aussi ses processus, et les poignées ne survivent pas au redémarrage d’un travailleur ou d’un nœud. Le nettoyage est délibérément prudent ailleurs aussi : pour les groupes de processus possédés il attend que le système confirme la disparition du groupe, une commande terminée ou un tube de sortie fermé ne prouve pas à lui seul que les descendants se sont arrêtés, et une terminaison forcée sans nettoyage confirmé reste incertaine plutôt que rapportée comme un arrêt propre.

Les neuf actions

  • Lister montre les sessions en cours et terminées avec un nom dérivé, interroger vide la nouvelle sortie et rapporte le statut de sortie, journal lit la sortie agrégée avec une pagination par lignes et des indices de récupération d’entrée, et les trois ne signalent une session en attente d’entrée que si son entrée reste ouverte et qu’elle est inactive au-delà du seuil.
  • Écrire envoie l’entrée standard avec une fin optionnelle, l’envoi de touches transmet des jetons de touches ou des octets à une session adossée à un terminal, valider envoie un retour chariot, et coller envoie du texte littéral encadré par défaut ; tuer arrête une session en cours, effacer retire une session terminée, et retirer fait ce qui s’applique.
  • Seules les sessions passées en fond sont listées et conservées, en mémoire et jamais sur disque, elles sont donc perdues au redémarrage ; l’outil est limité à son agent et ne voit que ses sessions, une session de fond vivante bloque la suspension coopérative et le redémarrage sûr de la passerelle jusqu’à confirmation de la sortie, et un délai d’interrogation au-delà de 30 secondes est ramené à cette valeur.

L’outil exec d’OpenClaw est l’outil qui démarre ces sessions et Les tâches de fond d’OpenClaw le registre qui les montre pendant qu’elles tournent.

Que faire au lieu de dormir

La documentation est franche sur l’anti-modèle : n’imitez pas des rappels ou des relances différées avec des boucles d’attente ou des interrogations répétées. Pour un travail qui commence maintenant, lancez-le une fois et comptez sur le réveil automatique de fin quand il est activé et que la commande produit une sortie ou échoue, puis utilisez l’outil de processus pour les journaux, le statut, l’entrée ou l’intervention. Pour un travail qui doit arriver plus tard ou selon un horaire, le planificateur est la bonne surface. Lire le journal avant de récupérer une commande interactive est l’autre habitude à garder, parce que la transcription, l’état de l’entrée et l’indice d’attente n’y sont visibles qu’ensemble. Les automatisations OpenClaw couvre le planificateur et Le bac à sable OpenClaw expliqué l’endroit où ces commandes tournent vraiment.

Sur Diali

Sur Diali l’assistant tourne dans son propre runtime avec son état sur un volume persistant, une commande de fond appartient donc à ce seul runtime client ; des instantanés quotidiens et une restauration en un clic sont disponibles grâce à l’option Sauvegardes (incluse avec Max). OpenClaw hébergé sur Diali décrit l’assistant hébergé et La sécurité Diali la frontière autour de ce qu’il peut exécuter.

  • Passé le délai, une commande rend un identifiant, pas un mur de sortie.
  • En mémoire seulement : sessions perdues au redémarrage, plafonnées et expirantes.
  • Le réveil de fin vaut mieux que l’interrogation ; le planificateur mieux que dormir.
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.