File de pilotage

Lorsqu’une invite normale arrive alors que l’exécution d’une session est déjà en cours de diffusion et que le mode de file d’attente est steer (mode par défaut, aucune configuration nécessaire), OpenClaw tente d’envoyer cette invite au moteur d’exécution actif. OpenClaw et le harnais natif du serveur d’application Codex implémentent différemment les modalités de transmission.

Cette page décrit le pilotage par mode de file d’attente des messages entrants normaux en mode steer. En mode followup ou collect, les messages normaux ignorent ce chemin et attendent la fin de l’exécution active. Pour la commande explicite /steer <message>, consultez Piloter.

Limite du moteur d’exécution

Le pilotage n’interrompt pas un appel d’outil déjà en cours. OpenClaw recherche les messages de pilotage en attente aux limites du modèle :

1. L’assistant demande des appels d’outils.
2. OpenClaw exécute le lot d’appels d’outils du message actuel de l’assistant.
3. OpenClaw émet l’événement de fin de tour.
4. OpenClaw vide la file des messages de pilotage en attente.
5. OpenClaw ajoute ces messages en tant que messages utilisateur avant le prochain appel au LLM.

Cela permet d’associer les résultats des outils au message de l’assistant qui les a demandés, puis de présenter les dernières entrées utilisateur au prochain appel du modèle.

Le harnais natif du serveur d’application Codex expose turn/steer au lieu de la file de pilotage interne du moteur d’exécution d’OpenClaw. OpenClaw regroupe les invites en attente pendant la fenêtre de silence configurée, puis envoie une seule requête turn/steer contenant toutes les entrées utilisateur collectées dans leur ordre d’arrivée.

Les tours de révision et de compaction manuelle de Codex refusent le pilotage au cours du même tour. Lorsqu’un moteur d’exécution ne peut pas accepter le pilotage en mode steer, OpenClaw attend la fin de l’exécution active avant de traiter l’invite.

Modes

Exemple de rafale

Si quatre utilisateurs envoient des messages pendant que l’agent exécute un appel d’outil :

• Avec le comportement par défaut, le moteur d’exécution actif reçoit les quatre messages dans leur ordre d’arrivée avant sa prochaine décision de modèle. OpenClaw les retire de la file à la prochaine limite du modèle ; Codex les reçoit dans une seule requête turn/steer groupée.
• Avec /queue collect, OpenClaw n’effectue aucun pilotage. Il attend la fin de l’exécution active, puis crée un tour de suivi contenant les messages en attente compatibles après la fenêtre d’anti-rebond.
• Avec /queue interrupt, OpenClaw abandonne l’exécution active et traite le message le plus récent au lieu d’effectuer un pilotage.

Portée

Le pilotage cible toujours l’exécution active de la session actuelle. Il ne crée pas de nouvelle session, ne modifie pas la politique d’utilisation des outils de l’exécution active et ne répartit pas les messages par expéditeur. Dans les canaux multi-utilisateurs, les invites entrantes incluent déjà le contexte de l’expéditeur et de l’acheminement, ce qui permet au prochain appel du modèle d’identifier l’auteur de chaque message.

Utilisez followup ou collect lorsque vous souhaitez que les messages soient placés en file d’attente par défaut au lieu de piloter l’exécution active. Utilisez interrupt lorsque l’invite la plus récente doit remplacer l’exécution active.

Anti-rebond

messages.queue.debounceMs s’applique à la transmission des messages followup et collect en attente. En mode steer avec le harnais natif Codex, ce paramètre définit également la fenêtre de silence précédant l’envoi d’une requête turn/steer groupée. Pour OpenClaw, le pilotage actif lui-même n’utilise pas le minuteur d’anti-rebond, car OpenClaw regroupe naturellement les messages jusqu’à la prochaine limite du modèle.

Voir aussi

• File d’attente des commandes
• Piloter
• Messages
• Boucle de l’agent