Configuration — agents

Clés de configuration propres aux agents sous agents.*, multiAgent.*, session.*, messages.* et talk.*. Pour les canaux, les outils, l’exécution du Gateway et les autres clés de premier niveau, consultez la référence de configuration.

Valeurs par défaut des agents

agents.defaults.workspace

Valeur par défaut : OPENCLAW_WORKSPACE_DIR lorsqu’elle est définie, sinon ~/.openclaw/workspace (ou ~/.openclaw/workspace-<profile> lorsque OPENCLAW_PROFILE est défini sur un profil autre que celui par défaut).

{  agents: { defaults: { workspace: "~/.openclaw/workspace" } },}

Une valeur explicite de agents.defaults.workspace est prioritaire sur OPENCLAW_WORKSPACE_DIR. Utilisez la variable d’environnement pour faire pointer les agents par défaut vers un espace de travail monté lorsque vous ne souhaitez pas inscrire ce chemin dans la configuration.

agents.defaults.repoRoot

Racine de dépôt facultative affichée dans la ligne Runtime du prompt système. Si elle n’est pas définie, OpenClaw la détecte automatiquement en remontant depuis l’espace de travail.

{  agents: { defaults: { repoRoot: "~/Projects/openclaw" } },}

agents.defaults.skills

Liste d’autorisation de Skills par défaut facultative pour les agents qui ne définissent pas agents.list[].skills.

