Les moteurs de contexte d’OpenClaw

Tout ce que le modèle voit est assemblé par quelque chose. Dans OpenClaw ce quelque chose est un moteur de contexte, et il est remplaçable. Celui d’origine préserve le comportement historique, mais l’interface en dessous est là où branchent les stratégies lourdes en récupération ou en résumé. Voici les points du cycle, le contrat qu’un plugin doit honorer, et les deux comportements de panne qui empêchent un mauvais moteur de rendre l’agent muet.

Quatre points de cycle

• L’ingestion est appelée quand un message rejoint la session pour que le moteur le stocke ou l’indexe ; l’assemblage est appelé avant chaque exécution et renvoie un ensemble ordonné de messages plus un ajout optionnel à l’invite système qui tient dans le budget de jetons ; la compaction est appelée quand la fenêtre est pleine ou que l’utilisateur la demande ; et un crochet de fin de tour laisse le moteur persister son état, lancer une compaction de fond ou mettre à jour ses index.
• Une méthode de maintenance optionnelle fait l’entretien de la transcription après l’amorçage, un tour réussi ou une compaction, via une aide de réécriture sûre, et peut être déclarée comme travail de fond pour ne pas bloquer la réponse ; une compaction de budget en file qui accepte la maintenance de fond garde le runtime préparé vivant à travers la maintenance, les reprises et la libération, l’acceptation ne signifiant donc pas que le nettoyage est fini.
• Deux crochets de sous-agent optionnels préparent l’état partagé avant le démarrage d’un enfant et nettoient à sa fin ; le crochet de préparation reçoit les clés de session parente et enfant, le mode de contexte, les identifiants de transcription disponibles et une durée optionnelle, et peut renvoyer une poignée d’annulation qu’OpenClaw appelle si le démarrage échoue ensuite.
• Le moteur historique intégré est volontairement mince : l’ingestion ne fait rien parce que le gestionnaire de session persiste les messages, l’assemblage passe la main au pipeline existant de nettoyage, validation et limitation, la compaction délègue au résumé intégré, et le crochet de fin de tour ne fait rien ; il n’enregistre aucun outil et n’ajoute rien à l’invite système.

Déclarer que le moteur ne possède pas la compaction ne signifie pas qu’OpenClaw revient automatiquement au chemin de compaction du moteur historique.

Écrire un moteur

Un plugin enregistre un moteur avec un identifiant, un nom, la propriété ou non de la compaction, et les paramètres d’hôte qu’il accepte ; OpenClaw intersecte cette déclaration avec les champs disponibles pour chaque méthode, donc aucune clé non déclarée ou inconnue n’est injectée, et un moteur sans déclaration reçoit tous les champs courants. Pour des tours admis durables, un moteur déclare les deux sémantiques de transcription et implémente une méthode de validation comme une écriture atomique et idempotente indexée par une clé d’avancement, renvoyant un statut validé à la première écriture et un statut doublon quand une reprise de l’hôte présente la même clé ; la charge ne couvre que la plage allant du message utilisateur admis à l’entrée terminale acceptée, et l’historique antérieur se lit par le curseur de transcription. Sans la déclaration complète et la méthode, OpenClaw utilise le chemin historique pour tout le tour logique, reprises comprises, laisse l’emplacement configuré inchangé, et réessaie le moteur au tour suivant. Le résultat d’assemblage porte les messages, une estimation de jetons, un ajout optionnel à l’invite, un drapeau d’autorité qui décide quelle estimation la vérification de débordement utilise, et une projection optionnelle pour les hôtes à fils persistants.

Exigences et pannes

• Un moteur peut déclarer des exigences de capacité de l’hôte, par exemple devoir contrôler l’invite réelle via l’assemblage ; les exécutions natives et embarquées satisfont cette capacité alors que les backends en ligne de commande génériques non, un moteur qui l’exige est donc rejeté avant le démarrage du processus, en échouant fermé avec un message explicite.
• Si un moteur non historique est absent, échoue la validation de contrat, lève une erreur à la création ou dans une méthode de cycle, OpenClaw le met en quarantaine pour le processus de passerelle courant, rabat le travail de contexte sur le moteur historique pour que les réponses continuent, et journalise l’erreur avec l’opération fautive pour que l’opérateur répare, mette à jour ou désactive le plugin.
• Posséder la compaction désactive la compaction automatique intégrée en cours de tentative et la vérification générique de débordement pour cette exécution, rendant le moteur responsable de la compaction manuelle, de la reprise après débordement et de tout travail proactif ; ne pas la posséder laisse la compaction automatique disponible tout en routant la compaction manuelle et la reprise vers le moteur, ce qui rend une méthode de compaction vide dangereuse.

La compaction OpenClaw est le comportement auquel le moteur historique délègue et Le contexte OpenClaw expliqué la chose assemblée.

Choisir et retirer

L’emplacement est exclusif à l’exécution : un seul moteur enregistré est résolu pour une exécution ou une compaction donnée, même si d’autres plugins de moteur activés chargent et exécutent leur code d’enregistrement. Désinstaller le plugin actuellement sélectionné remet l’emplacement à la valeur par défaut, et la même remise à zéro s’applique à l’emplacement mémoire, aucune édition manuelle n’est donc nécessaire. Changer de moteur ne réécrit pas les sessions existantes ; elles continuent avec leur historique pendant que le nouveau moteur prend la main sur les exécutions futures. Les plugins de mémoire forment un emplacement distinct qui fournit recherche et récupération, et un moteur peut s’appuyer dessus pendant l’assemblage via l’aide documentée plutôt qu’en touchant à leur disposition. Les plugins OpenClaw couvre le système de plugins et La recherche mémoire d’OpenClaw le côté récupération.

Sur Diali

Sur Diali la configuration d’exécution est générée depuis le tableau de bord et remplacée à chaque version, le choix du moteur fait donc partie de cette configuration générée plutôt que d’un fichier édité à la main. OpenClaw hébergé sur Diali décrit l’assistant hébergé et La sécurité Diali la frontière autour de chaque runtime.

• Ingestion, assemblage, compaction, fin de tour : quatre points, un contrat.
• Un moteur cassé est mis en quarantaine ; l’historique fait répondre l’agent.
• Sans les sémantiques déclarées, le tour repasse en silence à l’historique.