Configuratie — agenten

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Standaardwaarden voor agents

​

agents.defaults.workspace

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

​

agents.defaults.repoRoot

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

​

agents.defaults.skills

{
  agents: {
    defaults: { skills: ["github", "weather"] },
    list: [
      { id: "writer" }, // inherits github, weather
      { id: "docs", skills: ["docs-search"] }, // replaces defaults
      { id: "locked-down", skills: [] }, // no skills
    ],
  },
}

• Laat agents.defaults.skills weg voor standaard onbeperkte Skills.
• Laat agents.list[].skills weg om de standaardwaarden te erven.
• Stel agents.list[].skills: [] in voor geen Skills.
• Een niet-lege lijst agents.list[].skills is de definitieve set voor die agent; deze wordt niet samengevoegd met standaardwaarden.

​

agents.defaults.skipBootstrap

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

​

agents.defaults.contextInjection

• "continuation-skip": veilige vervolgbeurten (na een voltooide assistentreactie) slaan herinjectie van de workspace-bootstrap over, waardoor de promptgrootte afneemt. Heartbeat-runs en nieuwe pogingen na Compaction bouwen de context nog steeds opnieuw op.
• "never": schakel workspace-bootstrap en injectie van contextbestanden op elke beurt uit. Gebruik dit alleen voor agents die hun promptlevenscyclus volledig zelf beheren (aangepaste context-engines, native runtimes die hun eigen context bouwen, of gespecialiseerde workflows zonder bootstrap). Heartbeat- en Compaction-herstelbeurten slaan injectie ook over.

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

​

agents.defaults.bootstrapMaxChars

{
  agents: { defaults: { bootstrapMaxChars: 12000 } },
}

​

agents.defaults.bootstrapTotalMaxChars

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

​

agents.defaults.bootstrapPromptTruncationWarning

• "off": injecteer nooit waarschuwingstekst in de systeemprompt.
• "once": injecteer de waarschuwing eenmaal per unieke afkappingshandtekening (aanbevolen).
• "always": injecteer bij elke run een waarschuwing wanneer er afkapping bestaat.

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

​

Eigendomskaart voor contextbudgetten