{  agents: {    defaults: { skills: ["github", "weather"] },    list: [      { id: "writer" }, // hérite de github, weather      { id: "docs", skills: ["docs-search"] }, // remplace les valeurs par défaut      { id: "locked-down", skills: [] }, // aucun skill    ],  },}

• Omettez agents.defaults.skills pour autoriser tous les Skills par défaut.
• Omettez agents.list[].skills pour hériter des valeurs par défaut.
• Définissez agents.list[].skills: [] pour n’autoriser aucun skill.
• Une liste agents.list[].skills non vide constitue l’ensemble final pour cet agent ; elle n’est pas fusionnée avec les valeurs par défaut.

agents.defaults.skipBootstrap

Désactive la création automatique des fichiers d’amorçage de l’espace de travail (AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md, HEARTBEAT.md, BOOTSTRAP.md).

{  agents: { defaults: { skipBootstrap: true } },}

agents.defaults.skipOptionalBootstrapFiles

Ignore la création de certains fichiers facultatifs de l’espace de travail tout en continuant à écrire les fichiers d’amorçage requis (AGENTS.md, TOOLS.md, BOOTSTRAP.md). Valeurs valides : SOUL.md, USER.md, HEARTBEAT.md et IDENTITY.md.

{  agents: {    defaults: {      skipOptionalBootstrapFiles: ["SOUL.md", "USER.md"],    },  },}

agents.defaults.contextInjection

Détermine quand les fichiers d’amorçage de l’espace de travail sont injectés dans le prompt système. Valeur par défaut : "always".

• "continuation-skip" : les tours de continuation sûrs (après une réponse terminée de l’assistant) ignorent la réinjection de l’amorçage de l’espace de travail, ce qui réduit la taille du prompt. Les exécutions Heartbeat et les nouvelles tentatives après Compaction reconstruisent toujours le contexte.
• "never" : désactive l’injection de l’amorçage de l’espace de travail et des fichiers de contexte à chaque tour. Utilisez cette option uniquement pour les agents qui gèrent entièrement le cycle de vie de leur prompt (moteurs de contexte personnalisés, environnements d’exécution natifs qui construisent leur propre contexte ou workflows spécialisés sans amorçage). Les tours Heartbeat et de récupération après Compaction ignorent également l’injection.

{  agents: { defaults: { contextInjection: "continuation-skip" } },}

Remplacement par agent : agents.list[].contextInjection. Les valeurs omises héritent de agents.defaults.contextInjection.

agents.defaults.bootstrapMaxChars

Nombre maximal de caractères par fichier d’amorçage de l’espace de travail avant troncature. Valeur par défaut : 20000.

{  agents: { defaults: { bootstrapMaxChars: 20000 } },}

Remplacement par agent : agents.list[].bootstrapMaxChars. Les valeurs omises héritent de agents.defaults.bootstrapMaxChars.

agents.defaults.bootstrapTotalMaxChars

Nombre total maximal de caractères injectés pour l’ensemble des fichiers d’amorçage de l’espace de travail. Valeur par défaut : 60000.

{  agents: { defaults: { bootstrapTotalMaxChars: 60000 } },}

Remplacement par agent : agents.list[].bootstrapTotalMaxChars. Les valeurs omises héritent de agents.defaults.bootstrapTotalMaxChars.

Remplacements du profil d’amorçage par agent

Utilisez les remplacements du profil d’amorçage par agent lorsqu’un agent requiert un comportement d’injection du prompt différent des valeurs par défaut partagées. Les champs omis héritent de agents.defaults.

{  agents: {    defaults: {      contextInjection: "continuation-skip",      bootstrapMaxChars: 20000,      bootstrapTotalMaxChars: 60000,    },    list: [      {        id: "strict-worker",        contextInjection: "always",        bootstrapMaxChars: 50000,        bootstrapTotalMaxChars: 300000,      },    ],  },}

agents.defaults.bootstrapPromptTruncationWarning

Contrôle l’avis visible par l’agent dans le prompt système lorsque le contexte d’amorçage est tronqué. Valeur par défaut : "always".

• "off" : n’injecte jamais de texte d’avis de troncature dans le prompt système.
• "once" : injecte une fois un avis concis pour chaque signature de troncature unique.
• "always" : injecte un avis concis à chaque exécution lorsqu’une troncature existe (recommandé).

Les décomptes bruts/injectés détaillés et les champs de réglage de la configuration restent dans les diagnostics tels que les rapports de contexte/d’état et les journaux ; le contexte utilisateur/d’exécution courant de WebChat ne reçoit que l’avis concis de récupération.

{  agents: { defaults: { bootstrapPromptTruncationWarning: "always" } }, // off | once | always}

Carte de responsabilité des budgets de contexte

OpenClaw comporte plusieurs budgets de prompt/contexte à volume élevé, qui sont intentionnellement répartis par sous-système plutôt que de passer tous par un unique paramètre générique.

Remplacements correspondants par agent :

• agents.list[].skillsLimits.maxSkillsPromptChars
• agents.list[].contextInjection
• agents.list[].bootstrapMaxChars
• agents.list[].bootstrapTotalMaxChars
• agents.list[].contextLimits.*

agents.defaults.startupContext

Contrôle le préambule de démarrage du premier tour injecté lors des exécutions du modèle après une réinitialisation ou au démarrage. Les commandes de chat seules /new et /reset confirment la réinitialisation sans invoquer le modèle ; elles ne chargent donc pas ce préambule.

{  agents: {    defaults: {      startupContext: {        enabled: true,        applyOn: ["new", "reset"],        dailyMemoryDays: 2,        maxFileBytes: 16384,        maxFileChars: 1200,        maxTotalChars: 2800,      },    },  },}

agents.defaults.contextLimits

Valeurs par défaut partagées pour les surfaces de contexte d’exécution bornées.

{  agents: {    defaults: {      contextLimits: {        memoryGetMaxChars: 12000,        memoryGetDefaultLines: 120,        postCompactionMaxChars: 1800,      },    },  },}

• memoryGetMaxChars : limite par défaut de l’extrait memory_get avant l’ajout des métadonnées de troncature et de l’avis de continuation.
• memoryGetDefaultLines : fenêtre de lignes par défaut de memory_get lorsque lines est omis.
• toolResultMaxChars : plafond avancé des résultats d’outils en direct, utilisé pour les résultats persistés et la récupération après dépassement. Laissez-le non défini pour utiliser la limite automatique du contexte du modèle : 16000 caractères en dessous de 100K jetons, 32000 caractères à partir de 100K jetons et 64000 caractères à partir de 200K jetons. Les valeurs explicites jusqu’à 1000000 sont acceptées pour les modèles à contexte long, mais la limite effective reste plafonnée à environ 30 % de la fenêtre de contexte du modèle. openclaw doctor --deep affiche la limite effective, et doctor n’émet un avertissement que lorsqu’un remplacement explicite est obsolète ou sans effet.
• postCompactionMaxChars : limite de l’extrait AGENTS.md utilisée lors de l’injection d’actualisation après Compaction.

agents.list[].contextLimits

Remplacement par agent des paramètres partagés contextLimits. Les champs omis héritent de agents.defaults.contextLimits.

{  agents: {    defaults: {      contextLimits: { memoryGetMaxChars: 12000 },    },    list: [      {        id: "tiny-local",        contextLimits: {          memoryGetMaxChars: 6000,          toolResultMaxChars: 8000, // plafond avancé pour cet agent        },      },    ],  },}

skills.limits.maxSkillsPromptChars

Limite globale de la liste compacte de Skills injectée dans le prompt système. Cela n’affecte pas la lecture à la demande des fichiers SKILL.md.

{  skills: { limits: { maxSkillsPromptChars: 18000 } },}

agents.list[].skillsLimits.maxSkillsPromptChars

Remplacement par agent du budget de prompt des Skills.

{  agents: {    list: [{ id: "tiny-local", skillsLimits: { maxSkillsPromptChars: 6000 } }],  },}

agents.defaults.imageMaxDimensionPx

Taille maximale en pixels du côté le plus long de l’image dans les blocs d’images de transcription/d’outil avant les appels au fournisseur. Valeur par défaut : 1200.

Des valeurs plus faibles réduisent généralement l’utilisation des jetons de vision et la taille de la charge utile des requêtes pour les exécutions riches en captures d’écran. Des valeurs plus élevées préservent davantage de détails visuels.

{  agents: { defaults: { imageMaxDimensionPx: 1200 } },}

agents.defaults.imageQuality

Préférence de compression/de niveau de détail de l’outil d’image pour les images chargées depuis des chemins de fichiers, des URL et des références de médias. Valeur par défaut : auto.

OpenClaw adapte la progression de redimensionnement au modèle d’image sélectionné. Par exemple, Claude Opus 4.8, OpenAI GPT-5.6 Sol, Qwen VL et les modèles de vision Llama 4 hébergés peuvent utiliser des images plus grandes que les anciens chemins de vision à haut niveau de détail ou ceux par défaut, tandis que les tours comportant plusieurs images sont compressés plus agressivement en mode auto afin de maîtriser le coût en jetons et la latence.

Valeurs :

• auto : s’adapte aux limites du modèle et au nombre d’images.
• efficient : privilégie des images plus petites pour réduire l’utilisation de jetons et d’octets.
• balanced : utilise la progression intermédiaire standard.
• high : préserve davantage de détails pour les captures d’écran, les diagrammes et les images de documents.

{  agents: { defaults: { imageQuality: "auto" } },}

agents.defaults.userTimezone

Fuseau horaire du contexte du prompt système (et non des horodatages des messages). Utilise le fuseau horaire de l’hôte par défaut.

{  agents: { defaults: { userTimezone: "America/Chicago" } },}

agents.defaults.timeFormat

Format de l’heure dans le prompt système. Valeur par défaut : auto (préférence du système d’exploitation).

{  agents: { defaults: { timeFormat: "auto" } }, // auto | 12 | 24}

agents.defaults.model

{  agents: {    defaults: {      models: {        "anthropic/claude-opus-4-6": { alias: "opus" },        "minimax/MiniMax-M2.7": { alias: "minimax" },      },      model: {        primary: "anthropic/claude-opus-4-6",        fallbacks: ["minimax/MiniMax-M2.7"],      },      utilityModel: "openai/gpt-5.4-mini",      imageModel: {        primary: "openrouter/qwen/qwen-2.5-vl-72b-instruct:free",        fallbacks: ["openrouter/google/gemini-2.0-flash-vision:free"],      },      imageGenerationModel: {        primary: "openai/gpt-image-2",        fallbacks: ["google/gemini-3.1-flash-image-preview"],      },      videoGenerationModel: {        primary: "qwen/wan2.6-t2v",        fallbacks: ["qwen/wan2.6-i2v"],      },      pdfModel: {        primary: "anthropic/claude-opus-4-6",        fallbacks: ["openai/gpt-5.4-mini"],      },      params: { cacheRetention: "long" }, // paramètres globaux par défaut du fournisseur      pdfMaxBytesMb: 10,      pdfMaxPages: 20,      thinkingDefault: "low",      verboseDefault: "off",      toolProgressDetail: "explain",      reasoningDefault: "off",      elevatedDefault: "on",      timeoutSeconds: 600,      mediaMaxMb: 5,      contextTokens: 200000,      maxConcurrent: 4,    },  },}

• model : accepte soit une chaîne ("provider/model"), soit un objet ({ primary, fallbacks }).
  • La forme chaîne définit uniquement le modèle principal.
  • La forme objet définit le modèle principal ainsi que les modèles de secours ordonnés.
• utilityModel : référence provider/model ou alias facultatif pour les courtes tâches internes. Il est actuellement utilisé pour générer les titres de session de l’interface de contrôle, les titres de sujets de messages privés Telegram, les titres automatiques de fils Discord et la narration des brouillons de progression. Lorsqu’il n’est pas défini, OpenClaw utilise le petit modèle par défaut déclaré par le fournisseur principal, s’il en existe un (OpenAI → gpt-5.6-luna, Anthropic → claude-haiku-4-5) ; sinon, les tâches de génération de titres se rabattent sur le modèle principal de l’agent, tandis que la narration reste désactivée. Définissez utilityModel: "" pour désactiver entièrement le routage des tâches utilitaires. agents.list[].utilityModel remplace la valeur par défaut (une valeur vide propre à un agent le désactive pour cet agent), et un remplacement de modèle propre à une opération prévaut sur les deux. Les tâches utilitaires effectuent des appels de modèle distincts et envoient au fournisseur de modèle sélectionné du contenu propre à la tâche. La génération de titres du tableau de bord envoie au maximum les 1 000 premiers caractères du premier message qui n’est pas une commande ; la narration envoie la requête entrante ainsi que des résumés compacts et expurgés des outils. Choisissez un fournisseur adapté à vos exigences de coût et de traitement des données.
• imageModel : accepte soit une chaîne ("provider/model"), soit un objet ({ primary, fallbacks }).
  • Utilisé par le chemin de l’outil image comme configuration de son modèle de vision.
  • Également utilisé comme routage de secours lorsque le modèle sélectionné ou par défaut ne peut pas accepter d’image en entrée.
  • Privilégiez les références provider/model explicites. Les identifiants seuls sont acceptés pour compatibilité ; si un identifiant seul correspond de manière unique à une entrée configurée compatible avec les images dans models.providers.*.models, OpenClaw le qualifie avec ce fournisseur. Les correspondances configurées ambiguës nécessitent un préfixe de fournisseur explicite.
• imageGenerationModel : accepte soit une chaîne ("provider/model"), soit un objet ({ primary, fallbacks }).
  • Utilisé par la fonctionnalité partagée de génération d’images et toute future surface d’outil ou de Plugin générant des images.
  • Valeurs courantes : google/gemini-3.1-flash-image-preview pour la génération d’images native de Gemini, fal/fal-ai/flux/dev pour fal, openai/gpt-image-2 pour OpenAI Images ou openai/gpt-image-1.5 pour une sortie OpenAI PNG/WebP avec arrière-plan transparent.
  • Si vous sélectionnez directement un fournisseur/modèle, configurez également l’authentification correspondante du fournisseur (par exemple GEMINI_API_KEY ou GOOGLE_API_KEY pour google/*, OPENAI_API_KEY ou OAuth OpenAI Codex pour openai/gpt-image-2 / openai/gpt-image-1.5, FAL_KEY pour fal/*).
  • En cas d’omission, image_generate peut toujours déduire un fournisseur par défaut disposant d’une authentification. Il essaie d’abord le fournisseur par défaut actuel, puis les autres fournisseurs de génération d’images enregistrés, dans l’ordre de leur identifiant.
• musicGenerationModel : accepte soit une chaîne ("provider/model"), soit un objet ({ primary, fallbacks }).
  • Utilisé par la fonctionnalité partagée de génération musicale et l’outil intégré music_generate.
  • Valeurs courantes : google/lyria-3-clip-preview, google/lyria-3-pro-preview ou minimax/music-2.6.
  • En cas d’omission, music_generate peut toujours déduire un fournisseur par défaut disposant d’une authentification. Il essaie d’abord le fournisseur par défaut actuel, puis les autres fournisseurs de génération musicale enregistrés, dans l’ordre de leur identifiant.
  • Si vous sélectionnez directement un fournisseur/modèle, configurez également l’authentification ou la clé d’API correspondante du fournisseur.
• videoGenerationModel : accepte soit une chaîne ("provider/model"), soit un objet ({ primary, fallbacks }).
  • Utilisé par la fonctionnalité partagée de génération vidéo et l’outil intégré video_generate.
  • Valeurs courantes : qwen/wan2.6-t2v, qwen/wan2.6-i2v, qwen/wan2.6-r2v, qwen/wan2.6-r2v-flash ou qwen/wan2.7-r2v.
  • En cas d’omission, video_generate peut toujours déduire un fournisseur par défaut disposant d’une authentification. Il essaie d’abord le fournisseur par défaut actuel, puis les autres fournisseurs de génération vidéo enregistrés, dans l’ordre de leur identifiant.
  • Si vous sélectionnez directement un fournisseur/modèle, configurez également l’authentification ou la clé d’API correspondante du fournisseur.
  • Le Plugin officiel de génération vidéo Qwen prend en charge jusqu’à 1 vidéo de sortie, 1 image d’entrée, 4 vidéos d’entrée, une durée de 10 secondes, ainsi que les options de niveau fournisseur size, aspectRatio, resolution, audio et watermark.
• pdfModel : accepte soit une chaîne ("provider/model"), soit un objet ({ primary, fallbacks }).
  • Utilisé par l’outil pdf pour le routage du modèle.
  • En cas d’omission, l’outil PDF se rabat sur imageModel, puis sur le modèle résolu de la session ou le modèle par défaut.
• pdfMaxBytesMb : limite de taille PDF par défaut pour l’outil pdf lorsque maxBytesMb n’est pas transmis au moment de l’appel.
• pdfMaxPages : nombre maximal de pages prises en compte par défaut par le mode de secours d’extraction de l’outil pdf.
• verboseDefault : niveau de verbosité par défaut des agents. Valeurs : "off", "on", "full". Valeur par défaut : "off".
• toolProgressDetail : mode de détail des résumés d’outils de /verbose et des lignes d’outils des brouillons de progression. Valeurs : "explain" (par défaut, libellés humains compacts) ou "raw" (ajoute la commande ou les détails bruts lorsqu’ils sont disponibles). La valeur agents.list[].toolProgressDetail propre à un agent remplace cette valeur par défaut.
• reasoningDefault : visibilité du raisonnement par défaut pour les agents. Valeurs : "off", "on", "stream". La valeur agents.list[].reasoningDefault propre à un agent remplace cette valeur par défaut. Les valeurs de raisonnement par défaut configurées ne sont appliquées qu’aux propriétaires, aux expéditeurs autorisés ou aux contextes d’administration opérateur du Gateway lorsqu’aucun remplacement du raisonnement propre au message ou à la session n’est défini.
• elevatedDefault : niveau de sortie élevée par défaut pour les agents. Valeurs : "off", "on", "ask", "full". Valeur par défaut : "on".
• model.primary : format provider/model (par exemple openai/gpt-5.6-sol pour l’accès OAuth Codex). Si vous omettez le fournisseur, OpenClaw essaie d’abord un alias, puis une correspondance unique parmi les fournisseurs configurés pour cet identifiant de modèle exact, et ne se rabat qu’ensuite sur le fournisseur par défaut configuré (comportement de compatibilité obsolète ; privilégiez donc un provider/model explicite). Si ce fournisseur n’expose plus le modèle par défaut configuré, OpenClaw se rabat sur le premier fournisseur/modèle configuré au lieu de signaler une valeur par défaut obsolète provenant d’un fournisseur supprimé.
• models : catalogue de modèles configuré et liste d’autorisation pour /model. Chaque entrée peut inclure alias (raccourci) et params (propres au fournisseur, par exemple temperature, maxTokens, cacheRetention, context1m, responsesServerCompaction, responsesCompactThreshold, le routage OpenRouter provider, chat_template_kwargs, extra_body/extraBody).
  • Utilisez des entrées provider/* telles que "openai/*": {} ou "vllm/*": {} pour afficher tous les modèles découverts des fournisseurs sélectionnés sans répertorier manuellement chaque identifiant de modèle.
  • Ajoutez agentRuntime à une entrée provider/* lorsque tous les modèles découverts dynamiquement pour ce fournisseur doivent utiliser le même environnement d’exécution. La politique d’environnement d’exécution exacte provider/model prévaut toujours sur le caractère générique.
  • Modifications sûres : utilisez openclaw config set agents.defaults.models '<json>' --strict-json --merge pour ajouter des entrées. config set refuse les remplacements qui supprimeraient des entrées existantes de la liste d’autorisation, sauf si vous transmettez --replace.
  • Les flux de configuration ou d’intégration propres à un fournisseur fusionnent les modèles du fournisseur sélectionné dans cette table et préservent les autres fournisseurs déjà configurés.
  • Pour les modèles directs OpenAI Responses, la Compaction côté serveur est activée automatiquement. Utilisez params.responsesServerCompaction: false pour ne plus injecter context_management, ou params.responsesCompactThreshold pour remplacer le seuil. Consultez Compaction OpenAI côté serveur.
• params : paramètres globaux par défaut du fournisseur appliqués à tous les modèles. À définir dans agents.defaults.params (par exemple { cacheRetention: "long" }).
• Priorité de fusion de params (configuration) : agents.defaults.params (base globale) est remplacé par agents.defaults.models["provider/model"].params (par modèle), puis agents.list[].params (identifiant d’agent correspondant) remplace les valeurs par clé. Consultez Mise en cache des invites pour plus de détails.
• models.providers.openrouter.params.provider : politique de routage des fournisseurs par défaut à l’échelle d’OpenRouter. OpenClaw la transmet à l’objet provider de la requête OpenRouter ; agents.defaults.models["openrouter/<model>"].params.provider par modèle et les paramètres de l’agent remplacent les valeurs par clé. Consultez Routage des fournisseurs OpenRouter.
• params.extra_body/params.extraBody : objet JSON avancé transmis tel quel et fusionné dans les corps de requête api: "openai-completions" pour les proxys compatibles avec OpenAI. En cas de conflit avec des clés de requête générées, le corps supplémentaire prévaut ; les routes de complétion non natives suppriment néanmoins ensuite la clé store propre à OpenAI.
• params.chat_template_kwargs : arguments de modèle de discussion compatibles avec vLLM/OpenAI fusionnés dans les corps de requête api: "openai-completions" de premier niveau. Pour vllm/nemotron-3-* avec le raisonnement désactivé, le Plugin vLLM intégré envoie automatiquement enable_thinking: false et force_nonempty_content: true ; les valeurs chat_template_kwargs explicites remplacent les valeurs générées par défaut, et extra_body.chat_template_kwargs conserve la priorité finale. Les modèles de raisonnement Qwen et Nemotron vLLM configurés proposent des choix /think binaires (off, on) au lieu de l’échelle d’effort à plusieurs niveaux.
• compat.thinkingFormat : style de charge utile de raisonnement compatible avec OpenAI. Utilisez "together" pour reasoning.enabled au format Together, "qwen" pour enable_thinking au premier niveau au format Qwen, ou "qwen-chat-template" pour chat_template_kwargs.enable_thinking sur les systèmes dorsaux de la famille Qwen prenant en charge les arguments de modèle de discussion au niveau de la requête, comme vLLM. OpenClaw associe le raisonnement désactivé à false et le raisonnement activé à true, et les modèles Qwen vLLM configurés proposent des choix /think binaires pour ces formats.
• compat.supportedReasoningEfforts : liste des niveaux d’effort de raisonnement compatibles avec OpenAI par modèle. Incluez "xhigh" pour les points de terminaison personnalisés qui l’acceptent réellement ; OpenClaw expose alors /think xhigh dans les menus de commandes, les lignes de session du Gateway, la validation des modifications de session, la validation de la CLI de l’agent et la validation de llm-task pour ce fournisseur/modèle configuré. Utilisez compat.reasoningEffortMap lorsque le système dorsal attend une valeur propre au fournisseur pour un niveau canonique.
• params.preserveThinking : activation facultative, propre à Z.AI, de la conservation du raisonnement. Lorsqu’elle est activée et que le raisonnement est actif, OpenClaw envoie thinking.clear_thinking: false et rejoue le contenu reasoning_content antérieur ; consultez Raisonnement Z.AI et conservation du raisonnement.
• localService : gestionnaire de processus facultatif au niveau du fournisseur pour les serveurs de modèles locaux ou auto-hébergés. Lorsque le modèle sélectionné appartient à ce fournisseur, OpenClaw sonde healthUrl (ou baseUrl + "/models"), lance command avec args si le point de terminaison est indisponible, attend jusqu’à readyTimeoutMs, puis envoie la requête au modèle. command doit être un chemin absolu. idleStopMs: 0 maintient le processus actif jusqu’à la fermeture d’OpenClaw ; une valeur positive arrête le processus lancé par OpenClaw après ce nombre de millisecondes d’inactivité. Consultez Services de modèles locaux.
• La politique d’environnement d’exécution appartient aux fournisseurs ou aux modèles, et non à agents.defaults. Utilisez models.providers.<provider>.agentRuntime pour les règles à l’échelle du fournisseur ou agents.defaults.models["provider/model"].agentRuntime / agents.list[].models["provider/model"].agentRuntime pour les règles propres au modèle. Un préfixe fournisseur/modèle ne sélectionne jamais à lui seul un harnais. Lorsque l’environnement d’exécution n’est pas défini ou vaut auto, OpenAI peut sélectionner implicitement Codex uniquement pour une route officielle HTTPS Platform Responses ou ChatGPT Responses exacte, sans remplacement de requête défini par l’utilisateur. Consultez Environnement d’exécution implicite de l’agent OpenAI.
• Les outils d’écriture de configuration qui modifient ces champs (par exemple /models set, /models set-image et les commandes d’ajout ou de suppression de modèles de secours) enregistrent la forme objet canonique et préservent les listes de modèles de secours existantes lorsque cela est possible.
• maxConcurrent : nombre maximal d’exécutions d’agents en parallèle entre les sessions (chaque session reste traitée en série). Valeur par défaut : 4.

Politique d’environnement d’exécution

{  models: {    providers: {      openai: {        agentRuntime: { id: "codex" },      },    },  },  agents: {    defaults: {      model: "openai/gpt-5.6-sol",      models: {        "anthropic/claude-opus-4-8": {          agentRuntime: { id: "claude-cli" },        },        "vllm/*": {          agentRuntime: { id: "openclaw" },        },      },    },  },}

• id : "auto", "openclaw", l’identifiant d’un environnement d’exécution de Plugin enregistré ou l’alias d’un backend CLI pris en charge. Le Plugin Codex intégré enregistre codex ; le Plugin Anthropic intégré fournit le backend CLI claude-cli.
• id: "auto" permet aux environnements d’exécution de Plugin enregistrés de prendre en charge les routes effectives qui déclarent ou satisfont autrement leur contrat de prise en charge, et utilise OpenClaw lorsqu’aucun environnement ne correspond. Un environnement d’exécution de Plugin explicite tel que id: "codex" exige cet environnement ainsi qu’une route effective compatible ; il échoue de manière fermée si l’un des deux est indisponible ou si l’exécution échoue.
• id: "pi" est accepté uniquement comme alias obsolète de openclaw afin de préserver les configurations publiées avec v2026.5.22 et les versions antérieures. Les nouvelles configurations doivent utiliser openclaw.
• La priorité des environnements d’exécution est d’abord la stratégie du modèle exact (agents.list[].models["provider/model"], agents.defaults.models["provider/model"] ou models.providers.<provider>.models[]), puis agents.list[] / agents.defaults.models["provider/*"], et enfin la stratégie globale du fournisseur dans models.providers.<provider>.agentRuntime.
• Les clés d’environnement d’exécution couvrant l’agent entier sont héritées. agents.defaults.agentRuntime, agents.list[].agentRuntime, les environnements d’exécution épinglés aux sessions et OPENCLAW_AGENT_RUNTIME sont ignorés lors de la sélection de l’environnement d’exécution. Exécutez openclaw doctor --fix pour supprimer les valeurs obsolètes.
• Les routes officielles HTTPS OpenAI Responses/ChatGPT exactes et admissibles, sans remplacement explicite dans la requête, peuvent utiliser implicitement l’environnement Codex. La valeur fournisseur/modèle agentRuntime.id: "codex" fait de Codex une exigence à échec fermé, mais ne rend pas compatible une route incompatible.
• Pour les déploiements Claude CLI, privilégiez model: "anthropic/claude-opus-4-8" avec agentRuntime.id: "claude-cli" limité au modèle. Les références héritées claude-cli/<model> fonctionnent encore à des fins de compatibilité, mais les nouvelles configurations doivent conserver une sélection fournisseur/modèle canonique et placer le backend d’exécution dans la stratégie d’environnement d’exécution du fournisseur/modèle.
• Cela contrôle uniquement l’exécution des tours d’agent textuels. La génération de médias, la vision, les PDF, la musique, la vidéo et la synthèse vocale utilisent toujours leurs paramètres de fournisseur/modèle.

Raccourcis d’alias intégrés (s’appliquent uniquement lorsque le modèle figure dans agents.defaults.models) :

Vos alias configurés ont toujours priorité sur les valeurs par défaut.

Les modèles Z.AI GLM-4.x activent automatiquement le mode de réflexion, sauf si vous définissez --thinking off ou agents.defaults.models["zai/<model>"].params.thinking vous-même. Les modèles Z.AI activent tool_stream par défaut pour la diffusion en continu des appels d’outils. Définissez agents.defaults.models["zai/<model>"].params.tool_stream sur false pour le désactiver. Anthropic Claude Opus 4.8 conserve la réflexion désactivée par défaut dans OpenClaw ; lorsque la réflexion adaptative est explicitement activée, la valeur d’effort par défaut gérée par le fournisseur Anthropic est high. Les modèles Claude 4.6 utilisent par défaut adaptive lorsqu’aucun niveau de réflexion explicite n’est défini.

agents.defaults.cliBackends

Backends CLI facultatifs pour les exécutions de secours textuelles uniquement (sans appels d’outils). Utiles comme solution de repli lorsque les fournisseurs d’API échouent.

{  agents: {    defaults: {      cliBackends: {        "claude-cli": {          command: "/opt/homebrew/bin/claude",        },        "my-cli": {          command: "my-cli",          args: ["--json"],          output: "json",          modelArg: "--model",          sessionArg: "--session",          sessionMode: "existing",          systemPromptArg: "--system",          // Vous pouvez aussi utiliser systemPromptFileArg lorsque la CLI accepte un indicateur de fichier d’invite.          systemPromptWhen: "first",          imageArg: "--image",          imageMode: "repeat",        },      },    },  },}

• Les backends CLI privilégient le texte ; les outils sont toujours désactivés.
• Les sessions sont prises en charge lorsque sessionArg est défini.
• La transmission directe des images est prise en charge lorsque imageArg accepte des chemins de fichiers.
• reseedFromRawTranscriptWhenUncompacted: true permet à un backend de restaurer des sessions invalidées de manière sûre à partir d’une fin bornée de transcription brute OpenClaw avant l’existence du premier résumé de Compaction. Les changements de profil d’authentification ou d’époque des identifiants ne déclenchent toujours jamais de réamorçage à partir des données brutes.

agents.defaults.promptOverlays

Surcouches d’invite indépendantes du fournisseur, appliquées par famille de modèles aux surfaces d’invite assemblées par OpenClaw. Les identifiants de modèles de la famille GPT-5 reçoivent le contrat de comportement partagé sur les routes OpenClaw/fournisseur ; personality contrôle uniquement la couche de style d’interaction conviviale. Les routes natives du serveur d’application Codex conservent les instructions de base et de modèle gérées par Codex au lieu de cette surcouche GPT-5 d’OpenClaw, et OpenClaw désactive la personnalité intégrée de Codex pour les fils natifs.

{  agents: {    defaults: {      promptOverlays: {        gpt5: {          personality: "friendly", // friendly | on | off        },      },    },  },}

• "friendly" (valeur par défaut) et "on" activent la couche de style d’interaction conviviale.
• "off" désactive uniquement la couche conviviale ; le contrat de comportement GPT-5 balisé reste activé.
• La valeur héritée plugins.entries.openai.config.personality est encore lue lorsque ce paramètre partagé n’est pas défini.

agents.defaults.heartbeat

Exécutions périodiques de Heartbeat.

{  agents: {    defaults: {      heartbeat: {        every: "30m", // 0m désactive        model: "openai/gpt-5.4-mini",        includeReasoning: false,        includeSystemPromptSection: true, // valeur par défaut : true ; false omet la section Heartbeat de l’invite système        lightContext: false, // valeur par défaut : false ; true conserve uniquement HEARTBEAT.md parmi les fichiers d’amorçage de l’espace de travail        isolatedSession: false, // valeur par défaut : false ; true exécute chaque Heartbeat dans une nouvelle session (sans historique de conversation)        skipWhenBusy: false, // valeur par défaut : false ; true attend également les voies de sous-agent/imbriquées de cet agent        session: "main",        to: "+15555550123",        directPolicy: "allow", // allow (valeur par défaut) | block        target: "none", // valeur par défaut : none | options : last | whatsapp | telegram | discord | ...        prompt: "Lisez HEARTBEAT.md s’il existe...",        ackMaxChars: 300,        suppressToolErrorWarnings: false,        timeoutSeconds: 45,      },    },  },}

• every : chaîne de durée (ms/s/m/h). Valeur par défaut : 30m (authentification par clé d’API) ou 1h (authentification OAuth). Définissez-la sur 0m pour désactiver.
• includeSystemPromptSection : lorsque la valeur est false, omet la section Heartbeat de l’invite système et ignore l’injection de HEARTBEAT.md dans le contexte d’amorçage. Valeur par défaut : true.
• suppressToolErrorWarnings : lorsque la valeur est true, supprime les charges utiles d’avertissement d’erreur d’outil pendant les exécutions de Heartbeat.
• timeoutSeconds : durée maximale, en secondes, autorisée pour un tour d’agent Heartbeat avant son abandon. Laissez cette option non définie pour utiliser agents.defaults.timeoutSeconds lorsqu’elle est définie, sinon la cadence du Heartbeat plafonnée à 600 secondes.
• directPolicy : stratégie de livraison directe/par message privé. allow (valeur par défaut) autorise la livraison vers une cible directe. block supprime la livraison vers une cible directe et émet reason=dm-blocked.
• lightContext : lorsque la valeur est true, les exécutions de Heartbeat utilisent un contexte d’amorçage léger et conservent uniquement HEARTBEAT.md parmi les fichiers d’amorçage de l’espace de travail.
• isolatedSession : lorsque la valeur est true, chaque Heartbeat s’exécute dans une nouvelle session sans historique de conversation antérieur. Même modèle d’isolation que Cron avec sessionTarget: "isolated". Réduit le coût en jetons par Heartbeat d’environ 100K à environ 2-5K jetons.
• skipWhenBusy : lorsque la valeur est true, les exécutions de Heartbeat sont différées en fonction des voies occupées supplémentaires de cet agent : le travail de sous-agent indexé par sa propre clé de session ou le travail de commande imbriqué. Les voies Cron diffèrent toujours les Heartbeats, même sans cet indicateur.
• Par agent : définissez agents.list[].heartbeat. Lorsqu’un agent définit heartbeat, seuls ces agents exécutent des Heartbeats.
• Les Heartbeats exécutent des tours d’agent complets — des intervalles plus courts consomment davantage de jetons.

agents.defaults.compaction

{  agents: {    defaults: {      compaction: {        mode: "safeguard", // default | safeguard        provider: "my-provider", // identifiant d’un Plugin de fournisseur de Compaction enregistré (facultatif)        timeoutSeconds: 180,        reserveTokensFloor: 24000,        keepRecentTokens: 50000,        recentTurnsPreserve: 3,        maxHistoryShare: 0.7,        identifierPolicy: "strict", // strict | off | custom        identifierInstructions: "Conservez exactement les identifiants de déploiement, les identifiants de ticket et les paires hôte:port.", // utilisé lorsque identifierPolicy=custom        qualityGuard: { enabled: true, maxRetries: 1 },        midTurnPrecheck: { enabled: false }, // vérification facultative de la pression dans la boucle d’outils        postIndexSync: "async", // off | async | await        postCompactionSections: ["Session Startup", "Red Lines"], // permet d’activer la réinjection de sections d’AGENTS.md        model: "openrouter/anthropic/claude-sonnet-4-6", // remplacement facultatif du modèle réservé à la Compaction        truncateAfterCompaction: true, // effectue une rotation vers un successeur JSONL plus petit après la Compaction        maxActiveTranscriptBytes: "20mb", // déclencheur local facultatif de Compaction préalable        notifyUser: true, // signale le début/la fin de la Compaction et la dégradation du vidage de la mémoire (valeur par défaut : false)        memoryFlush: {          enabled: true,          model: "ollama/qwen3:8b", // remplacement facultatif du modèle réservé au vidage de la mémoire          softThresholdTokens: 6000,          forceFlushTranscriptBytes: "2mb",          systemPrompt: "La session approche de la Compaction. Stockez maintenant les souvenirs durables.",          prompt: "Écrivez toute note durable dans memory/YYYY-MM-DD.md ; répondez avec le jeton silencieux exact NO_REPLY s’il n’y a rien à stocker.",        },      },    },  },}

• mode : default ou safeguard (résumé par segments pour les historiques longs). Consultez Compaction.
• provider : identifiant d’un Plugin de fournisseur de Compaction enregistré. Lorsqu’il est défini, la méthode summarize() du fournisseur est appelée à la place du résumé intégré par LLM. En cas d’échec, le résumé intégré est utilisé. Définir un fournisseur impose mode: "safeguard". Consultez Compaction.
• timeoutSeconds : nombre maximal de secondes autorisé pour une seule opération de Compaction avant qu’OpenClaw ne l’interrompe. Valeur par défaut : 180.
• reserveTokens : marge de jetons conservée pour la sortie du modèle et les futurs résultats d’outils après la Compaction. Lorsque la fenêtre de contexte du modèle est connue, OpenClaw plafonne la réserve effective afin qu’elle ne puisse pas consommer le budget de l’invite.
• reserveTokensFloor : réserve minimale imposée par le runtime intégré. Définissez-la sur 0 pour désactiver ce minimum. Ce minimum reste soumis au plafond de la fenêtre de contexte active.
• keepRecentTokens : budget du point de coupure de l’agent permettant de conserver textuellement la partie la plus récente de la transcription. La commande manuelle /compact le respecte lorsqu’il est explicitement défini ; sinon, la Compaction manuelle constitue un point de contrôle strict.
• recentTurnsPreserve : nombre de tours utilisateur/assistant les plus récents conservés textuellement hors du résumé de sauvegarde. Valeur par défaut : 3.
• maxHistoryShare : fraction maximale du budget de contexte total autorisée pour l’historique conservé après la Compaction (plage 0.1-0.9).
• identifierPolicy : strict (par défaut), off ou custom. strict ajoute au début des instructions intégrées pour la conservation des identifiants opaques pendant le résumé de Compaction.
• identifierInstructions : texte personnalisé facultatif de conservation des identifiants, utilisé lorsque identifierPolicy=custom.
• qualityGuard : contrôles avec nouvelle tentative en cas de sortie mal formée pour les résumés de sauvegarde. Activés par défaut en mode sauvegarde ; définissez enabled: false pour ignorer l’audit.
• midTurnPrecheck : contrôle facultatif de la pression exercée sur la boucle d’outils. Lorsque enabled: true, OpenClaw vérifie la pression sur le contexte après l’ajout des résultats d’outils et avant l’appel suivant au modèle. Si le contexte ne tient plus, il interrompt la tentative en cours avant de soumettre l’invite et réutilise le chemin de récupération existant de la vérification préalable pour tronquer les résultats d’outils ou effectuer une Compaction et réessayer. Fonctionne avec les modes de Compaction default et safeguard. Valeur par défaut : désactivé.
• postIndexSync : mode de réindexation de la mémoire de session après la Compaction. Valeur par défaut : "async". Utilisez "await" pour une actualité maximale, "async" pour réduire la latence de Compaction, ou "off" uniquement lorsque la synchronisation de la mémoire de session est gérée ailleurs.
• postCompactionSections : noms facultatifs de sections H2/H3 d’AGENTS.md à réinjecter après la Compaction. La réinjection est désactivée lorsque cette option n’est pas définie ou vaut []. Définir explicitement ["Session Startup", "Red Lines"] active cette paire et conserve le mécanisme de repli historique Every Session/Safety. N’activez cette option que lorsque le contexte supplémentaire justifie le risque de dupliquer les directives du projet déjà intégrées au résumé de Compaction.
• model : provider/model-id facultatif ou alias simple issu de agents.defaults.models, uniquement pour le résumé de Compaction. Les alias simples sont résolus avant l’envoi ; les identifiants de modèle littéraux configurés restent prioritaires en cas de collision. Utilisez cette option lorsque la session principale doit conserver un modèle, mais que les résumés de Compaction doivent s’exécuter sur un autre ; lorsqu’elle n’est pas définie, la Compaction utilise le modèle principal de la session.
• truncateAfterCompaction : fait pivoter la transcription de la session active après la Compaction afin que les tours futurs ne chargent que le résumé et la partie non résumée, tandis que la transcription complète précédente reste archivée. Empêche la croissance illimitée de la transcription active dans les sessions de longue durée. Valeur par défaut : false.
• maxActiveTranscriptBytes : seuil facultatif en octets (number ou chaînes telles que "20mb") qui déclenche une Compaction locale normale avant une exécution lorsque l’historique de transcription dépasse le seuil. Nécessite truncateAfterCompaction afin qu’une Compaction réussie puisse effectuer une rotation vers une transcription suivante plus petite. Désactivé lorsqu’il n’est pas défini ou vaut 0.
• notifyUser : lorsque cette option vaut true, envoie à l’utilisateur de brèves notifications de maintenance du contexte : au début et à la fin de la Compaction (par exemple, « Compaction du contexte... » et « Compaction terminée »), ainsi que lorsqu’un vidage de mémoire préalable à la Compaction est épuisé et que la réponse se poursuit dans un état dégradé (par exemple, « La maintenance de la mémoire a temporairement échoué ; poursuite de votre réponse. »). Désactivé par défaut afin de ne pas afficher ces notifications.
• memoryFlush : tour agentique silencieux avant la Compaction automatique afin de stocker les souvenirs durables. Définissez model sur un fournisseur/modèle exact, tel que ollama/qwen3:8b, lorsque ce tour de maintenance doit rester sur un modèle local ; le remplacement n’hérite pas de la chaîne de repli de la session active. forceFlushTranscriptBytes force le vidage lorsque la taille de la transcription atteint le seuil, même si les compteurs de jetons sont obsolètes. Ignoré lorsque l’espace de travail est en lecture seule.

agents.defaults.runRetries

Limites d’itérations de nouvelle tentative de la boucle d’exécution externe pour le runtime d’agent intégré, afin d’empêcher les boucles d’exécution infinies pendant la récupération après un échec. Ce paramètre s’applique uniquement au runtime d’agent intégré, et non aux runtimes ACP ou CLI.

{  agents: {    defaults: {      runRetries: {        base: 24,        perProfile: 8,        min: 32,        max: 160,      },    },    list: [      {        id: "main",        runRetries: { max: 50 }, // remplacements facultatifs par agent      },    ],  },}

• base : nombre de base d’itérations de nouvelle tentative pour la boucle d’exécution externe. Valeur par défaut : 24.
• perProfile : itérations supplémentaires de nouvelle tentative accordées par profil de repli candidat. Valeur par défaut : 8.
• min : limite absolue minimale d’itérations de nouvelle tentative. Valeur par défaut : 32.
• max : limite absolue maximale d’itérations de nouvelle tentative afin d’empêcher une exécution incontrôlée. Valeur par défaut : 160.

agents.defaults.contextPruning

Élague les anciens résultats d’outils du contexte en mémoire avant l’envoi au LLM. Ne modifie pas l’historique de session sur le disque. Désactivé par défaut ; définissez mode: "cache-ttl" pour l’activer.

{  agents: {    defaults: {      contextPruning: {        mode: "cache-ttl", // désactivé (par défaut) | cache-ttl        ttl: "1h", // durée (ms/s/m/h), unité par défaut : minutes ; valeur par défaut : 5m        keepLastAssistants: 3,        softTrimRatio: 0.3,        hardClearRatio: 0.5,        minPrunableToolChars: 50000,        softTrim: { maxChars: 4000, headChars: 1500, tailChars: 1500 },        hardClear: { enabled: true, placeholder: "[Contenu de l’ancien résultat d’outil effacé]" },        tools: { deny: ["browser", "canvas"] },      },    },  },}

Consultez Élagage de session pour plus de détails sur le comportement.

Diffusion par blocs

{  agents: {    defaults: {      blockStreamingDefault: "off", // on | off      blockStreamingBreak: "text_end", // text_end | message_end      blockStreamingChunk: { minChars: 800, maxChars: 1200, breakPreference: "paragraph" },      blockStreamingCoalesce: { idleMs: 1000 },      humanDelay: { mode: "natural" }, // off (par défaut) | natural | custom (utilise minMs/maxMs)    },  },}

• Les canaux autres que Telegram nécessitent explicitement *.blockStreaming: true pour activer les réponses par blocs.
• Remplacements par canal : channels.<channel>.blockStreamingCoalesce (ainsi que les variantes par compte). Discord, Google Chat, Mattermost, MS Teams, Signal et Slack utilisent par défaut minChars: 1500 / idleMs: 1000.
• blockStreamingChunk.breakPreference : limite de segment privilégiée ("paragraph" | "newline" | "sentence").
• humanDelay : pause aléatoire entre les réponses par blocs. Valeur par défaut : off. natural = 800-2500ms. custom utilise minMs/maxMs (avec repli sur la plage naturelle pour toute limite non définie). Remplacement par agent : agents.list[].humanDelay.

Consultez Diffusion pour plus de détails sur le comportement et la segmentation.

Indicateurs de saisie

{  agents: {    defaults: {      typingMode: "instant", // never | instant | thinking | message      typingIntervalSeconds: 6,    },  },}

• Valeurs par défaut : instant pour les discussions directes/mentions, message pour les discussions de groupe sans mention.
• Valeur par défaut de typingIntervalSeconds : 6.
• Remplacements par session : session.typingMode, session.typingIntervalSeconds.

Consultez Indicateurs de saisie.

agents.defaults.sandbox

Mise en bac à sable facultative pour l’agent intégré. Consultez Mise en bac à sable pour le guide complet.

{  agents: {    defaults: {      sandbox: {        mode: "non-main", // off (par défaut) | non-main | all        backend: "docker", // docker (par défaut) | ssh | openshell        scope: "agent", // session | agent (par défaut) | shared        workspaceAccess: "none", // none (par défaut) | ro | rw        workspaceRoot: "~/.openclaw/sandboxes",        docker: {          image: "openclaw-sandbox:bookworm-slim",          containerPrefix: "openclaw-sbx-",          workdir: "/workspace",          readOnlyRoot: true,          tmpfs: ["/tmp", "/var/tmp", "/run"],          network: "none",          user: "1000:1000",          capDrop: ["ALL"],          env: { LANG: "C.UTF-8" },          setupCommand: "apt-get update && apt-get install -y git curl jq",          pidsLimit: 256,          memory: "1g",          memorySwap: "2g",          cpus: 1,          gpus: "all",          ulimits: {            nofile: { soft: 1024, hard: 2048 },            nproc: 256,          },          seccompProfile: "/path/to/seccomp.json",          apparmorProfile: "openclaw-sandbox",          dns: ["1.1.1.1", "8.8.8.8"],          extraHosts: ["internal.service:10.0.0.5"],          binds: ["/home/user/source:/source:rw"],        },        ssh: {          target: "user@gateway-host:22",          command: "ssh",          workspaceRoot: "/tmp/openclaw-sandboxes",          strictHostKeyChecking: true,          updateHostKeys: true,          identityFile: "~/.ssh/id_ed25519",          certificateFile: "~/.ssh/id_ed25519-cert.pub",          knownHostsFile: "~/.ssh/known_hosts",          // SecretRefs / contenu intégré également pris en charge :          // identityData: { source: "env", provider: "default", id: "SSH_IDENTITY" },          // certificateData: { source: "env", provider: "default", id: "SSH_CERTIFICATE" },          // knownHostsData: { source: "env", provider: "default", id: "SSH_KNOWN_HOSTS" },        },        browser: {          enabled: false,          image: "openclaw-sandbox-browser:bookworm-slim",          network: "openclaw-sandbox-browser",          cdpPort: 9222,          cdpSourceRange: "172.21.0.1/32",          vncPort: 5900,          noVncPort: 6080,          headless: false,          enableNoVnc: true,          allowHostControl: false,          autoStart: true,          autoStartTimeoutMs: 12000,        },        prune: {          idleHours: 24,          maxAgeDays: 7,        },      },    },  },  tools: {    sandbox: {      tools: {        allow: [          "exec",          "process",          "read",          "write",          "edit",          "apply_patch",          "sessions_list",          "sessions_history",          "sessions_send",          "sessions_spawn",          "session_status",        ],        deny: ["browser", "canvas", "nodes", "cron", "discord", "gateway"],      },    },  },}

Les valeurs par défaut indiquées ci-dessus (image off/docker/agent/none/bookworm-slim, réseau none, etc.) sont les véritables valeurs par défaut d’OpenClaw, et non de simples exemples.

{plugins: {  entries: {    openshell: {      enabled: true,      config: {        mode: "mirror", // mirror (par défaut) | remote        command: "openshell",        from: "openclaw",        remoteWorkspaceDir: "/sandbox",        remoteAgentWorkspaceDir: "/agent",        gateway: "lab", // facultatif        gatewayEndpoint: "https://lab.example", // facultatif        policy: "strict", // identifiant de stratégie OpenShell facultatif        providers: ["openai"], // facultatif        autoProviders: true,        timeoutSeconds: 120,      },    },  },},}

La mise en bac à sable du navigateur et sandbox.docker.binds sont uniquement disponibles avec Docker.

Construisez les images (depuis une copie de travail des sources) :

scripts/sandbox-setup.sh           # image principale du bac à sablescripts/sandbox-browser-setup.sh   # image facultative du navigateur

Pour les installations npm sans copie de travail des sources, consultez Mise en bac à sable § Images et configuration pour les commandes docker build intégrées.

agents.list (remplacements propres à chaque agent)

Utilisez agents.list[].tts pour attribuer à un agent son propre fournisseur TTS, sa propre voix, son propre modèle, son propre style ou son propre mode TTS automatique. Le bloc de l’agent est fusionné récursivement avec la configuration globale messages.tts, afin que les identifiants partagés puissent rester regroupés tandis que chaque agent remplace uniquement les champs de voix ou de fournisseur dont il a besoin. Le remplacement de l’agent actif s’applique aux réponses vocales automatiques, à /tts audio, à /tts status et à l’outil d’agent tts. Consultez Synthèse vocale pour obtenir des exemples de fournisseurs et connaître l’ordre de priorité.

{  agents: {    list: [      {        id: "main",        default: true,        name: "Main Agent",        workspace: "~/.openclaw/workspace",        agentDir: "~/.openclaw/agents/main/agent",        model: "anthropic/claude-opus-4-6", // ou { primary, fallbacks }        utilityModel: "openai/gpt-5.4-mini",        thinkingDefault: "high", // remplacement du niveau de réflexion propre à l’agent        reasoningDefault: "on", // remplacement de la visibilité du raisonnement propre à l’agent        fastModeDefault: false, // remplacement du mode rapide propre à l’agent        params: { cacheRetention: "none" }, // remplace par clé les paramètres correspondants de defaults.models        tts: {          providers: {            elevenlabs: { speakerVoiceId: "EXAVITQu4vr4xnSDxMaL" },          },        },        skills: ["docs-search"], // remplace agents.defaults.skills lorsqu’il est défini        identity: {          name: "Samantha",          theme: "paresseux serviable",          emoji: "🦥",          avatar: "avatars/samantha.png",        },        groupChat: { mentionPatterns: ["@openclaw"] },        sandbox: { mode: "off" },        runtime: {          type: "acp",          acp: {            agent: "codex",            backend: "acpx",            mode: "persistent", // persistent | oneshot            cwd: "/workspace/openclaw",          },        },        subagents: { allowAgents: ["*"] },        tools: {          profile: "coding",          allow: ["browser"],          deny: ["canvas"],          elevated: { enabled: true },        },      },    ],  },}

• id : identifiant stable de l’agent (obligatoire).
• default : lorsque plusieurs valeurs sont définies, la première l’emporte (un avertissement est consigné). Si aucune n’est définie, la première entrée de la liste est utilisée par défaut.
• model : la forme chaîne définit un modèle principal strict par agent, sans modèle de secours ; la forme objet { primary } est également stricte, sauf si vous ajoutez fallbacks. Utilisez { primary, fallbacks: [...] } pour activer les modèles de secours pour cet agent, ou { primary, fallbacks: [] } pour rendre explicite le comportement strict. Les tâches Cron qui remplacent uniquement primary héritent toujours des modèles de secours par défaut, sauf si vous définissez fallbacks: [].
• utilityModel : remplacement facultatif par agent pour les courtes tâches internes, telles que la génération des titres de session et de fil de discussion. Utilise en secours agents.defaults.utilityModel, puis le petit modèle par défaut déclaré par le fournisseur principal, puis le modèle principal de cet agent. Une chaîne vide désactive le routage utilitaire pour cet agent.
• params : paramètres de flux par agent fusionnés par-dessus l’entrée du modèle sélectionné dans agents.defaults.models. Utilisez-les pour les remplacements propres à un agent, tels que cacheRetention, temperature ou maxTokens, sans dupliquer l’intégralité du catalogue de modèles.
• tts : remplacements facultatifs de synthèse vocale par agent. Le bloc est fusionné en profondeur par-dessus messages.tts ; conservez donc les identifiants du fournisseur et la stratégie de secours partagés dans messages.tts, et ne définissez ici que les valeurs propres au personnage, telles que le fournisseur, la voix, le modèle, le style ou le mode automatique.
• skills : liste d’autorisation facultative de Skills par agent. Si elle est omise, l’agent hérite de agents.defaults.skills lorsque cette valeur est définie ; une liste explicite remplace les valeurs par défaut au lieu de les fusionner, et [] signifie qu’aucune Skills n’est disponible.
• thinkingDefault : niveau de réflexion par défaut facultatif pour chaque agent (off | minimal | low | medium | high | xhigh | adaptive | max). Remplace agents.defaults.thinkingDefault pour cet agent lorsqu’aucun remplacement n’est défini au niveau du message ou de la session. Le profil de fournisseur/modèle sélectionné détermine les valeurs valides ; pour Google Gemini, adaptive conserve la réflexion dynamique gérée par le fournisseur (thinkingLevel omis sur Gemini 3/3.1, thinkingBudget: -1 sur Gemini 2.5).
• reasoningDefault : visibilité par défaut facultative du raisonnement pour chaque agent (on | off | stream). Remplace agents.defaults.reasoningDefault pour cet agent lorsqu’aucun remplacement du raisonnement n’est défini au niveau du message ou de la session.
• fastModeDefault : valeur par défaut facultative du mode rapide pour chaque agent ("auto" | true | false). S’applique lorsqu’aucun remplacement du mode rapide n’est défini au niveau du message ou de la session.
• models : remplacements facultatifs du catalogue de modèles et de l’environnement d’exécution par agent, indexés par les identifiants provider/model complets. Utilisez models["provider/model"].agentRuntime pour les exceptions d’environnement d’exécution propres à un agent.
• runtime : descripteur facultatif de l’environnement d’exécution par agent. Utilisez type: "acp" avec les valeurs par défaut de runtime.acp (agent, backend, mode, cwd) lorsque l’agent doit utiliser par défaut des sessions de harnais ACP.
• identity.avatar : chemin relatif à l’espace de travail, URL http(s) ou URI data:.
• Les fichiers image locaux identity.avatar relatifs à l’espace de travail sont limités à 2 MB. Les URL http(s) et les URI data: ne sont pas soumises à la limite de taille des fichiers locaux.
• identity déduit des valeurs par défaut : ackReaction à partir de emoji, et mentionPatterns à partir de name/emoji.
• subagents.allowAgents : liste d’autorisation des identifiants d’agents configurés pour les cibles explicites sessions_spawn.agentId (["*"] = toute cible configurée ; valeur par défaut : le même agent uniquement). Incluez l’identifiant du demandeur lorsque les appels agentId ciblant ce même agent doivent être autorisés. Les entrées obsolètes dont la configuration d’agent a été supprimée sont rejetées par sessions_spawn et omises de agents_list ; exécutez openclaw doctor --fix pour les nettoyer, ou ajoutez une entrée minimale agents.list[] si cette cible doit rester instanciable tout en héritant des valeurs par défaut.
• Protection de l’héritage du bac à sable : si la session du demandeur est isolée dans un bac à sable, sessions_spawn rejette les cibles qui s’exécuteraient sans bac à sable.
• subagents.requireAgentId : lorsque la valeur est vraie, bloque les appels sessions_spawn qui omettent agentId (impose une sélection explicite du profil ; valeur par défaut : faux).
• subagents.maxConcurrent : nombre maximal d’exécutions simultanées d’agents enfants pour l’ensemble de l’exécution des sous-agents. Valeur par défaut : 8.
• subagents.maxChildrenPerAgent : nombre maximal d’enfants actifs qu’une même session d’agent peut instancier. Valeur par défaut : 5.
• subagents.maxSpawnDepth : profondeur maximale d’imbrication pour l’instanciation de sous-agents (1-5). Valeur par défaut : 1 (aucune imbrication).
• subagents.archiveAfterMinutes : délai avant l’archivage de l’état d’un sous-agent terminé. Valeur par défaut : 60.

Routage multi-agent

Exécutez plusieurs agents isolés dans un même Gateway. Consultez Multi-Agent.

{  agents: {    list: [      { id: "home", default: true, workspace: "~/.openclaw/workspace-home" },      { id: "work", workspace: "~/.openclaw/workspace-work" },    ],  },  bindings: [    { agentId: "home", match: { channel: "whatsapp", accountId: "personal" } },    { agentId: "work", match: { channel: "whatsapp", accountId: "biz" } },  ],}

Champs de correspondance des liaisons

• type (facultatif) : route pour le routage normal (si le type est absent, la valeur par défaut est route), acp pour les liaisons persistantes de conversations ACP.
• match.channel (obligatoire)
• match.accountId (facultatif ; * = tout compte ; valeur omise = compte par défaut)
• match.peer (facultatif ; { kind: direct|group|channel, id })
• match.guildId / match.teamId (facultatif ; propre au canal)
• acp (facultatif ; uniquement pour type: "acp") : { mode, label, cwd, backend }

Ordre de correspondance déterministe :

1. match.peer
2. match.guildId
3. match.teamId
4. match.accountId (correspondance exacte, sans pair/guilde/équipe)
5. match.accountId: "*" (à l’échelle du canal)
6. Agent par défaut

Dans chaque niveau, la première entrée correspondante de bindings l’emporte.

Pour les entrées type: "acp", OpenClaw effectue la résolution selon l’identité exacte de la conversation (match.channel + compte + match.peer.id) et n’utilise pas l’ordre des niveaux de liaison de routage ci-dessus.

Profils d’accès par agent

{agents: {  list: [    {      id: "personal",      workspace: "~/.openclaw/workspace-personal",      sandbox: { mode: "off" },    },  ],},}

{agents: {  list: [    {      id: "family",      workspace: "~/.openclaw/workspace-family",      sandbox: { mode: "all", scope: "agent", workspaceAccess: "ro" },      tools: {        allow: [          "read",          "sessions_list",          "sessions_history",          "sessions_send",          "sessions_spawn",          "session_status",        ],        deny: ["write", "edit", "apply_patch", "exec", "process", "browser"],      },    },  ],},}

{agents: {  list: [    {      id: "public",      workspace: "~/.openclaw/workspace-public",      sandbox: { mode: "all", scope: "agent", workspaceAccess: "none" },      tools: {        allow: [          "sessions_list",          "sessions_history",          "sessions_send",          "sessions_spawn",          "session_status",          "whatsapp",          "telegram",          "slack",          "discord",          "gateway",        ],        deny: [          "read",          "write",          "edit",          "apply_patch",          "exec",          "process",          "browser",          "canvas",          "nodes",          "cron",          "gateway",          "image",        ],      },    },  ],},}

Consultez Bac à sable et outils multi-agents pour en savoir plus sur les règles de priorité.

Session

{  session: {    scope: "per-sender",    dmScope: "main", // main | per-peer | per-channel-peer | per-account-channel-peer    identityLinks: {      alice: ["telegram:123456789", "discord:987654321012345678"],    },    reset: {      mode: "daily", // daily | idle      atHour: 4,      idleMinutes: 60,    },    resetByType: {      thread: { mode: "daily", atHour: 4 },      direct: { mode: "idle", idleMinutes: 240 },      group: { mode: "idle", idleMinutes: 120 },    },    resetByChannel: {      discord: { mode: "idle", idleMinutes: 30 },    },    resetTriggers: ["/new", "/reset"],    store: "~/.openclaw/agents/{agentId}/sessions/sessions.json",    maintenance: {      mode: "enforce", // enforce (par défaut) | warn      pruneAfter: "30d",      maxEntries: 500,      resetArchiveRetention: "30d", // durée ou false      maxDiskBytes: "500mb", // plafond strict facultatif      highWaterBytes: "400mb", // cible de nettoyage facultative    },    writeLock: {      acquireTimeoutMs: 60000,      staleMs: 1800000,      maxHoldMs: 300000,    },    threadBindings: {      enabled: true,      idleHours: 24, // désactivation automatique par défaut après une inactivité exprimée en heures (`0` désactive cette fonction)      maxAgeHours: 0, // âge maximal strict par défaut en heures (`0` désactive cette fonction)    },    mainKey: "main", // hérité (l’environnement d’exécution utilise toujours "main")    agentToAgent: { maxPingPongTurns: 5 },    sendPolicy: {      rules: [{ action: "deny", match: { channel: "discord", chatType: "group" } }],      default: "allow",    },  },}

Messages

{  messages: {    responsePrefix: "🦞", // ou "auto"    ackReaction: "👀",    ackReactionScope: "group-mentions", // group-mentions | group-all | direct | all | off | none    removeAckAfterReply: false,    queue: {      mode: "steer", // steer (par défaut) | followup | collect | interrupt      debounceMs: 500,      cap: 20,      drop: "summarize", // old | new | summarize (par défaut)      byChannel: {        whatsapp: "followup",        telegram: "followup",      },    },    inbound: {      debounceMs: 2000, // 0 désactive cette fonction      byChannel: {        whatsapp: 5000,        slack: 1500,      },    },  },}

Préfixe de réponse

Remplacements par canal/compte : channels.<channel>.responsePrefix, channels.<channel>.accounts.<id>.responsePrefix.

Résolution (la valeur la plus spécifique l’emporte) : compte → canal → global. "" désactive la fonction et interrompt la cascade. "auto" produit [{identity.name}].

Variables du modèle :

Les variables sont insensibles à la casse. {think} est un alias de {thinkingLevel}.

Réaction d’accusé de réception

• Utilise par défaut la valeur identity.emoji de l’agent actif, ou "👀" à défaut. Définissez "" pour désactiver cette fonction.
• Remplacements par canal : channels.<channel>.ackReaction, channels.<channel>.accounts.<id>.ackReaction.
• Ordre de résolution : compte → canal → messages.ackReaction → valeur de repli de l’identité.
• Portée : group-mentions (par défaut), group-all, direct, all ou off/none (désactive entièrement les réactions d’accusé de réception).
• removeAckAfterReply : supprime l’accusé de réception après la réponse sur les canaux prenant en charge les réactions, tels que Slack, Discord, Signal, Telegram, WhatsApp et iMessage.
• messages.statusReactions.enabled : active les réactions d’état du cycle de vie sur Slack, Discord, Signal, Telegram et WhatsApp. Sur Discord, l’absence de valeur maintient les réactions d’état activées lorsque les réactions d’accusé de réception sont actives. Sur Slack, Signal, Telegram et WhatsApp, définissez-la explicitement sur true pour activer les réactions d’état du cycle de vie. Par défaut, Slack utilise son état natif de fil d’assistant ainsi que des messages de chargement alternés pour indiquer la progression, tout en conservant statique la réaction d’accusé de réception configurée.
• messages.statusReactions.emojis : remplace les clés d’émoji du cycle de vie : queued, thinking, compacting, tool, coding, web, deploy, build, concierge, done, error, stallSoft et stallHard. Telegram n’autorise qu’un ensemble fixe de réactions ; les émojis configurés qui ne sont pas pris en charge utilisent donc la variante d’état prise en charge la plus proche pour cette discussion.

File d’attente

• mode : stratégie de file d’attente pour les messages entrants qui arrivent pendant l’exécution active d’une session. Valeur par défaut : "steer".
  • steer : injecte la nouvelle invite dans l’exécution active.
  • followup : exécute la nouvelle invite une fois l’exécution active terminée.
  • collect : regroupe les messages compatibles et les exécute ensemble ultérieurement.
  • interrupt : interrompt l’exécution active avant de lancer l’invite la plus récente.
• debounceMs : délai avant l’envoi d’un message mis en file d’attente ou injecté. Valeur par défaut : 500.
• cap : nombre maximal de messages en file d’attente avant l’application de la stratégie d’abandon. Valeur par défaut : 20.
• drop : stratégie appliquée lorsque la limite est dépassée. "summarize" (par défaut) abandonne les entrées les plus anciennes, mais conserve des résumés compacts ; "old" abandonne les plus anciennes sans résumé ; "new" rejette l’élément le plus récent.
• byChannel : remplacements de mode par canal, indexés par identifiant de fournisseur.
• debounceMsByChannel : remplacements de debounceMs par canal, indexés par identifiant de fournisseur.

Temporisation des messages entrants

Regroupe les messages rapides ne contenant que du texte et provenant du même expéditeur en un seul tour d’agent. Les médias/pièces jointes déclenchent immédiatement l’envoi. Les commandes de contrôle contournent la temporisation. Valeur par défaut de debounceMs : 2000.

Autres clés de message

• messages.messagePrefix : texte de préfixe ajouté aux messages utilisateur entrants avant qu’ils n’atteignent l’environnement d’exécution de l’agent. À utiliser avec parcimonie pour les marqueurs de contexte de canal.
• messages.visibleReplies : contrôle les réponses sources visibles dans les conversations directes, de groupe et de canal ("message_tool" exige message(action=send) pour produire une sortie visible ; "automatic" publie les réponses normales comme auparavant).
• messages.usageTemplate / messages.responseUsage : modèle personnalisé de pied de page /usage et mode d’utilisation par défaut pour chaque réponse (off | tokens | full, ainsi que l’ancien alias on de tokens).
• messages.groupChat.mentionPatterns / historyLimit : déclencheurs de mention dans les messages de groupe et dimensionnement de la fenêtre d’historique.
• messages.suppressToolErrors : lorsque défini sur true, masque les avertissements d’erreur d’outil ⚠️ affichés à l’utilisateur (l’agent voit toujours les erreurs dans le contexte et peut réessayer). Valeur par défaut : false.

TTS (synthèse vocale)

{  messages: {    tts: {      auto: "off", // off (par défaut) | always | inbound | tagged      mode: "final", // final | all      provider: "elevenlabs",      summaryModel: "openai/gpt-5.4-mini",      modelOverrides: { enabled: true },      maxTextLength: 4000,      timeoutMs: 30000,      prefsPath: "~/.openclaw/settings/tts.json",      providers: {        elevenlabs: {          apiKey: "elevenlabs_api_key",          baseUrl: "https://api.elevenlabs.io",          speakerVoiceId: "voice_id",          modelId: "eleven_multilingual_v2",          seed: 42,          applyTextNormalization: "auto",          languageCode: "en",          voiceSettings: {            stability: 0.5,            similarityBoost: 0.75,            style: 0.0,            useSpeakerBoost: true,            speed: 1.0,          },        },        microsoft: {          speakerVoice: "en-US-MichelleNeural",          lang: "en-US",          outputFormat: "audio-24khz-48kbitrate-mono-mp3",        },        openai: {          apiKey: "openai_api_key",          baseUrl: "https://api.openai.com/v1",          model: "gpt-4o-mini-tts",          speakerVoice: "coral",        },      },    },  },}

• auto contrôle le mode TTS automatique par défaut : off, always, inbound ou tagged. /tts on|off peut remplacer les préférences locales, et /tts status affiche l’état effectif.
• summaryModel remplace agents.defaults.model.primary pour le résumé automatique.
• modelOverrides est activé par défaut (enabled !== false) ; modelOverrides.allowProvider est facultatif.
• Les clés d’API utilisent par défaut ELEVENLABS_API_KEY/XI_API_KEY et OPENAI_API_KEY.
• Les fournisseurs de synthèse vocale intégrés appartiennent à des plugins. Si plugins.allow est défini, incluez chaque plugin de fournisseur TTS que vous souhaitez utiliser, par exemple microsoft pour Edge TTS. L’ancien identifiant de fournisseur edge est accepté comme alias de microsoft.
• providers.openai.baseUrl remplace le point de terminaison TTS d’OpenAI. L’ordre de résolution est la configuration, puis OPENAI_TTS_BASE_URL, puis https://api.openai.com/v1.
• Lorsque providers.openai.baseUrl pointe vers un point de terminaison autre qu’OpenAI, OpenClaw le traite comme un serveur TTS compatible avec OpenAI et assouplit la validation du modèle et de la voix.

Conversation

Valeurs par défaut du mode Conversation (macOS/iOS/Android et interface utilisateur de contrôle dans le navigateur).

{  talk: {    provider: "elevenlabs",    providers: {      elevenlabs: {        speakerVoiceId: "elevenlabs_voice_id",        voiceAliases: {          Clawd: "EXAVITQu4vr4xnSDxMaL",          Roger: "CwhRBWXzGAHq8TQ4Fs17",        },        modelId: "eleven_multilingual_v2",        outputFormat: "mp3_44100_128",        apiKey: "elevenlabs_api_key",      },      mlx: {        modelId: "mlx-community/Soprano-80M-bf16",      },      system: {},    },    consultThinkingLevel: "low",    consultFastMode: true,    speechLocale: "ru-RU",    silenceTimeoutMs: 1500,    interruptOnSpeech: true,    realtime: {      provider: "openai",      providers: {        openai: {          model: "gpt-realtime-2.1",          speakerVoice: "cedar",        },      },      instructions: "Parlez chaleureusement et donnez des réponses brèves.",      mode: "realtime", // realtime | stt-tts | transcription      transport: "webrtc", // webrtc | provider-websocket | gateway-relay | managed-room      vadThreshold: 0.5,      silenceDurationMs: 500,      prefixPaddingMs: 300,      reasoningEffort: "medium",      brain: "agent-consult", // agent-consult | direct-tools | none    },  },}

• talk.provider doit correspondre à une clé dans talk.providers lorsque plusieurs fournisseurs Talk sont configurés.
• Les anciennes clés Talk plates (talk.voiceId, talk.voiceAliases, talk.modelId, talk.outputFormat, talk.apiKey) sont réservées à la compatibilité. Exécutez openclaw doctor --fix pour réécrire la configuration persistée dans talk.providers.<provider>.
• Les identifiants vocaux se replient sur ELEVENLABS_VOICE_ID ou SAG_VOICE_ID (comportement du client Talk sous macOS).
• providers.*.apiKey accepte des chaînes en texte brut ou des objets SecretRef.
• Le repli ELEVENLABS_API_KEY s’applique uniquement lorsqu’aucune clé d’API Talk n’est configurée.
• providers.*.voiceAliases permet aux directives Talk d’utiliser des noms conviviaux.
• providers.mlx.modelId sélectionne le dépôt Hugging Face utilisé par l’assistant MLX local de macOS. En cas d’omission, macOS utilise mlx-community/Soprano-80M-bf16.
• La lecture MLX sous macOS passe par l’assistant openclaw-mlx-tts inclus lorsqu’il est présent, ou par un exécutable dans PATH ; OPENCLAW_MLX_TTS_BIN remplace le chemin de l’assistant pour le développement.
• consultThinkingLevel contrôle le niveau de réflexion pour l’exécution complète de l’agent OpenClaw derrière les appels openclaw_agent_consult en temps réel de Talk dans l’interface de contrôle. Laissez cette option non définie pour préserver le comportement normal de la session et du modèle.
• consultFastMode définit un remplacement ponctuel du mode rapide pour les consultations en temps réel de Talk dans l’interface de contrôle, sans modifier le réglage normal du mode rapide de la session.
• speechLocale définit l’identifiant de paramètres régionaux BCP 47 utilisé par la reconnaissance vocale Talk sous iOS/macOS. Laissez cette option non définie pour utiliser la valeur par défaut de l’appareil.
• silenceTimeoutMs contrôle la durée pendant laquelle le mode Talk attend après le silence de l’utilisateur avant d’envoyer la transcription. Une valeur non définie conserve la fenêtre de pause par défaut de la plateforme (700 ms on macOS and Android, 900 ms on iOS).
• realtime.instructions ajoute des instructions système destinées au fournisseur à l’invite en temps réel intégrée d’OpenClaw, afin de permettre la configuration du style vocal sans perdre les consignes openclaw_agent_consult par défaut.
• realtime.vadThreshold définit le seuil d’activité vocale du fournisseur, de 0 (sensibilité maximale) à 1 (sensibilité minimale). Une valeur non définie conserve la valeur par défaut du fournisseur.
• realtime.silenceDurationMs définit la fenêtre de silence, exprimée sous forme de nombre entier positif, avant que le fournisseur ne valide une intervention utilisateur en temps réel. Une valeur non définie conserve la valeur par défaut du fournisseur.
• realtime.prefixPaddingMs définit la quantité d’audio, exprimée sous forme de nombre entier non négatif, conservée avant le début de la parole détectée. Une valeur non définie conserve la valeur par défaut du fournisseur.
• realtime.reasoningEffort définit le niveau de raisonnement propre au fournisseur pour les sessions en temps réel. Une valeur non définie conserve la valeur par défaut du fournisseur.
• realtime.consultRouting : "provider-direct" (valeur par défaut) préserve les réponses directes du fournisseur lorsque le fournisseur en temps réel produit une transcription utilisateur finale sans openclaw_agent_consult. "force-agent-consult" achemine plutôt la requête finalisée via OpenClaw.

Pages connexes

• Référence de configuration — toutes les autres clés de configuration
• Configuration — tâches courantes et configuration rapide
• Exemples de configuration