Configuratie — agenten

Documentation Index

Fetch the complete documentation index at: https://docs2.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 over te nemen.
• 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.skipOptionalBootstrapFiles

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

​

agents.defaults.contextInjection

• "continuation-skip": veilige vervolgbeurten (na een voltooide assistentrespons) slaan herinjectie van de werkruimte-bootstrap over, waardoor de promptgrootte afneemt. Heartbeat-runs en retries na Compaction bouwen de context nog steeds opnieuw op.
• "never": schakel werkruimte-bootstrap en injectie van contextbestanden bij 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 herstelbeurten na Compaction 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 meldingstekst over afkapping in de systeemprompt.
• "once": injecteer één keer per unieke afkappingssignatuur een beknopte melding (aanbevolen).
• "always": injecteer bij elke run een beknopte melding wanneer er afkapping bestaat.

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

​

Eigendomskaart voor contextbudget

• agents.defaults.bootstrapMaxChars / agents.defaults.bootstrapTotalMaxChars: normale injectie van werkruimte-bootstrap.
• agents.defaults.startupContext.*: eenmalige prelude voor reset-/opstartmodelruns, 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 runtimefragmenten en geïnjecteerde blokken die eigendom zijn van de runtime.
• memory.qmd.limits.*: fragment voor geïndexeerd geheugenzoeken 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 blijvend opgeslagen resultaten en overflow-herstel.
• postCompactionMaxChars: limiet voor AGENTS.md-fragmenten die wordt gebruikt tijdens verversingsinjectie 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
      pdfMaxBytesMb: 10,
      pdfMaxPages: 20,
      thinkingDefault: "low",
      verboseDefault: "off",
      toolProgressDetail: "explain",
      reasoningDefault: "off",
      elevatedDefault: "on",
      timeoutSeconds: 600,
      mediaMaxMb: 5,
      contextTokens: 200000,
      maxConcurrent: 3,
    },
  },
}

• model: accepteert een string ("provider/model") of een object ({ primary, fallbacks }).
  • Stringvorm stelt alleen het primaire model in.
  • Objectvorm stelt het primaire model plus geordende failovermodellen in.
• imageModel: accepteert een string ("provider/model") of een object ({ primary, fallbacks }).
  • Wordt door het image-toolpad gebruikt als vision-modelconfiguratie.
  • Wordt ook gebruikt als fallbackroutering wanneer het geselecteerde/standaardmodel geen afbeeldingsinvoer kan accepteren.
  • Geef de voorkeur aan expliciete provider/model-verwijzingen. Kale ID’s worden geaccepteerd voor compatibiliteit; als een kaal ID uniek overeenkomt met een geconfigureerd item in models.providers.*.models dat afbeeldingen ondersteunt, kwalificeert OpenClaw het voor die provider. Ambigue geconfigureerde overeenkomsten vereisen een expliciet providerprefix.
