Aller au contenu

Fonctionnalités expérimentales

Les fonctionnalités expérimentales dans OpenClaw sont des surfaces d’aperçu en option (opt-in). Elles se trouvent derrière des indicateurs explicites car elles ont encore besoin d’être testées en conditions réelles avant de mériter un paramètre 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 la forme et le comportement changent plus rapidement que pour la configuration stable.
  • Privilégiez d’abord le chemin stable lorsqu’il en existe déjà un.
  • Si vous déployez OpenClaw à grande échelle, testez les indicateurs expérimentaux dans un environnement plus restreint avant de les intégrer à une base de référence partagée.
SurfaceCléÀ utiliser quandEn savoir plus
Exécution de modèle localagents.defaults.experimental.localModelLean, agents.list[].experimental.localModelLeanUn backend local plus petit ou plus strict échoue avec la surface d’outil par défaut complète de OpenClawModèles locaux
Recherche mémoireagents.defaults.memorySearch.experimental.sessionMemoryVous voulez que memory_search indexe les transcriptions de session précédentes et acceptez le coût de stockage et d’indexation supplémentaireRéférence de configuration de la mémoire
Harnais Codexplugins.entries.codex.config.appServer.experimental.sandboxExecServerVous disposez d’un serveur d’application natif Codex 0.132.0 ou plus récent pour cibler un exec-server prenant en charge un bac à sable OpenClaw au lieu de désactiver le mode CodeRéférence du harnais Codex
Outil de planification structuréetools.experimental.planToolVous souhaitez que l’outil structuré update_plan soit exposé pour le suivi du travail en plusieurs étapes dans les environnements d’exécution et les interfaces utilisateur compatiblesRéférence de configuration de la Gateway

agents.defaults.experimental.localModelLean: true est une soupape de sécurité pour les configurations de modèles locaux plus faibles. Lorsqu’il est activé, OpenClaw supprime trois outils par défaut — browser, cron et message — de la surface d’outils de l’agent à chaque tour. Rien d’autre ne change. Utilisez agents.list[].experimental.localModelLean pour activer ou désactiver le même comportement pour un agent configuré.

Ces trois outils ont les descriptions les plus longues et le plus de formes de paramètres dans l’environnement d’exécution par défaut de OpenClaw. Sur un backend à petit contexte ou plus strict compatible avec OpenAI, c’est la différence entre :

  • Les schémas d’outils s’insérant proprement dans l’invite vs l’évincement de l’historique de la conversation.
  • Le modèle choisissant le bon outil vs émettant des appels d’outils malformés car il y a trop de schémas similaires.
  • L’adaptateur Chat Completions restant dans les limites de sortie structurée du serveur vs déclenchant une erreur 400 sur la taille de la charge utile de l’appel d’outil.

Les supprimer ne recâble pas silencieusement OpenClaw — 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.

Activez le mode lean lorsque vous avez déjà prouvé que le model peut parler au Gateway mais que les tours complets de l’agent se comportent mal. La chaîne de signal typique est :

  1. openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong" réussit.
  2. Un tour d’agent normal échoue avec des appels de tool malformés, des invites trop volumineuses, ou le model ignorant ses tools.
  3. Activer localModelLean: true résout l’échec.

Si votre backend gère proprement l’exécution par défaut complète, laissez ceci désactivé. Le mode lean est une solution de contournement, pas un paramètre par défaut. Il existe parce que certaines piles locales ont besoin d’une surface de tool plus petite pour bien fonctionner ; les modèles hébergés et les configurations locales bien dotées non.

Le mode lean ne remplace pas non plus tools.profile, tools.allow/tools.deny, ou la soupape de sécurité compat.supportsTools: false du model. Si vous avez besoin d’une surface de tool plus restreinte de manière permanente pour un agent spécifique, préférez ces boutons stables plutôt que l’indicateur expérimental.

{
agents: {
defaults: {
experimental: {
localModelLean: true,
},
},
},
}

Pour un seul agent :

{
agents: {
list: [
{
id: "local",
model: "lmstudio/gemma-4-e4b-it",
experimental: {
localModelLean: true,
},
},
],
},
}

Redémarrez le Gateway après avoir modifié l’indicateur, puis confirmez la liste des tools réduite avec :

Fenêtre de terminal
openclaw status --deep

La sortie de statut détaillé répertorie les tools de l’agent actifs ; browser, cron et message doivent être absents lorsque le mode lean est activé.

Si une fonctionnalité est expérimentale, OpenClaw doit le dire clairement dans la documentation et dans le chemin de configuration lui-même. Ce qu’il ne doit pas faire, c’est introduire subrepticement un comportement de prévisualisation dans un bouton par défaut d’apparence stable et faire semblant que c’est normal. C’est ainsi que les surfaces de configuration deviennent désordonnées.