Fundamentals
Fonctionnalités expérimentales
Les fonctionnalités expérimentales d’OpenClaw sont des surfaces d’aperçu activables explicitement. Elles sont placées derrière des indicateurs explicites, car elles ont encore besoin d’être éprouvées en conditions réelles avant de mériter une valeur par défaut stable ou un contrat public durable.
Traitez-les différemment de la configuration normale :
- Gardez-les désactivées par défaut, sauf si la documentation associée vous invite à en essayer une.
- Attendez-vous à ce que leur forme et leur comportement changent plus vite que ceux de la configuration stable.
- Préférez d’abord le chemin stable lorsqu’il en existe déjà un.
- Si vous déployez OpenClaw largement, testez les indicateurs expérimentaux dans un environnement plus petit avant de les intégrer à une base de référence partagée.
Indicateurs actuellement documentés
| Surface | Clé | Utilisez-le quand | Plus |
|---|---|---|---|
| Environnement d’exécution de modèle local | agents.defaults.experimental.localModelLean |
Un backend local plus petit ou plus strict ne parvient pas à gérer toute la surface d’outils par défaut d’OpenClaw | Modèles locaux |
| Recherche en mémoire | agents.defaults.memorySearch.experimental.sessionMemory |
Vous voulez que memory_search indexe les transcriptions des sessions précédentes et acceptez le coût supplémentaire de stockage et d’indexation |
Référence de configuration de la mémoire |
| Outil de planification structurée | tools.experimental.planTool |
Vous voulez exposer l’outil structuré update_plan pour le suivi du travail en plusieurs étapes dans les environnements d’exécution et interfaces utilisateur compatibles |
Référence de configuration du Gateway |
Mode allégé pour modèle local
agents.defaults.experimental.localModelLean: true est une soupape de décharge pour les configurations de modèles locaux moins puissantes. Lorsqu’il est activé, OpenClaw retire trois outils par défaut — browser, cron et message — de la surface d’outils de l’agent à chaque tour. Rien d’autre ne change.
Pourquoi ces trois outils
Ces trois outils ont les descriptions les plus longues et le plus grand nombre de formes de paramètres dans l’environnement d’exécution OpenClaw par défaut. Sur un backend compatible avec OpenAI à petit contexte ou plus strict, cela fait la différence entre :
- Des schémas d’outils qui tiennent proprement dans le prompt plutôt que de repousser l’historique de conversation.
- Le modèle qui choisit le bon outil plutôt que d’émettre des appels d’outil mal formés parce qu’il y a trop de schémas d’apparence similaire.
- L’adaptateur Chat Completions qui reste dans les limites de sortie structurée du serveur plutôt que de déclencher une erreur 400 sur la taille de la charge utile des appels d’outil.
Les retirer ne recâble pas OpenClaw silencieusement — cela raccourcit simplement la liste des outils. Le modèle dispose toujours de read, write, edit, exec, apply_patch, de la recherche/récupération web (lorsqu’elle est configurée), de la mémoire et des outils de session/agent.
Quand l’activer
Activez le mode allégé lorsque vous avez déjà prouvé que le modèle peut communiquer avec le Gateway, mais que les tours complets de l’agent se comportent mal. La chaîne de signaux typique est :
openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong"réussit.- Un tour d’agent normal échoue avec des appels d’outil mal formés, des prompts trop volumineux ou un modèle qui ignore ses outils.
- L’activation de
localModelLean: truecorrige l’échec.
Quand le laisser désactivé
Si votre backend gère proprement l’environnement d’exécution par défaut complet, laissez cette option désactivée. Le mode allégé est une solution de contournement, pas une valeur par défaut. Il existe parce que certaines piles locales ont besoin d’une surface d’outils plus petite pour se comporter correctement ; les modèles hébergés et les configurations locales bien dotées n’en ont pas besoin.
Le mode allégé ne remplace pas non plus tools.profile, tools.allow/tools.deny, ni l’issue de secours compat.supportsTools: false du modèle. Si vous avez besoin d’une surface d’outils plus étroite et permanente pour un agent spécifique, préférez ces réglages stables à l’indicateur expérimental.
Activer
{
agents: {
defaults: {
experimental: {
localModelLean: true,
},
},
},
}
Redémarrez le Gateway après avoir modifié l’indicateur, puis confirmez la liste d’outils réduite avec :
openclaw status --deep
La sortie d’état approfondi liste les outils d’agent actifs ; browser, cron et message doivent être absents lorsque le mode allégé est activé.
Expérimental ne signifie pas caché
Si une fonctionnalité est expérimentale, OpenClaw doit l’indiquer clairement dans la documentation et dans le chemin de configuration lui-même. Ce qu’il ne doit pas faire, c’est introduire discrètement un comportement d’aperçu dans un réglage qui semble stable et faire comme si c’était normal. C’est ainsi que les surfaces de configuration deviennent désordonnées.