• imageGenerationModel: accepteert een string ("provider/model") of een object ({ primary, fallbacks }).
  • Wordt gebruikt door de gedeelde mogelijkheid voor afbeeldingsgeneratie en elk toekomstig tool-/pluginoppervlak 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 providerauthenticatie (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/*).
  • Als dit wordt weggelaten, kan image_generate nog steeds een door authenticatie ondersteunde providerstandaard afleiden. Het probeert eerst de huidige standaardprovider en daarna de resterende geregistreerde providers voor afbeeldingsgeneratie in provider-ID-volgorde.
• musicGenerationModel: accepteert een string ("provider/model") of een object ({ primary, fallbacks }).
  • Wordt gebruikt door de gedeelde mogelijkheid voor muziekgeneratie en de ingebouwde music_generate-tool.
  • Typische waarden: google/lyria-3-clip-preview, google/lyria-3-pro-preview, of minimax/music-2.6.
  • Als dit wordt weggelaten, kan music_generate nog steeds een door authenticatie ondersteunde providerstandaard afleiden. Het probeert eerst de huidige standaardprovider en daarna de resterende geregistreerde providers voor muziekgeneratie in provider-ID-volgorde.
  • Als je rechtstreeks een provider/model selecteert, configureer dan ook de bijbehorende providerauthenticatie/API-sleutel.
• videoGenerationModel: accepteert een string ("provider/model") of een object ({ primary, fallbacks }).
  • Wordt gebruikt door de gedeelde mogelijkheid voor videogeneratie 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.
  • Als dit wordt weggelaten, kan video_generate nog steeds een door authenticatie ondersteunde providerstandaard afleiden. Het probeert eerst de huidige standaardprovider en daarna de resterende geregistreerde providers voor videogeneratie in provider-ID-volgorde.
  • Als je rechtstreeks een provider/model selecteert, configureer dan ook de bijbehorende providerauthenticatie/API-sleutel.
  • De gebundelde Qwen-provider voor videogeneratie ondersteunt maximaal 1 uitvoervideo, 1 invoerafbeelding, 4 invoervideo’s, 10 seconden duur, en opties op providerniveau voor size, aspectRatio, resolution, audio en watermark.
• pdfModel: accepteert een string ("provider/model") of een object ({ primary, fallbacks }).
  • Wordt door de pdf-tool gebruikt voor modelroutering.
  • Als dit wordt 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 tijdens de aanroep wordt doorgegeven.
• pdfMaxPages: standaard maximum aantal pagina’s dat wordt meegenomen door de extractiefallbackmodus in de pdf-tool.
• verboseDefault: standaard uitgebreidheidsniveau voor agents. Waarden: "off", "on", "full". Standaard: "off".
• toolProgressDetail: detailmodus voor /verbose-toolsamenvattingen en toolregels voor voortgangsconcepten. Waarden: "explain" (standaard, compacte menselijke labels) of "raw" (voeg ruwe opdracht/details toe wanneer beschikbaar). Per-agent agents.list[].toolProgressDetail overschrijft deze standaard.
• reasoningDefault: standaard zichtbaarheid van redenering voor agents. Waarden: "off", "on", "stream". Per-agent agents.list[].reasoningDefault overschrijft deze standaard. Geconfigureerde redeneringsstandaarden worden alleen toegepast voor eigenaren, geautoriseerde afzenders of operator-admin Gateway-contexten wanneer er geen redeneringsoverschrijving per bericht of sessie is ingesteld.
• elevatedDefault: standaard niveau voor verhoogde uitvoer voor agents. Waarden: "off", "on", "ask", "full". Standaard: "on".
• model.primary: formaat provider/model (bijv. openai/gpt-5.5 voor toegang via OpenAI API-sleutel of Codex OAuth). Als je de provider weglaat, probeert OpenClaw eerst een alias, daarna een unieke overeenkomst met een geconfigureerde provider voor dat exacte model-ID, en valt pas daarna terug op de geconfigureerde standaardprovider (verouderd compatibiliteitsgedrag, dus geef de voorkeur aan expliciet provider/model). Als die provider het geconfigureerde standaardmodel niet meer 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. Elk item kan alias (snelkoppeling) en params bevatten (providerspecifiek, bijvoorbeeld temperature, maxTokens, cacheRetention, context1m, responsesServerCompaction, responsesCompactThreshold, chat_template_kwargs, extra_body/extraBody).
  • Gebruik provider/*-items zoals "openai-codex/*": {} of "vllm/*": {} om alle ontdekte modellen voor geselecteerde providers te tonen zonder elk model-ID handmatig op te sommen.
  • Veilige bewerkingen: gebruik openclaw config set agents.defaults.models '<json>' --strict-json --merge om items toe te voegen. config set weigert vervangingen die bestaande allowlist-items zouden verwijderen, tenzij je --replace doorgeeft.
  • Providergerichte configureer-/onboardingflows voegen geselecteerde providermodellen samen in deze map en behouden niet-gerelateerde providers die al geconfigureerd zijn.
  • 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. Stel in bij agents.defaults.params (bijv. { cacheRetention: "long" }).
• Samenvoegprioriteit voor 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 doorgeef-JSON die wordt samengevoegd in api: "openai-completions"-requestbodies voor OpenAI-compatibele proxy’s. 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"-requestbodies. Voor vllm/nemotron-3-* met thinking uit stuurt 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 uiteindelijke prioriteit. Stel voor Qwen-thinkingregelaars params.qwenThinkingFormat in op "chat-template" of "top-level" op dat modelitem.
• compat.thinkingFormat: OpenAI-compatibele stijl voor thinking-payloads. Gebruik "qwen" voor Qwen-stijl top-level enable_thinking, of "qwen-chat-template" voor chat_template_kwargs.enable_thinking op Qwen-family backends die chat-template kwargs op requestniveau ondersteunen, zoals vLLM. OpenClaw mapt uitgeschakelde thinking naar false en ingeschakelde thinking naar true.
• compat.supportedReasoningEfforts: per-model OpenAI-compatibele lijst met reasoning effort. Neem "xhigh" op voor aangepaste endpoints die dit echt 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 wil voor een canoniek niveau.
• params.preserveThinking: alleen Z.AI opt-in voor behouden thinking. Wanneer dit is ingeschakeld en thinking aan staat, stuurt OpenClaw thinking.clear_thinking: false en speelt eerdere reasoning_content opnieuw af; zie Z.AI thinking en behouden thinking.
• localService: optionele procesmanager op providerniveau voor lokale/zelfgehoste modelservers. Wanneer het geselecteerde model bij die provider hoort, controleert OpenClaw healthUrl (of baseUrl + "/models"), start command met args als het endpoint offline is, wacht maximaal readyTimeoutMs en verstuurt daarna het modelrequest. command moet een absoluut pad zijn. idleStopMs: 0 houdt het proces actief totdat OpenClaw afsluit; een positieve waarde stopt het door OpenClaw gestarte proces na zoveel milliseconden inactiviteit. Zie Lokale modelservices.
• Runtimebeleid hoort op providers of modellen, niet op agents.defaults. Gebruik models.providers.<provider>.agentRuntime voor providerbrede regels of agents.defaults.models["provider/model"].agentRuntime / agents.list[].models["provider/model"].agentRuntime voor modelspecifieke regels. OpenAI-agentmodellen op de officiële OpenAI-provider selecteren standaard Codex.
• 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 wanneer mogelijk.
• maxConcurrent: maximaal aantal parallelle agentruns over sessies heen (elke sessie blijft geserialiseerd). Standaard: 4.

​

Runtimebeleid

{
  models: {
    providers: {
      openai: {
        agentRuntime: { id: "codex" },
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
      models: {
        "anthropic/claude-opus-4-7": {
          agentRuntime: { id: "claude-cli" },
        },
      },
    },
  },
}

• id: "auto", "pi", een geregistreerd plugin-harness-ID, of een ondersteunde CLI-backendalias. De gebundelde Codex-plugin registreert codex; de gebundelde Anthropic-plugin levert de claude-cli CLI-backend.
• id: "auto" laat geregistreerde plugin-harnesses ondersteunde beurten claimen en gebruikt PI wanneer geen harness overeenkomt. Een expliciete pluginruntime zoals id: "codex" vereist die harness en faalt gesloten als die niet beschikbaar is of faalt.
• Runtime-sleutels voor de hele agent zijn legacy. agents.defaults.agentRuntime, agents.list[].agentRuntime, runtimepinnen van sessies en OPENCLAW_AGENT_RUNTIME worden genegeerd door runtimeselectie. Voer openclaw doctor --fix uit om verouderde waarden te verwijderen.
• OpenAI-agentmodellen gebruiken standaard de Codex-harness; provider/model agentRuntime.id: "codex" blijft geldig wanneer je dat expliciet wilt maken.
• Geef voor Claude CLI-deployments de voorkeur aan model: "anthropic/claude-opus-4-7" plus modelgerichte agentRuntime.id: "claude-cli". Legacy claude-cli/claude-opus-4-7-modelverwijzingen blijven werken voor compatibiliteit, maar nieuwe configuratie moet provider/model-selectie canoniek houden en de uitvoeringsbackend in runtimebeleid voor provider/model plaatsen.
• Dit regelt alleen uitvoering van tekst-agentbeurten. 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.
• Het doorgeven van afbeeldingen wordt ondersteund wanneer imageArg bestandspaden accepteert.
• Met reseedFromRawTranscriptWhenUncompacted: true kan een backend veilige ongeldig gemaakte sessies herstellen uit een begrensde ruwe OpenClaw-transcriptstaart voordat de eerste Compaction-samenvatting bestaat. Wijzigingen in het auth-profiel of credential-epoch worden nog steeds nooit opnieuw gezaaid vanuit ruwe data.

​

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.
• Legacy 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 this agent's 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-key-auth) of 1h (OAuth-auth). Stel in op 0m om uit te schakelen.
• includeSystemPromptSection: laat, wanneer false, de Heartbeat-sectie weg uit de systeemprompt en slaat HEARTBEAT.md-injectie in de bootstrap-context over. Standaard: true.
• suppressToolErrorWarnings: onderdrukt, wanneer true, waarschuwingspayloads voor toolfouten tijdens Heartbeat-runs.
• timeoutSeconds: maximale tijd in seconden die is toegestaan voor een Heartbeat-agentbeurt voordat deze wordt afgebroken. Laat oningesteld om agents.defaults.timeoutSeconds te gebruiken.
• directPolicy: bezorgbeleid voor direct/DM. allow (standaard) staat bezorging naar directe doelen toe. block onderdrukt bezorging naar directe doelen en geeft reason=dm-blocked uit.
• lightContext: wanneer true gebruiken Heartbeat-runs een lichte bootstrap-context en behouden ze alleen HEARTBEAT.md uit de workspace-bootstrapbestanden.
• isolatedSession: wanneer true draait elke Heartbeat in een nieuwe sessie zonder eerdere gespreksgeschiedenis. Hetzelfde isolatiepatroon als Cron sessionTarget: "isolated". Verlaagt de tokenkosten per Heartbeat van ongeveer 100K naar ongeveer 2-5K tokens.
• skipWhenBusy: wanneer true worden Heartbeat-runs uitgesteld op de extra bezette lanes van die agent: het eigen sessie-gesleutelde subagent- of geneste opdrachtwerk. 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 },
        midTurnPrecheck: { enabled: false }, // optional Pi tool-loop pressure check
        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 (chunkgewijze 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 de ingebouwde versie. Het instellen van een provider dwingt mode: "safeguard" af. Zie Compaction.
• timeoutSeconds: maximaal aantal seconden dat is toegestaan voor één Compaction-bewerking voordat OpenClaw deze afbreekt. Standaard: 900.
• keepRecentTokens: Pi-knippuntbudget om de meest recente transcriptstaart letterlijk te behouden. Handmatige /compact respecteert dit wanneer het expliciet is ingesteld; anders is handmatige Compaction een harde checkpoint.
• identifierPolicy: strict (standaard), off of custom. strict voegt ingebouwde richtlijnen voor behoud van ondoorzichtige identifiers vooraan toe tijdens Compaction-samenvatting.
• identifierInstructions: optionele aangepaste tekst voor identifierbehoud die wordt gebruikt wanneer identifierPolicy=custom.
• qualityGuard: controles met opnieuw proberen bij misvormde uitvoer voor safeguard-samenvattingen. Standaard ingeschakeld in safeguard-modus; stel enabled: false in om de audit over te slaan.
• midTurnPrecheck: optionele Pi-tool-loop-drukcontrole. Wanneer enabled: true controleert OpenClaw de contextdruk nadat toolresultaten zijn toegevoegd en vóór de volgende modelaanroep. Als de context niet langer past, breekt het de huidige poging af voordat de prompt wordt ingediend en hergebruikt het het bestaande precheck-herstelpad om toolresultaten af te kappen of te comprimeren en opnieuw te proberen. Werkt met zowel default- als safeguard-Compaction-modi. Standaard: uitgeschakeld.
• postCompactionSections: optionele AGENTS.md H2/H3-sectienamen om na Compaction opnieuw te injecteren. Standaard ["Session Startup", "Red Lines"]; stel [] in om herinjectie uit te schakelen. Wanneer oningesteld of expliciet ingesteld op dat standaardpaar, worden oudere koppen Every Session/Safety ook geaccepteerd als legacy fallback.
• model: optionele override provider/model-id alleen voor Compaction-samenvatting. Gebruik dit wanneer de hoofdsessie één model moet behouden, maar Compaction-samenvattingen op een ander model moeten draaien; wanneer oningesteld gebruikt Compaction het primaire model van de sessie.
• maxActiveTranscriptBytes: optionele byte-drempel (number of tekenreeksen zoals "20mb") die normale lokale Compaction vóór een run activeert wanneer de actieve JSONL voorbij de drempel groeit. Vereist truncateAfterCompaction zodat succesvolle Compaction kan roteren naar een kleiner opvolgtranscript. Uitgeschakeld wanneer oningesteld of 0.
• notifyUser: wanneer true, stuurt korte meldingen naar de gebruiker wanneer Compaction start en wanneer deze is voltooid (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 actieve fallback-keten van de sessie niet. Wordt overgeslagen wanneer de workspace read-only is.

​

agents.defaults.runRetries

{
  agents: {
    defaults: {
      runRetries: {
        base: 24,
        perProfile: 8,
        min: 32,
        max: 160,
      },
    },
    list: [
      {
        id: "main",
        runRetries: { max: 50 }, // optional per-agent overrides
      },
    ],
  },
}

• base: basisaantal run-retry-iteraties voor de buitenste run-loop. Standaard: 24.
• perProfile: extra run-retry-iteraties toegekend per fallback-profielkandidaat. Standaard: 8.
• min: minimale absolute limiet voor run-retry-iteraties. Standaard: 32.
• max: maximale absolute limiet voor run-retry-iteraties om ontsporende uitvoering te voorkomen. Standaard: 160.

​

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.
• Kanaaloverschrijvingen: channels.<channel>.blockStreamingCoalesce (en varianten per account). Signal/Slack/Discord/Google Chat gebruiken standaard minChars: 1500.
• humanDelay: willekeurige pauze tussen blokantwoorden. natural = 800–2500 ms. Overschrijving per agent: agents.list[].humanDelay.

​

Typindicatoren

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

• Standaardwaarden: instant voor directe chats/vermeldingen, message voor niet-vermelde groepschats.
• 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
        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 wordt gelogd). Als er geen is ingesteld, is het eerste lijstitem de standaard.
• model: stringvorm stelt een strikte primaire per agent in zonder model-fallback; objectvorm { primary } is ook strikt tenzij je fallbacks toevoegt. Gebruik { primary, fallbacks: [...] } om die agent fallback te laten gebruiken, 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 die worden samengevoegd over de geselecteerde modelvermelding in agents.defaults.models. Gebruik dit voor agentspecifieke overrides zoals cacheRetention, temperature of maxTokens zonder de hele modelcatalogus te dupliceren.
• tts: optionele text-to-speech-overrides per agent. Het blok wordt diep samengevoegd over messages.tts, dus bewaar gedeelde provider-aanmeldgegevens en fallbackbeleid in messages.tts en stel hier alleen personaspecifieke waarden in, zoals provider, stem, model, stijl of automatische modus.
• skills: optionele allowlist voor Skills per agent. Indien weggelaten, erft de agent agents.defaults.skills wanneer dit is ingesteld; een expliciete lijst vervangt standaardwaarden in plaats van samen te voegen, en [] betekent geen Skills.
• thinkingDefault: optioneel standaard-denkniveau per agent (off | minimal | low | medium | high | xhigh | adaptive | max). Overschrijft agents.defaults.thinkingDefault voor deze agent wanneer er geen override per bericht of sessie is ingesteld. Het geselecteerde provider-/modelprofiel bepaalt welke waarden geldig zijn; voor Google Gemini behoudt adaptive providerbeheerd dynamisch denken (thinkingLevel weggelaten op Gemini 3/3.1, thinkingBudget: -1 op Gemini 2.5).
• reasoningDefault: optionele standaardzichtbaarheid voor redeneren per agent (on | off | stream). Overschrijft agents.defaults.reasoningDefault voor deze agent wanneer er geen reasoning-override per bericht of sessie is ingesteld.
• fastModeDefault: optionele standaard voor snelle modus per agent (true | false). Is van toepassing wanneer er geen fast-mode-override per bericht of sessie is ingesteld.
• models: optionele modelcatalogus-/runtime-overrides per agent, gesleuteld op volledige provider/model-ids. Gebruik models["provider/model"].agentRuntime voor runtime-uitzonderingen per agent.
• runtime: optionele runtime-descriptor per agent. Gebruik type: "acp" met runtime.acp-standaardwaarden (agent, backend, mode, cwd) wanneer de agent standaard ACP-harnesssessies moet gebruiken.
• identity.avatar: workspace-relatief pad, http(s)-URL of data:-URI.
• identity leidt standaardwaarden af: ackReaction uit emoji, mentionPatterns uit name/emoji.
• subagents.allowAgents: allowlist van agent-ids voor expliciete sessions_spawn.agentId-doelen (["*"] = elke; standaard: alleen dezelfde agent). Neem de requester-id op wanneer zelfgerichte agentId-aanroepen moeten worden toegestaan.
• 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: false).

​

Multi-agentroutering

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

​

Matchvelden voor bindingen

• type (optioneel): route voor normale routering (ontbrekend type is standaard route), acp voor permanente ACP-gespreksbindingen.
• 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",
    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 | queue (legacy one-at-a-time) | followup | collect | steer-backlog | steer+backlog | 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

​

Ack-reactie

• Standaard de 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 → identiteitsfallback.
• Bereik: group-mentions (standaard), group-all, direct, all.
• removeAckAfterReply: verwijdert de ack na een antwoord op kanalen met reactieondersteuning zoals Slack, Discord, Telegram, WhatsApp en iMessage.
• messages.statusReactions.enabled: schakelt levenscyclusstatusreacties in op Slack, Discord en Telegram. Op Slack en Discord blijven statusreacties ingeschakeld wanneer ack-reacties actief zijn, als dit niet is ingesteld. Stel dit op Telegram expliciet in op true om levenscyclusstatusreacties 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 bepaalt de standaard auto-TTS-modus: 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 is standaard 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-provider-Plugin op die je wilt gebruiken, bijvoorbeeld microsoft voor Edge TTS. De legacy 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.

​

Talk

{
  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: {},
    },
    consultThinkingLevel: "low",
    consultFastMode: true,
    speechLocale: "ru-RU",
    silenceTimeoutMs: 1500,
    interruptOnSpeech: true,
    realtime: {
      provider: "openai",
      providers: {
        openai: {
          model: "gpt-realtime-2",
          voice: "cedar",
        },
      },
      instructions: "Speak warmly and keep answers brief.",
      mode: "realtime",
      transport: "webrtc",
      brain: "agent-consult",
    },
  },
}

• talk.provider moet overeenkomen met een sleutel in talk.providers wanneer meerdere Talk-providers zijn geconfigureerd.
• Legacy platte Talk-sleutels (talk.voiceId, talk.voiceAliases, talk.modelId, talk.outputFormat, talk.apiKey) zijn alleen voor compatibiliteit. Voer openclaw doctor --fix uit om opgeslagen configuratie te herschrijven naar talk.providers.<provider>.
• Stem-ID’s vallen terug op ELEVENLABS_VOICE_ID of SAG_VOICE_ID.
• providers.*.apiKey accepteert plaintext strings of SecretRef-objecten.
• ELEVENLABS_API_KEY-fallback 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 door de lokale MLX-helper op macOS wordt gebruikt. Als dit wordt weggelaten, gebruikt macOS mlx-community/Soprano-80M-bf16.
• MLX-afspelen op macOS loopt via de meegeleverde openclaw-mlx-tts-helper wanneer aanwezig, of via een uitvoerbaar bestand op PATH; OPENCLAW_MLX_TTS_BIN overschrijft het helperpad voor ontwikkeling.
• consultThinkingLevel bepaalt het denkniveau voor de volledige OpenClaw-agentrun achter Control UI Talk realtime openclaw_agent_consult-aanroepen. Laat dit niet ingesteld om normaal sessie-/modelgedrag te behouden.
• consultFastMode stelt een eenmalige fast-mode-overschrijving in voor Control UI Talk realtime-consults zonder de normale fast-mode-instelling van de sessie te wijzigen.
• speechLocale stelt de BCP 47-locale-id in die wordt gebruikt door iOS/macOS Talk-spraakherkenning. Laat dit niet ingesteld om de apparaatstandaard te gebruiken.
• silenceTimeoutMs bepaalt hoelang Talk-modus wacht na stilte van de gebruiker voordat het transcript wordt verzonden. Niet ingesteld behoudt het standaard pauzevenster van het platform (700 ms op macOS en Android, 900 ms op iOS).
• realtime.instructions voegt providergerichte systeeminstructies toe aan de ingebouwde realtime-prompt van OpenClaw, zodat stemstijl kan worden geconfigureerd zonder de standaard openclaw_agent_consult-richtlijnen te verliezen.

​

Gerelateerd

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