• agents.defaults.bootstrapMaxChars / agents.defaults.bootstrapTotalMaxChars: normale injectie van workspace-bootstrap.
• agents.defaults.startupContext.*: eenmalige prelude voor reset-/startup-modelruns, inclusief recente dagelijkse memory/*.md-bestanden. Kale chatopdrachten /new en /reset worden bevestigd zonder het model aan te roepen.
• skills.limits.*: de compacte Skills-lijst die in de systeemprompt wordt geïnjecteerd.
• agents.defaults.contextLimits.*: begrensde runtime-fragmenten en geïnjecteerde blokken die eigendom zijn van de runtime.
• memory.qmd.limits.*: snippet voor geïndexeerde geheugenzoekopdrachten en injectiegrootte.

• agents.list[].skillsLimits.maxSkillsPromptChars
• agents.list[].contextLimits.*

​

agents.defaults.startupContext

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

​

agents.defaults.contextLimits

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

• memoryGetMaxChars: standaardlimiet voor memory_get-fragmenten voordat afkappingsmetadata en een vervolgmelding worden toegevoegd.
• memoryGetDefaultLines: standaardregelvenster voor memory_get wanneer lines is weggelaten.
• toolResultMaxChars: limiet voor live toolresultaten die wordt gebruikt voor opgeslagen resultaten en overloopherstel.
• postCompactionMaxChars: fragmentlimiet voor AGENTS.md die wordt gebruikt tijdens refresh-injectie na Compaction.

​

agents.list[].contextLimits

{
  agents: {
    defaults: {
      contextLimits: {
        memoryGetMaxChars: 12000,
        toolResultMaxChars: 16000,
      },
    },
    list: [
      {
        id: "tiny-local",
        contextLimits: {
          memoryGetMaxChars: 6000,
          toolResultMaxChars: 8000,
        },
      },
    ],
  },
}

​

skills.limits.maxSkillsPromptChars

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

​

agents.list[].skillsLimits.maxSkillsPromptChars

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

​

agents.defaults.imageMaxDimensionPx

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

​

agents.defaults.userTimezone

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

​

agents.defaults.timeFormat

{
  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"],
      },
      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" }, // global default provider params
      agentRuntime: {
        id: "pi", // pi | auto | registered harness id, e.g. codex
        fallback: "pi", // pi | none
      },
      pdfMaxBytesMb: 10,
      pdfMaxPages: 20,
      thinkingDefault: "low",
      verboseDefault: "off",
      reasoningDefault: "off",
      elevatedDefault: "on",
      timeoutSeconds: 600,
      mediaMaxMb: 5,
      contextTokens: 200000,
      maxConcurrent: 3,
    },
  },
}

• model: accepteert een tekenreeks ("provider/model") of een object ({ primary, fallbacks }).
  • De tekenreeksvorm stelt alleen het primaire model in.
  • De objectvorm stelt het primaire model plus geordende failovermodellen in.
• imageModel: accepteert een tekenreeks ("provider/model") of een object ({ primary, fallbacks }).
  • Gebruikt door het image-toolpad als configuratie voor het vision-model.
  • Ook gebruikt als fallback-routering wanneer het geselecteerde/standaardmodel geen afbeeldingsinvoer kan accepteren.
  • Geef de voorkeur aan expliciete provider/model-referenties. Kale ID’s worden geaccepteerd voor compatibiliteit; als een kaal ID uniek overeenkomt met een geconfigureerde afbeeldingsgeschikte vermelding in models.providers.*.models, kwalificeert OpenClaw dit naar die provider. Ambigue geconfigureerde overeenkomsten vereisen een expliciet providerprefix.
• imageGenerationModel: accepteert een tekenreeks ("provider/model") of een object ({ primary, fallbacks }).
  • Gebruikt door de gedeelde afbeeldingsgeneratiecapaciteit en elk toekomstig tool-/Plugin-oppervlak dat afbeeldingen genereert.
  • Typische waarden: google/gemini-3.1-flash-image-preview voor native Gemini-afbeeldingsgeneratie, fal/fal-ai/flux/dev voor fal, openai/gpt-image-2 voor OpenAI Images, of openai/gpt-image-1.5 voor OpenAI PNG/WebP-uitvoer met transparante achtergrond.
  • Als je rechtstreeks een provider/model selecteert, configureer dan ook de bijbehorende provider-authenticatie (bijvoorbeeld GEMINI_API_KEY of GOOGLE_API_KEY voor google/*, OPENAI_API_KEY of OpenAI Codex OAuth voor openai/gpt-image-2 / openai/gpt-image-1.5, FAL_KEY voor fal/*).
  • Indien weggelaten, kan image_generate nog steeds een door authenticatie ondersteunde providerstandaard afleiden. Het probeert eerst de huidige standaardprovider en daarna de resterende geregistreerde afbeeldingsgeneratieproviders in provider-ID-volgorde.
• musicGenerationModel: accepteert een tekenreeks ("provider/model") of een object ({ primary, fallbacks }).
  • Gebruikt door de gedeelde muziekgeneratiecapaciteit en de ingebouwde music_generate-tool.
  • Typische waarden: google/lyria-3-clip-preview, google/lyria-3-pro-preview, of minimax/music-2.6.
  • Indien weggelaten, kan music_generate nog steeds een door authenticatie ondersteunde providerstandaard afleiden. Het probeert eerst de huidige standaardprovider en daarna de resterende geregistreerde muziekgeneratieproviders in provider-ID-volgorde.
  • Als je rechtstreeks een provider/model selecteert, configureer dan ook de bijbehorende provider-authenticatie/API-sleutel.
• videoGenerationModel: accepteert een tekenreeks ("provider/model") of een object ({ primary, fallbacks }).
  • Gebruikt door de gedeelde videogeneratiecapaciteit en de ingebouwde video_generate-tool.
  • Typische waarden: qwen/wan2.6-t2v, qwen/wan2.6-i2v, qwen/wan2.6-r2v, qwen/wan2.6-r2v-flash, of qwen/wan2.7-r2v.
  • Indien weggelaten, kan video_generate nog steeds een door authenticatie ondersteunde providerstandaard afleiden. Het probeert eerst de huidige standaardprovider en daarna de resterende geregistreerde videogeneratieproviders in provider-ID-volgorde.
  • Als je rechtstreeks een provider/model selecteert, configureer dan ook de bijbehorende provider-authenticatie/API-sleutel.
  • De gebundelde Qwen-provider voor videogeneratie ondersteunt maximaal 1 uitvoervideo, 1 invoerafbeelding, 4 invoervideo’s, een duur van 10 seconden, en provider-niveauopties size, aspectRatio, resolution, audio en watermark.
• pdfModel: accepteert een tekenreeks ("provider/model") of een object ({ primary, fallbacks }).
  • Gebruikt door de pdf-tool voor modelroutering.
  • Indien weggelaten, valt de PDF-tool terug op imageModel en daarna op het opgeloste sessie-/standaardmodel.
• pdfMaxBytesMb: standaardlimiet voor PDF-grootte voor de pdf-tool wanneer maxBytesMb niet bij het aanroepen wordt doorgegeven.
• pdfMaxPages: standaardmaximum aantal pagina’s dat wordt meegenomen door de extractiefallbackmodus in de pdf-tool.
• verboseDefault: standaardniveau voor uitgebreide uitvoer voor agents. Waarden: "off", "on", "full". Standaard: "off".
• reasoningDefault: standaardzichtbaarheid van redeneringen voor agents. Waarden: "off", "on", "stream". Per-agent agents.list[].reasoningDefault overschrijft deze standaard. Geconfigureerde redeneerstandaarden worden alleen toegepast voor eigenaren, geautoriseerde afzenders of operator-admin-Gateway-contexten wanneer geen redeneeroverride per bericht of sessie is ingesteld.
• elevatedDefault: standaardniveau voor verhoogde uitvoer voor agents. Waarden: "off", "on", "ask", "full". Standaard: "on".
• model.primary: indeling provider/model (bijv. openai/gpt-5.5 voor toegang met API-sleutel of openai-codex/gpt-5.5 voor Codex OAuth). Als je de provider weglaat, probeert OpenClaw eerst een alias, daarna een unieke geconfigureerde-provider-overeenkomst voor dat exacte model-ID, en pas daarna valt het terug op de geconfigureerde standaardprovider (verouderd compatibiliteitsgedrag, dus geef de voorkeur aan expliciet provider/model). Als die provider het geconfigureerde standaardmodel niet langer aanbiedt, valt OpenClaw terug op de eerste geconfigureerde provider/model in plaats van een verouderde standaard van een verwijderde provider te tonen.
• models: de geconfigureerde modelcatalogus en allowlist voor /model. Elke vermelding kan alias (snelkoppeling) en params (providerspecifiek, bijvoorbeeld temperature, maxTokens, cacheRetention, context1m, responsesServerCompaction, responsesCompactThreshold, chat_template_kwargs, extra_body/extraBody) bevatten.
  • Veilige bewerkingen: gebruik openclaw config set agents.defaults.models '<json>' --strict-json --merge om vermeldingen toe te voegen. config set weigert vervangingen die bestaande allowlist-vermeldingen zouden verwijderen, tenzij je --replace doorgeeft.
  • Provider-gescopeerde configuratie-/onboardingflows voegen geselecteerde providermodellen samen in deze map en behouden niet-gerelateerde providers die al zijn geconfigureerd.
  • Voor directe OpenAI Responses-modellen wordt server-side Compaction automatisch ingeschakeld. Gebruik params.responsesServerCompaction: false om het injecteren van context_management te stoppen, of params.responsesCompactThreshold om de drempel te overschrijven. Zie OpenAI server-side compaction.
• params: globale standaardproviderparameters die op alle modellen worden toegepast. Ingesteld op agents.defaults.params (bijv. { cacheRetention: "long" }).
• Samenvoegprioriteit van params (configuratie): agents.defaults.params (globale basis) wordt overschreven door agents.defaults.models["provider/model"].params (per model), daarna overschrijft agents.list[].params (overeenkomend agent-ID) per sleutel. Zie Prompt Caching voor details.
• params.extra_body/params.extraBody: geavanceerde pass-through-JSON die wordt samengevoegd in api: "openai-completions"-requestbody’s voor OpenAI-compatibele proxies. Als dit botst met gegenereerde requestsleutels, wint de extra body; niet-native completions-routes verwijderen daarna nog steeds OpenAI-only store.
• params.chat_template_kwargs: vLLM/OpenAI-compatibele chat-template-argumenten die worden samengevoegd in top-level api: "openai-completions"-requestbody’s. Voor vllm/nemotron-3-* met denken uit verzendt de gebundelde vLLM-Plugin automatisch enable_thinking: false en force_nonempty_content: true; expliciete chat_template_kwargs overschrijven gegenereerde standaarden, en extra_body.chat_template_kwargs heeft nog steeds de laatste prioriteit. Voor Qwen-denkbedieningselementen in vLLM stel je params.qwenThinkingFormat in op "chat-template" of "top-level" voor die modelvermelding.
• compat.supportedReasoningEfforts: per-model OpenAI-compatibele lijst met redeneerinspanning. Neem "xhigh" op voor aangepaste eindpunten die dit daadwerkelijk accepteren; OpenClaw toont dan /think xhigh in opdrachtmenu’s, Gateway-sessierijen, validatie van sessiepatches, validatie van agent-CLI en llm-task-validatie voor die geconfigureerde provider/model. Gebruik compat.reasoningEffortMap wanneer de backend een providerspecifieke waarde voor een canoniek niveau wil.
• params.preserveThinking: alleen voor Z.AI opt-in voor behouden denken. Wanneer ingeschakeld en denken aan staat, verzendt OpenClaw thinking.clear_thinking: false en speelt het eerdere reasoning_content opnieuw af; zie Z.AI thinking and preserved thinking.
• agentRuntime: standaard laag-niveau agent-runtimebeleid. Een weggelaten ID gebruikt standaard OpenClaw Pi. Gebruik id: "pi" om de ingebouwde PI-harnas te forceren, id: "auto" om geregistreerde Plugin-harnassen ondersteunde modellen te laten claimen, een geregistreerd harnas-ID zoals id: "codex", of een ondersteunde CLI-backendalias zoals id: "claude-cli". Stel fallback: "none" in om automatische PI-fallback uit te schakelen. Expliciete Plugin-runtimes zoals codex falen standaard gesloten, tenzij je fallback: "pi" instelt in dezelfde overschrijvingsscope. Houd modelreferenties canoniek als provider/model; selecteer Codex, Claude CLI, Gemini CLI en andere uitvoeringsbackends via runtimeconfiguratie in plaats van verouderde runtimeproviderprefixen. Zie Agent runtimes voor hoe dit verschilt van provider/model-selectie.
• Configuratieschrijvers die deze velden wijzigen (bijvoorbeeld /models set, /models set-image en opdrachten voor fallback toevoegen/verwijderen), slaan de canonieke objectvorm op en behouden bestaande fallbacklijsten waar mogelijk.
• maxConcurrent: maximaal aantal parallelle agentruns over sessies heen (elke sessie blijft geserialiseerd). Standaard: 4.

​

agents.defaults.agentRuntime

{
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
      agentRuntime: {
        id: "codex",
        fallback: "none",
      },
    },
  },
}

• id: "auto", "pi", een geregistreerd Plugin-harnas-ID, of een ondersteunde CLI-backendalias. De gebundelde Codex-Plugin registreert codex; de gebundelde Anthropic-Plugin levert de claude-cli CLI-backend.
• fallback: "pi" of "none". In id: "auto" gebruikt een weggelaten fallback standaard "pi" zodat oude configuraties PI kunnen blijven gebruiken wanneer geen Plugin-harnas een run claimt. In expliciete Plugin-runtime-modus, zoals id: "codex", gebruikt een weggelaten fallback standaard "none" zodat een ontbrekend harnas faalt in plaats van stilzwijgend PI te gebruiken. Runtime-overschrijvingen erven fallback niet uit een bredere scope; stel fallback: "pi" in naast de expliciete runtime wanneer je die compatibiliteitsfallback bewust wilt. Fouten in geselecteerde Plugin-harnassen worden altijd direct getoond.
• Omgevingsoverschrijvingen: OPENCLAW_AGENT_RUNTIME=<id|auto|pi> overschrijft id; OPENCLAW_AGENT_HARNESS_FALLBACK=pi|none overschrijft fallback voor dat proces.
• Voor Codex-only implementaties stel je model: "openai/gpt-5.5" en agentRuntime.id: "codex" in. Je kunt ook expliciet agentRuntime.fallback: "none" instellen voor leesbaarheid; dit is de standaard voor expliciete Plugin-runtimes.
• Voor Claude CLI-implementaties geef je de voorkeur aan model: "anthropic/claude-opus-4-7" plus agentRuntime.id: "claude-cli". Verouderde claude-cli/claude-opus-4-7-modelreferenties blijven werken voor compatibiliteit, maar nieuwe configuratie moet provider/model-selectie canoniek houden en de uitvoeringsbackend in agentRuntime.id plaatsen.
• Oudere runtimebeleidssleutels worden door openclaw doctor --fix herschreven naar agentRuntime.
• De harnaskeuze wordt per sessie-ID vastgezet na de eerste ingebedde run. Configuratie-/omgevingswijzigingen beïnvloeden nieuwe of geresette sessies, niet een bestaand transcript. Verouderde sessies met transcriptgeschiedenis maar zonder geregistreerde pin worden behandeld als PI-vastgezet. /status rapporteert de effectieve runtime, bijvoorbeeld Runtime: OpenClaw Pi Default of Runtime: OpenAI Codex.
• Dit bepaalt alleen de uitvoering van tekstagentbeurten. Mediageneratie, vision, PDF, muziek, video en TTS blijven hun provider/model-instellingen gebruiken.

​

agents.defaults.cliBackends

{
  agents: {
    defaults: {
      cliBackends: {
        "codex-cli": {
          command: "/opt/homebrew/bin/codex",
        },
        "my-cli": {
          command: "my-cli",
          args: ["--json"],
          output: "json",
          modelArg: "--model",
          sessionArg: "--session",
          sessionMode: "existing",
          systemPromptArg: "--system",
          // Or use systemPromptFileArg when the CLI accepts a prompt file flag.
          systemPromptWhen: "first",
          imageArg: "--image",
          imageMode: "repeat",
        },
      },
    },
  },
}

• CLI-backends zijn tekstgericht; tools zijn altijd uitgeschakeld.
• Sessies worden ondersteund wanneer sessionArg is ingesteld.
• Afbeeldingsdoorgifte wordt ondersteund wanneer imageArg bestandspaden accepteert.

​

agents.defaults.systemPromptOverride

{
  agents: {
    defaults: {
      systemPromptOverride: "You are a helpful assistant.",
    },
  },
}

​

agents.defaults.promptOverlays

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

• "friendly" (standaard) en "on" schakelen de vriendelijke interactiestijllaag in.
• "off" schakelt alleen de vriendelijke laag uit; het getagde GPT-5-gedragscontract blijft ingeschakeld.
• De verouderde instelling plugins.entries.openai.config.personality wordt nog steeds gelezen wanneer deze gedeelde instelling niet is ingesteld.

​

agents.defaults.heartbeat

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m", // 0m disables
        model: "openai/gpt-5.4-mini",
        includeReasoning: false,
        includeSystemPromptSection: true, // default: true; false omits the Heartbeat section from the system prompt
        lightContext: false, // default: false; true keeps only HEARTBEAT.md from workspace bootstrap files
        isolatedSession: false, // default: false; true runs each heartbeat in a fresh session (no conversation history)
        skipWhenBusy: false, // default: false; true also waits for subagent/nested lanes
        session: "main",
        to: "+15555550123",
        directPolicy: "allow", // allow (default) | block
        target: "none", // default: none | options: last | whatsapp | telegram | discord | ...
        prompt: "Read HEARTBEAT.md if it exists...",
        ackMaxChars: 300,
        suppressToolErrorWarnings: false,
        timeoutSeconds: 45,
      },
    },
  },
}

• every: duurtekenreeks (ms/s/m/h). Standaard: 30m (API-sleutelauthenticatie) of 1h (OAuth-authenticatie). Stel in op 0m om uit te schakelen.
• includeSystemPromptSection: wanneer dit false is, wordt de Heartbeat-sectie uit de systeemprompt weggelaten en wordt HEARTBEAT.md-injectie in de bootstrap-context overgeslagen. Standaard: true.
• suppressToolErrorWarnings: wanneer dit true is, worden waarschuwingspayloads voor toolfouten tijdens Heartbeat-runs onderdrukt.
• timeoutSeconds: maximale toegestane tijd in seconden voor een Heartbeat-agentbeurt voordat deze wordt afgebroken. Laat niet ingesteld om agents.defaults.timeoutSeconds te gebruiken.
• directPolicy: beleid voor directe/DM-bezorging. allow (standaard) staat bezorging naar directe doelen toe. block onderdrukt bezorging naar directe doelen en geeft reason=dm-blocked uit.
• lightContext: wanneer dit true is, gebruiken Heartbeat-runs een lichtgewicht bootstrap-context en behouden ze alleen HEARTBEAT.md uit de workspace-bootstrapbestanden.
• isolatedSession: wanneer dit true is, draait elke Heartbeat in een nieuwe sessie zonder eerdere gespreksgeschiedenis. Zelfde isolatiepatroon als Cron sessionTarget: "isolated". Verlaagt de tokenkosten per Heartbeat van ~100K naar ~2-5K tokens.
• skipWhenBusy: wanneer dit true is, stellen Heartbeat-runs uit bij extra bezette lanes: subagent- of geneste commandowerkzaamheden. Cron-lanes stellen Heartbeats altijd uit, zelfs zonder deze vlag.
• Per agent: stel agents.list[].heartbeat in. Wanneer een agent heartbeat definieert, voeren alleen die agents Heartbeats uit.
• Heartbeats voeren volledige agentbeurten uit — kortere intervallen verbruiken meer tokens.

​

agents.defaults.compaction

{
  agents: {
    defaults: {
      compaction: {
        mode: "safeguard", // default | safeguard
        provider: "my-provider", // id of a registered compaction provider plugin (optional)
        timeoutSeconds: 900,
        reserveTokensFloor: 24000,
        keepRecentTokens: 50000,
        identifierPolicy: "strict", // strict | off | custom
        identifierInstructions: "Preserve deployment IDs, ticket IDs, and host:port pairs exactly.", // used when identifierPolicy=custom
        qualityGuard: { enabled: true, maxRetries: 1 },
        postCompactionSections: ["Session Startup", "Red Lines"], // [] disables reinjection
        model: "openrouter/anthropic/claude-sonnet-4-6", // optional compaction-only model override
        truncateAfterCompaction: true, // rotate to a smaller successor JSONL after compaction
        maxActiveTranscriptBytes: "20mb", // optional preflight local compaction trigger
        notifyUser: true, // send brief notices when compaction starts and completes (default: false)
        memoryFlush: {
          enabled: true,
          model: "ollama/qwen3:8b", // optional memory-flush-only model override
          softThresholdTokens: 6000,
          systemPrompt: "Session nearing compaction. Store durable memories now.",
          prompt: "Write any lasting notes to memory/YYYY-MM-DD.md; reply with the exact silent token NO_REPLY if nothing to store.",
        },
      },
    },
  },
}

• mode: default of safeguard (gechunkte samenvatting voor lange geschiedenissen). Zie Compaction.
• provider: id van een geregistreerde compaction-provider-Plugin. Wanneer ingesteld, wordt de summarize() van de provider aangeroepen in plaats van ingebouwde LLM-samenvatting. Valt bij falen terug op ingebouwd gedrag. Het instellen van een provider forceert mode: "safeguard". Zie Compaction.
• timeoutSeconds: maximaal aantal seconden toegestaan voor één compaction-bewerking voordat OpenClaw deze afbreekt. Standaard: 900.
• keepRecentTokens: Pi-knippuntbudget om het meest recente transcriptstaartstuk letterlijk te behouden. Handmatige /compact respecteert dit wanneer expliciet ingesteld; anders is handmatige compaction een hard checkpoint.
• identifierPolicy: strict (standaard), off of custom. strict voegt ingebouwde richtlijnen voor behoud van ondoorzichtige identificatoren toe aan het begin tijdens compaction-samenvatting.
• identifierInstructions: optionele aangepaste tekst voor identificatorbehoud die wordt gebruikt wanneer identifierPolicy=custom.
• qualityGuard: controles voor opnieuw proberen bij onjuist gevormde uitvoer voor safeguard-samenvattingen. Standaard ingeschakeld in safeguard-modus; stel enabled: false in om de audit over te slaan.
• postCompactionSections: optionele AGENTS.md H2/H3-sectienamen om opnieuw te injecteren na compaction. Standaard ["Session Startup", "Red Lines"]; stel [] in om herinjectie uit te schakelen. Wanneer niet ingesteld of expliciet ingesteld op dat standaardpaar, worden oudere koppen Every Session/Safety ook geaccepteerd als legacy-fallback.
• model: optionele provider/model-id-override alleen voor compaction-samenvatting. Gebruik dit wanneer de hoofdsessie één model moet behouden maar compaction-samenvattingen op een ander model moeten draaien; wanneer niet ingesteld, gebruikt compaction het primaire model van de sessie.
• maxActiveTranscriptBytes: optionele bytedrempel (number of tekenreeksen zoals "20mb") die normale lokale compaction activeert vóór een run wanneer de actieve JSONL voorbij de drempel groeit. Vereist truncateAfterCompaction zodat succesvolle compaction kan roteren naar een kleiner opvolgtranscript. Uitgeschakeld wanneer niet ingesteld of 0.
• notifyUser: wanneer true, stuurt korte meldingen naar de gebruiker wanneer compaction start en wanneer deze voltooit (bijvoorbeeld “Compacting context…” en “Compaction complete”). Standaard uitgeschakeld om compaction stil te houden.
• memoryFlush: stille agentische beurt vóór automatische compaction om duurzame herinneringen op te slaan. Stel model in op een exacte provider/model zoals ollama/qwen3:8b wanneer deze onderhoudsbeurt op een lokaal model moet blijven; de override erft de fallback-keten van de actieve sessie niet. Overgeslagen wanneer de workspace alleen-lezen is.

​

agents.defaults.contextPruning

{
  agents: {
    defaults: {
      contextPruning: {
        mode: "cache-ttl", // off | cache-ttl
        ttl: "1h", // duration (ms/s/m/h), default unit: minutes
        keepLastAssistants: 3,
        softTrimRatio: 0.3,
        hardClearRatio: 0.5,
        minPrunableToolChars: 50000,
        softTrim: { maxChars: 4000, headChars: 1500, tailChars: 1500 },
        hardClear: { enabled: true, placeholder: "[Old tool result content cleared]" },
        tools: { deny: ["browser", "canvas"] },
      },
    },
  },
}

​

Blokstreaming

{
  agents: {
    defaults: {
      blockStreamingDefault: "off", // on | off
      blockStreamingBreak: "text_end", // text_end | message_end
      blockStreamingChunk: { minChars: 800, maxChars: 1200 },
      blockStreamingCoalesce: { idleMs: 1000 },
      humanDelay: { mode: "natural" }, // off | natural | custom (use minMs/maxMs)
    },
  },
}

• Niet-Telegram-kanalen vereisen expliciet *.blockStreaming: true om blokantwoorden in te schakelen.
• Kanaaloverrides: channels.<channel>.blockStreamingCoalesce (en varianten per account). Signal/Slack/Discord/Google Chat gebruiken standaard minChars: 1500.
• humanDelay: gerandomiseerde pauze tussen blokantwoorden. natural = 800–2500ms. Override per agent: agents.list[].humanDelay.

​

Typindicatoren

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

• Standaardwaarden: instant voor directe chats/vermeldingen, message voor groepschats zonder vermelding.
• Overschrijvingen per sessie: session.typingMode, session.typingIntervalSeconds.

​

agents.defaults.sandbox

{
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main", // off | non-main | all
        backend: "docker", // docker | ssh | openshell
        scope: "agent", // session | agent | shared
        workspaceAccess: "none", // none | 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,
          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 / inline contents also supported:
          // 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"],
      },
    },
  },
}

{
  plugins: {
    entries: {
      openshell: {
        enabled: true,
        config: {
          mode: "mirror", // mirror | remote
          from: "openclaw",
          remoteWorkspaceDir: "/sandbox",
          remoteAgentWorkspaceDir: "/agent",
          gateway: "lab", // optional
          gatewayEndpoint: "https://lab.example", // optional
          policy: "strict", // optional OpenShell policy id
          providers: ["openai"], // optional
          autoProviders: true,
          timeoutSeconds: 120,
        },
      },
    },
  },
}

scripts/sandbox-setup.sh           # main sandbox image
scripts/sandbox-browser-setup.sh   # optional browser image

​

agents.list (overschrijvingen per agent)

{
  agents: {
    list: [
      {
        id: "main",
        default: true,
        name: "Main Agent",
        workspace: "~/.openclaw/workspace",
        agentDir: "~/.openclaw/agents/main/agent",
        model: "anthropic/claude-opus-4-6", // or { primary, fallbacks }
        thinkingDefault: "high", // per-agent thinking level override
        reasoningDefault: "on", // per-agent reasoning visibility override
        fastModeDefault: false, // per-agent fast mode override
        agentRuntime: { id: "auto", fallback: "pi" },
        params: { cacheRetention: "none" }, // overrides matching defaults.models params by key
        tts: {
          providers: {
            elevenlabs: { voiceId: "EXAVITQu4vr4xnSDxMaL" },
          },
        },
        skills: ["docs-search"], // replaces agents.defaults.skills when set
        identity: {
          name: "Samantha",
          theme: "helpful sloth",
          emoji: "🦥",
          avatar: "avatars/samantha.png",
        },
        groupChat: { mentionPatterns: ["@openclaw"] },
        sandbox: { mode: "off" },
        runtime: {
          type: "acp",
          acp: {
            agent: "codex",
            backend: "acpx",
            mode: "persistent",
            cwd: "/workspace/openclaw",
          },
        },
        subagents: { allowAgents: ["*"] },
        tools: {
          profile: "coding",
          allow: ["browser"],
          deny: ["canvas"],
          elevated: { enabled: true },
        },
      },
    ],
  },
}

• id: stabiele agent-id (vereist).
• default: wanneer er meerdere zijn ingesteld, wint de eerste (waarschuwing gelogd). Als er geen is ingesteld, is de eerste lijstvermelding de standaard.
• model: tekenreeksvorm stelt een strikte primaire waarde per agent in zonder model-fallback; objectvorm { primary } is ook strikt, tenzij je fallbacks toevoegt. Gebruik { primary, fallbacks: [...] } om die agent voor fallback aan te melden, of { primary, fallbacks: [] } om strikt gedrag expliciet te maken. Cron-taken die alleen primary overschrijven, erven nog steeds standaard-fallbacks tenzij je fallbacks: [] instelt.
• params: streamparameters per agent samengevoegd over de geselecteerde modelvermelding in agents.defaults.models. Gebruik dit voor agent-specifieke overschrijvingen zoals cacheRetention, temperature of maxTokens zonder de volledige modelcatalogus te dupliceren.
• tts: optionele text-to-speech-overschrijvingen per agent. Het blok wordt diep samengevoegd over messages.tts, dus houd gedeelde providerreferenties en fallbackbeleid in messages.tts en stel hier alleen persona-specifieke waarden in, zoals provider, stem, model, stijl of automatische modus.
• skills: optionele Skills-toestaanlijst per agent. Als dit wordt weggelaten, erft de agent agents.defaults.skills wanneer dat is ingesteld; een expliciete lijst vervangt standaardwaarden in plaats van ermee samen te voegen, en [] betekent geen Skills.
• thinkingDefault: optioneel standaarddenkniveau per agent (off | minimal | low | medium | high | xhigh | adaptive | max). Overschrijft agents.defaults.thinkingDefault voor deze agent wanneer er geen overschrijving per bericht of sessie is ingesteld. Het geselecteerde provider-/modelprofiel bepaalt welke waarden geldig zijn; voor Google Gemini behoudt adaptive provider-eigen dynamisch denken (thinkingLevel weggelaten op Gemini 3/3.1, thinkingBudget: -1 op Gemini 2.5).
• reasoningDefault: optionele standaardzichtbaarheid van redenering per agent (on | off | stream). Overschrijft agents.defaults.reasoningDefault voor deze agent wanneer er geen redeneringsoverschrijving per bericht of sessie is ingesteld.
• fastModeDefault: optionele standaardwaarde per agent voor snelle modus (true | false). Wordt toegepast wanneer er geen overschrijving voor snelle modus per bericht of sessie is ingesteld.
• agentRuntime: optionele low-level runtimebeleid-overschrijving per agent. Gebruik { id: "codex" } om één agent alleen Codex te laten gebruiken, terwijl andere agents de standaard Pi-fallback in auto-modus behouden.
• runtime: optionele runtimedescriptor per agent. Gebruik type: "acp" met runtime.acp-standaardwaarden (agent, backend, mode, cwd) wanneer de agent standaard ACP-harness-sessies moet gebruiken.
• identity.avatar: werkruimte-relatief pad, http(s)-URL of data:-URI.
• identity leidt standaardwaarden af: ackReaction uit emoji, mentionPatterns uit name/emoji.
• subagents.allowAgents: toestaanlijst van agent-id’s voor expliciete sessions_spawn.agentId-doelen (["*"] = willekeurig; standaard: alleen dezelfde agent). Neem de requester-id op wanneer zelfgerichte agentId-aanroepen toegestaan moeten zijn.
• Sandbox-overervingsbewaking: als de requester-sessie in een sandbox draait, weigert sessions_spawn doelen die zonder sandbox zouden draaien.
• subagents.requireAgentId: wanneer waar, blokkeer sessions_spawn-aanroepen die agentId weglaten (dwingt expliciete profielselectie af; standaard: onwaar).

​

Routering voor meerdere agents

{
  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" } },
  ],
}

​

Binding-matchvelden

• type (optioneel): route voor normale routering (ontbrekend type gebruikt standaard route), acp voor persistente ACP-gespreksbindings.
• match.channel (vereist)
• match.accountId (optioneel; * = elk account; weggelaten = standaardaccount)
• match.peer (optioneel; { kind: direct|group|channel, id })
• match.guildId / match.teamId (optioneel; kanaalspecifiek)
• acp (optioneel; alleen voor type: "acp"): { mode, label, cwd, backend }

1. match.peer
2. match.guildId
3. match.teamId
4. match.accountId (exact, geen peer/guild/team)
5. match.accountId: "*" (kanaalbreed)
6. Standaardagent

​

Toegangsprofielen per 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",
          ],
        },
      },
    ],
  },
}

​

Sessie

{
  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 },
    },
    resetTriggers: ["/new", "/reset"],
    store: "~/.openclaw/agents/{agentId}/sessions/sessions.json",
    parentForkMaxTokens: 100000, // skip parent-thread fork above this token count (0 disables)
    maintenance: {
      mode: "warn", // warn | enforce
      pruneAfter: "30d",
      maxEntries: 500,
      resetArchiveRetention: "30d", // duration or false
      maxDiskBytes: "500mb", // optional hard budget
      highWaterBytes: "400mb", // optional cleanup target
    },
    threadBindings: {
      enabled: true,
      idleHours: 24, // default inactivity auto-unfocus in hours (`0` disables)
      maxAgeHours: 0, // default hard max age in hours (`0` disables)
    },
    mainKey: "main", // legacy (runtime always uses "main")
    agentToAgent: { maxPingPongTurns: 5 },
    sendPolicy: {
      rules: [{ action: "deny", match: { channel: "discord", chatType: "group" } }],
      default: "allow",
    },
  },
}

​

Berichten

{
  messages: {
    responsePrefix: "🦞", // or "auto"
    ackReaction: "👀",
    ackReactionScope: "group-mentions", // group-mentions | group-all | direct | all
    removeAckAfterReply: false,
    queue: {
      mode: "steer", // steer | followup | collect | steer-backlog | steer+backlog | queue | interrupt
      debounceMs: 500,
      cap: 20,
      drop: "summarize", // old | new | summarize
      byChannel: {
        whatsapp: "steer",
        telegram: "steer",
      },
    },
    inbound: {
      debounceMs: 2000, // 0 disables
      byChannel: {
        whatsapp: 5000,
        slack: 1500,
      },
    },
  },
}

​

Antwoordprefix

​

Bevestigingsreactie

• Staat standaard op identity.emoji van de actieve agent, anders "👀". Stel in op "" om uit te schakelen.
• Overschrijvingen per kanaal: channels.<channel>.ackReaction, channels.<channel>.accounts.<id>.ackReaction.
• Resolutievolgorde: account → kanaal → messages.ackReaction → terugval op identiteit.
• Bereik: group-mentions (standaard), group-all, direct, all.
• removeAckAfterReply: verwijdert de bevestiging na het antwoord op kanalen met reactieondersteuning, zoals Slack, Discord, Telegram, WhatsApp en BlueBubbles.
• messages.statusReactions.enabled: schakelt statusreacties voor de levenscyclus in op Slack, Discord en Telegram. Op Slack en Discord blijven statusreacties ingeschakeld wanneer bevestigingsreacties actief zijn als dit niet is ingesteld. Stel dit op Telegram expliciet in op true om statusreacties voor de levenscyclus in te schakelen.

​

Inkomende debounce

​

TTS (tekst-naar-spraak)

{
  messages: {
    tts: {
      auto: "always", // off | always | inbound | tagged
      mode: "final", // final | all
      provider: "elevenlabs",
      summaryModel: "openai/gpt-4.1-mini",
      modelOverrides: { enabled: true },
      maxTextLength: 4000,
      timeoutMs: 30000,
      prefsPath: "~/.openclaw/settings/tts.json",
      providers: {
        elevenlabs: {
          apiKey: "elevenlabs_api_key",
          baseUrl: "https://api.elevenlabs.io",
          voiceId: "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: {
          voice: "en-US-AvaMultilingualNeural",
          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",
          voice: "alloy",
        },
      },
    },
  },
}

• auto beheert de standaardmodus voor automatische TTS: off, always, inbound of tagged. /tts on|off kan lokale voorkeuren overschrijven, en /tts status toont de effectieve status.
• summaryModel overschrijft agents.defaults.model.primary voor automatische samenvatting.
• modelOverrides is standaard ingeschakeld; modelOverrides.allowProvider staat standaard op false (opt-in).
• API-sleutels vallen terug op ELEVENLABS_API_KEY/XI_API_KEY en OPENAI_API_KEY.
• Meegeleverde spraakproviders zijn eigendom van plugins. Als plugins.allow is ingesteld, neem dan elke TTS-providerplugin op die je wilt gebruiken, bijvoorbeeld microsoft voor Edge TTS. De verouderde provider-id edge wordt geaccepteerd als alias voor microsoft.
• providers.openai.baseUrl overschrijft het OpenAI TTS-eindpunt. De resolutievolgorde is configuratie, daarna OPENAI_TTS_BASE_URL, daarna https://api.openai.com/v1.
• Wanneer providers.openai.baseUrl naar een niet-OpenAI-eindpunt verwijst, behandelt OpenClaw dit als een OpenAI-compatibele TTS-server en versoepelt het model-/stemvalidatie.

​

Spreken

{
  talk: {
    provider: "elevenlabs",
    providers: {
      elevenlabs: {
        voiceId: "elevenlabs_voice_id",
        voiceAliases: {
          Clawd: "EXAVITQu4vr4xnSDxMaL",
          Roger: "CwhRBWXzGAHq8TQ4Fs17",
        },
        modelId: "eleven_v3",
        outputFormat: "mp3_44100_128",
        apiKey: "elevenlabs_api_key",
      },
      mlx: {
        modelId: "mlx-community/Soprano-80M-bf16",
      },
      system: {},
    },
    speechLocale: "ru-RU",
    silenceTimeoutMs: 1500,
    interruptOnSpeech: true,
  },
}

• talk.provider moet overeenkomen met een sleutel in talk.providers wanneer meerdere spreekproviders zijn geconfigureerd.
• Verouderde platte spreeksleutels (talk.voiceId, talk.voiceAliases, talk.modelId, talk.outputFormat, talk.apiKey) zijn alleen voor compatibiliteit en worden automatisch gemigreerd naar talk.providers.<provider>.
• Stem-id’s vallen terug op ELEVENLABS_VOICE_ID of SAG_VOICE_ID.
• providers.*.apiKey accepteert platteteksttekenreeksen of SecretRef-objecten.
• Terugval op ELEVENLABS_API_KEY is alleen van toepassing wanneer er geen Talk-API-sleutel is geconfigureerd.
• providers.*.voiceAliases laat Talk-richtlijnen vriendelijke namen gebruiken.
• providers.mlx.modelId selecteert de Hugging Face-repo die wordt gebruikt door de macOS local MLX-helper. Als dit is weggelaten, gebruikt macOS mlx-community/Soprano-80M-bf16.
• macOS MLX-weergave loopt via de meegeleverde openclaw-mlx-tts-helper wanneer die aanwezig is, of via een uitvoerbaar bestand op PATH; OPENCLAW_MLX_TTS_BIN overschrijft het helperpad voor ontwikkeling.
• speechLocale stelt de BCP 47-locale-id in die wordt gebruikt door iOS/macOS-spraakherkenning voor Talk. Laat dit uitgeschakeld om de apparaatstandaard te gebruiken.
• silenceTimeoutMs bepaalt hoe lang de spreekmodus na stilte van de gebruiker wacht voordat het transcript wordt verzonden. Niet ingesteld behoudt het standaard pauzevenster van het platform (700 ms op macOS en Android, 900 ms op iOS).

​

Gerelateerd

• Configuratiereferentie — alle andere configuratiesleutels
• Configuratie — veelvoorkomende taken en snelle installatie
• Configuratievoorbeelden