Configuratie — agenten

​

Agentstandaarden

​

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" }, // erft github, weather
      { id: "docs", skills: ["docs-search"] }, // vervangt standaarden
      { id: "locked-down", skills: [] }, // geen skills
    ],
  },
}

• Laat agents.defaults.skills weg voor standaard onbeperkte Skills.
• Laat agents.list[].skills weg om de standaarden 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 standaarden.

​

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 werkruimtebootstrap over, waardoor de promptgrootte kleiner wordt. Heartbeat-runs en nieuwe pogingen na Compaction bouwen de context nog steeds opnieuw op.
• "never": schakel werkruimtebootstrap 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 opbouwen, 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: 20000 } },
}

​

agents.defaults.bootstrapTotalMaxChars

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

​

Overrides voor bootstrapprofielen per agent

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

​

agents.defaults.bootstrapPromptTruncationWarning

• "off": injecteer nooit tekst voor een afkappingsmelding in de systeemprompt.
• "once": injecteer eenmaal per unieke afkappingssignatuur een beknopte melding.
• "always": injecteer bij elke run een beknopte melding wanneer er afkapping is (aanbevolen).

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

​

Eigenaarschapskaart voor contextbudgetten

• agents.defaults.bootstrapMaxChars / agents.defaults.bootstrapTotalMaxChars: normale injectie van werkruimtebootstrap.
• agents.defaults.startupContext.*: eenmalige prelude voor reset-/opstartmodelrun, inclusief recente dagelijkse memory/*.md-bestanden. Kale chatcommando’s /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.*: grootte voor geïndexeerde geheugenzoekfragmenten en injectie.

• agents.list[].skillsLimits.maxSkillsPromptChars
• agents.list[].contextInjection
• agents.list[].bootstrapMaxChars
• agents.list[].bootstrapTotalMaxChars
• 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,
        postCompactionMaxChars: 1800,
      },
    },
  },
}

• memoryGetMaxChars: standaardlimiet voor memory_get-fragmenten voordat afkappings- metadata en vervolgmelding worden toegevoegd.
• memoryGetDefaultLines: standaardregelvenster voor memory_get wanneer lines is weggelaten.
• toolResultMaxChars: geavanceerd plafond voor live toolresultaten, gebruikt voor vastgelegde resultaten en herstel bij overflow. Laat dit oningesteld voor de automatische modelcontextlimiet: 16000 tekens onder 100K tokens, 32000 tekens bij 100K+ tokens en 64000 tekens bij 200K+ tokens. Expliciete waarden tot 1000000 worden geaccepteerd voor modellen met lange context, maar de effectieve limiet blijft beperkt tot ongeveer 30% van het contextvenster van het model. openclaw doctor --deep toont de effectieve limiet, en doctor waarschuwt alleen wanneer een expliciete override verouderd is of geen effect heeft.
• postCompactionMaxChars: limiet voor AGENTS.md-fragmenten die wordt gebruikt tijdens refresh-injectie na Compaction.

​

agents.list[].contextLimits

{
  agents: {
    defaults: {
      contextLimits: {
        memoryGetMaxChars: 12000,
      },
    },
    list: [
      {
        id: "tiny-local",
        contextLimits: {
          memoryGetMaxChars: 6000,
          toolResultMaxChars: 8000, // geavanceerd plafond voor deze agent
        },
      },
    ],
  },
}

​

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.imageQuality

• auto: aanpassen aan modellimieten en aantal afbeeldingen.
• efficient: geef de voorkeur aan kleinere afbeeldingen voor lager token- en bytegebruik.
• balanced: gebruik de standaard middenweg-ladder.
• high: behoud meer detail voor screenshots, diagrammen en documentafbeeldingen.

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

​

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" }, // globale standaardproviderparams
      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 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 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 geconfigureerde invoer met afbeeldingsmogelijkheden in models.providers.*.models, kwalificeert OpenClaw het voor die provider. Ambigue geconfigureerde overeenkomsten vereisen een expliciet providerprefix.
• imageGenerationModel: accepteert een tekenreeks ("provider/model") of een object ({ primary, fallbacks }).
  • Gebruikt door de gedeelde mogelijkheid voor afbeeldingsgeneratie 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 bijpassende 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/*).
  • Indien weggelaten, kan image_generate nog steeds een door authenticatie ondersteunde providerstandaard afleiden. Eerst wordt de huidige standaardprovider geprobeerd, daarna de resterende geregistreerde providers voor afbeeldingsgeneratie in volgorde van provider-ID.
• musicGenerationModel: accepteert een tekenreeks ("provider/model") of een object ({ primary, fallbacks }).
  • 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.
  • Indien weggelaten, kan music_generate nog steeds een door authenticatie ondersteunde providerstandaard afleiden. Eerst wordt de huidige standaardprovider geprobeerd, daarna de resterende geregistreerde providers voor muziekgeneratie in volgorde van provider-ID.
  • Als je rechtstreeks een provider/model selecteert, configureer dan ook de bijpassende providerauthenticatie/API-sleutel.
• videoGenerationModel: accepteert een tekenreeks ("provider/model") of een object ({ primary, fallbacks }).
  • 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.
  • Indien weggelaten, kan video_generate nog steeds een door authenticatie ondersteunde providerstandaard afleiden. Eerst wordt de huidige standaardprovider geprobeerd, daarna de resterende geregistreerde providers voor videogeneratie in volgorde van provider-ID.
  • Als je rechtstreeks een provider/model selecteert, configureer dan ook de bijpassende providerauthenticatie/API-sleutel.
  • De officiele Qwen-Plugin voor videogeneratie ondersteunt maximaal 1 uitvoervideo, 1 invoerafbeelding, 4 invoervideo’s, een duur van 10 seconden en provideropties op niveau 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 aanroeptijd wordt doorgegeven.
• pdfMaxPages: standaard maximaal aantal pagina’s dat door de extractie-fallbackmodus in de pdf-tool wordt meegenomen.
• 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 geen redeneringsoverschrijving 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 OpenAI API-sleutel- of Codex OAuth-toegang). 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 het eerste geconfigureerde provider/model in plaats van een verouderde, verwijderde providerstandaard te tonen.
• models: de geconfigureerde modelcatalogus en allowlist voor /model. Elke invoer kan alias (snelkoppeling) en params bevatten (providerspecifiek, bijvoorbeeld temperature, maxTokens, cacheRetention, context1m, responsesServerCompaction, responsesCompactThreshold, OpenRouter provider-routering, chat_template_kwargs, extra_body/extraBody).
  • Gebruik provider/*-vermeldingen zoals "openai/*": {} of "vllm/*": {} om alle ontdekte modellen voor geselecteerde providers te tonen zonder elk model-ID handmatig te vermelden.
  • Voeg agentRuntime toe aan een provider/*-vermelding wanneer elk dynamisch ontdekt model voor die provider dezelfde runtime moet gebruiken. Exact provider/model-runtimebeleid wint nog steeds van de wildcard.
  • 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 meegeeft.
  • Providergerichte 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 toegepast op alle modellen. Ingesteld bij 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.
• models.providers.openrouter.params.provider: OpenRouter-brede standaardpolicy voor providerroutering. OpenClaw stuurt dit door naar OpenRouter’s aanvraagobject provider; per-model agents.defaults.models["openrouter/<model>"].params.provider en agentparameters overschrijven per sleutel. Zie OpenRouter-providerroutering.
• params.extra_body/params.extraBody: geavanceerde doorvoer-JSON die wordt samengevoegd in api: "openai-completions"-aanvraaglichamen voor OpenAI-compatibele proxy’s. Als dit botst met gegenereerde aanvraagsleutels, 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"-aanvraaglichamen. Voor vllm/nemotron-3-* met denken 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 laatste prioriteit. Geconfigureerde vLLM Qwen- en Nemotron-denkmodellen tonen binaire /think-keuzes (off, on) in plaats van de inspanningsladder met meerdere niveaus.
• compat.thinkingFormat: OpenAI-compatibele stijl voor denkpayloads. Gebruik "together" voor Together-stijl reasoning.enabled, "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 aanvraagniveau ondersteunen, zoals vLLM. OpenClaw mapt uitgeschakeld denken naar false en ingeschakeld denken naar true, en geconfigureerde vLLM Qwen-modellen tonen binaire /think-keuzes voor deze indelingen.
• compat.supportedReasoningEfforts: per-model OpenAI-compatibele lijst met redeneerinspanning. Neem "xhigh" op voor aangepaste endpoints die dit echt accepteren; OpenClaw toont dan /think xhigh in opdrachtmenu’s, Gateway-sessierijen, sessiepatchvalidatie, agent-CLI-validatie en llm-task-validatie voor die geconfigureerde provider/model. Gebruik compat.reasoningEffortMap wanneer de backend een providerspecifieke waarde voor een canoniek niveau verwacht.
• params.preserveThinking: Z.AI-only opt-in voor behouden denken. Wanneer ingeschakeld en denken aan staat, stuurt OpenClaw thinking.clear_thinking: false en speelt eerdere reasoning_content opnieuw af; zie Z.AI-denken en behouden denken.
• 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 down is, wacht maximaal readyTimeoutMs en stuurt daarna de modelaanvraag. command moet een absoluut pad zijn. idleStopMs: 0 houdt het proces in leven 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 officiele OpenAI-provider selecteren standaard Codex.
• Configuratieschrijvers die deze velden wijzigen (bijvoorbeeld /models set, /models set-image en opdrachten om fallbacks toe te voegen/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.

​

Runtimebeleid

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

• id: "auto", "openclaw", een geregistreerde 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 turns claimen en gebruikt OpenClaw wanneer geen harness overeenkomt. Een expliciete plugin-runtime zoals id: "codex" vereist die harness en faalt gesloten als deze niet beschikbaar is of faalt.
• id: "pi" wordt alleen geaccepteerd als verouderde alias voor openclaw om geleverde configs uit v2026.5.22 en eerder te behouden. Nieuwe config moet openclaw gebruiken.
• Runtime-voorrang is eerst exact modelbeleid (agents.list[].models["provider/model"], agents.defaults.models["provider/model"], of models.providers.<provider>.models[]), daarna agents.list[] / agents.defaults.models["provider/*"], daarna providerbreed beleid op models.providers.<provider>.agentRuntime.
• Runtime-sleutels voor hele agents zijn legacy. agents.defaults.agentRuntime, agents.list[].agentRuntime, sessie-runtime-pins en OPENCLAW_AGENT_RUNTIME worden genegeerd door runtime-selectie. 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-8" plus model-scoped agentRuntime.id: "claude-cli". Legacy claude-cli/claude-opus-4-7-modelverwijzingen werken nog voor compatibiliteit, maar nieuwe config moet provider/model-selectie canoniek houden en de uitvoeringsbackend in provider/model-runtimebeleid plaatsen.
• Dit regelt alleen uitvoering van tekst-agent-turns. Mediageneratie, vision, PDF, muziek, video en TTS gebruiken nog steeds hun provider/model-instellingen.

​

agents.defaults.cliBackends

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

• CLI-backends zijn tekst-eerst; tools zijn altijd uitgeschakeld.
• Sessies worden ondersteund wanneer sessionArg is ingesteld.
• Image-pass-through wordt ondersteund wanneer imageArg bestandspaden accepteert.
• reseedFromRawTranscriptWhenUncompacted: true laat een backend veilige ongeldig gemaakte sessies herstellen vanuit een begrensde raw OpenClaw-transcriptstaart voordat de eerste Compaction-samenvatting bestaat. Wijzigingen in auth-profiel of credential epoch gebruiken nog steeds nooit raw reseeding.

​

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: duurstring (ms/s/m/h). Standaard: 30m (API-key-auth) of 1h (OAuth-auth). Stel in op 0m om uit te schakelen.
• includeSystemPromptSection: wanneer false, laat de Heartbeat-sectie weg uit de system prompt en slaat HEARTBEAT.md-injectie in bootstrapcontext over. Standaard: true.
• suppressToolErrorWarnings: wanneer true, onderdrukt waarschuwingpayloads voor toolfouten tijdens Heartbeat-runs.
• timeoutSeconds: maximale tijd in seconden toegestaan voor een Heartbeat-agent-turn voordat deze wordt afgebroken. Laat niet ingesteld om agents.defaults.timeoutSeconds te gebruiken wanneer ingesteld, anders de Heartbeat-cadans afgetopt op 600 seconden.
• directPolicy: direct/DM-bezorgbeleid. allow (standaard) staat bezorging naar directe targets toe. block onderdrukt bezorging naar directe targets en geeft reason=dm-blocked uit.
• lightContext: wanneer true, gebruiken Heartbeat-runs lichtgewicht bootstrapcontext en behouden alleen HEARTBEAT.md uit workspace-bootstrapbestanden.
• isolatedSession: wanneer true, 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 true, stellen Heartbeat-runs uit op de extra drukke lanes van die agent: zijn eigen session-keyed subagent- of nested command-werk. Cron-lanes stellen Heartbeats altijd uit, ook zonder deze vlag.
• Per agent: stel agents.list[].heartbeat in. Wanneer een agent heartbeat definieert, voeren alleen die agents Heartbeats uit.
• Heartbeats draaien volledige agent-turns — 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: 180,
        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 tool-loop pressure check
        postCompactionSections: ["Session Startup", "Red Lines"], // opt in to AGENTS.md section 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 de ingebouwde LLM-samenvatting. Valt bij een fout terug op de ingebouwde samenvatting. Het instellen van een provider forceert mode: "safeguard". Zie Compaction.
• timeoutSeconds: maximaal aantal seconden dat is toegestaan voor een enkele compaction-bewerking voordat OpenClaw deze afbreekt. Standaard: 180.
• keepRecentTokens: cut-pointbudget van de agent om de meest recente transcriptstaart letterlijk te behouden. Handmatige /compact respecteert dit wanneer het expliciet is ingesteld; anders is handmatige compaction een hard controlepunt.
• identifierPolicy: strict (standaard), off of custom. strict voegt ingebouwde richtlijnen voor het behouden van ondoorzichtige identifiers toe vóór de 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 drukcontrole voor de tool-loop. 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 compacten en opnieuw te proberen. Werkt met zowel default- als safeguard-compactionmodi. Standaard: uitgeschakeld.
• postCompactionSections: optionele AGENTS.md H2/H3-sectienamen om na compaction opnieuw in te voegen. Opnieuw invoegen is uitgeschakeld wanneer niet ingesteld of ingesteld op []. Expliciet instellen op ["Session Startup", "Red Lines"] schakelt dat paar in en behoudt de legacy Every Session/Safety-fallback. Schakel dit alleen in wanneer de extra context het risico waard is dat projectrichtlijnen worden gedupliceerd die al in de compaction-samenvatting zijn vastgelegd.
• model: optionele provider/model-id of kale alias uit agents.defaults.models, alleen voor compaction-samenvatting. Kale aliassen worden vóór dispatch opgelost; geconfigureerde letterlijke model-id’s behouden voorrang bij botsingen. Gebruik dit wanneer de hoofdsessie één model moet blijven gebruiken 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 strings zoals "20mb") die normale lokale compaction vóór een run activeert wanneer de actieve JSONL boven de drempel groeit. Vereist truncateAfterCompaction, zodat succesvolle compaction kan roteren naar een kleiner opvolgend transcript. Uitgeschakeld wanneer niet ingesteld of 0.
• notifyUser: wanneer true, stuurt korte meldingen naar de gebruiker wanneer compaction start en wanneer deze voltooid is (bijvoorbeeld “Compacting context…” en “Compaction complete”). Standaard uitgeschakeld om compaction stil te houden.
• memoryFlush: stille agentische beurt vóór auto-compaction om duurzame herinneringen op te slaan. Stel model in op een exacte provider/model zoals ollama/qwen3:8b wanneer deze housekeeping-beurt op een lokaal model moet blijven; de override erft de fallbackketen van de actieve sessie niet. Overgeslagen wanneer de werkruimte alleen-lezen 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 retry-iteraties voor de buitenste run-loop. Standaard: 24.
• perProfile: extra retry-iteraties die per kandidaat-fallbackprofiel worden toegekend. Standaard: 8.
• min: minimale absolute limiet voor retry-iteraties. Standaard: 32.
• max: maximale absolute limiet voor retry-iteraties om op hol geslagen 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.
• Kanaaloverrides: channels.<channel>.blockStreamingCoalesce (en varianten per account). Signal/Slack/Discord/Google Chat gebruiken standaard minChars: 1500.
• humanDelay: gerandomiseerde pauze tussen blokantwoorden. natural = 800-2500 ms. 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.
• Overrides 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 (per-agent overrides)

{
  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: { speakerVoiceId: "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: stringvorm stelt een strikte per-agent primaire in zonder modelfallback; 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 standaardfallbacks tenzij je fallbacks: [] instelt.
• params: per-agent streamparameters samengevoegd over de geselecteerde modelvermelding in agents.defaults.models. Gebruik dit voor agent-specifieke overrides zoals cacheRetention, temperature of maxTokens zonder de volledige modelcatalogus te dupliceren.
• tts: optionele per-agent tekst-naar-spraakoverrides. Het blok wordt diep samengevoegd over messages.tts, dus bewaar 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 per-agent skill-allowlist. Indien weggelaten, erft de agent agents.defaults.skills wanneer ingesteld; een expliciete lijst vervangt standaarden in plaats van 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 per-bericht- of sessie-override 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 voor redenering per agent (on | off | stream). Overschrijft agents.defaults.reasoningDefault voor deze agent wanneer er geen per-bericht- of sessieredenerings-override is ingesteld.
• fastModeDefault: optionele per-agent standaard voor snelle modus ("auto" | true | false). Geldt wanneer er geen per-bericht- of sessie-override voor snelle modus is ingesteld.
• models: optionele per-agent modelcatalogus-/runtime-overrides, gesleuteld op volledige provider/model-id’s. Gebruik models["provider/model"].agentRuntime voor per-agent runtime-uitzonderingen.
• runtime: optionele per-agent runtimebeschrijving. Gebruik type: "acp" met runtime.acp-standaarden (agent, backend, mode, cwd) wanneer de agent standaard ACP-harnesssessies moet gebruiken.
• identity.avatar: werkruimte-relatief pad, http(s)-URL of data:-URI.
• Lokale werkruimte-relatieve identity.avatar-afbeeldingsbestanden zijn beperkt tot 2 MB. http(s)-URL’s en data:-URI’s worden niet gecontroleerd met de lokale bestandsgroottelimiet.
• identity leidt standaarden af: ackReaction uit emoji, mentionPatterns uit name/emoji.
• subagents.allowAgents: allowlist van geconfigureerde agent-id’s voor expliciete sessions_spawn.agentId-doelen (["*"] = elk geconfigureerd doel; standaard: alleen dezelfde agent). Neem de requester-id op wanneer zelfgerichte agentId-aanroepen toegestaan moeten zijn. Verouderde vermeldingen waarvan de agentconfiguratie is verwijderd, worden door sessions_spawn geweigerd en uit agents_list weggelaten; voer openclaw doctor --fix uit om ze op te schonen, of voeg een minimale agents.list[]-vermelding toe als dat doel spawnbaar moet blijven terwijl het standaarden erft.
• Sandbox-overervingsbeveiliging: als de requester-sessie in een sandbox draait, weigert sessions_spawn doelen die zonder sandbox zouden draaien.
• subagents.requireAgentId: wanneer true, blokkeer sessions_spawn-aanroepen die agentId weglaten (dwingt expliciete profielselectie af; standaard: false).

​

Multi-agent routing

{
  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 routing (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

​

Per-agent toegangsprofielen

{
  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: "enforce", // enforce (default) | warn
      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: "followup", // steer | followup | collect | interrupt
      debounceMs: 500,
      cap: 20,
      drop: "summarize", // old | new | summarize
      byChannel: {
        whatsapp: "followup",
        telegram: "followup",
      },
    },
    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.
• Overrides per kanaal: channels.<channel>.ackReaction, channels.<channel>.accounts.<id>.ackReaction.
• Resolutievolgorde: account → kanaal → messages.ackReaction → fallback op identiteit.
• Bereik: group-mentions (standaard), group-all, direct, all.
• removeAckAfterReply: verwijdert ack na antwoord op kanalen met reactiemogelijkheid zoals Slack, Discord, Signal, Telegram, WhatsApp en iMessage.
• messages.statusReactions.enabled: schakelt levenscyclusstatusreacties in op Slack, Discord, Signal, Telegram en WhatsApp. Op Slack en Discord blijven statusreacties ingeschakeld wanneer ack-reacties actief zijn als dit niet is ingesteld. Op Signal, Telegram en WhatsApp moet je dit expliciet op true zetten om levenscyclusstatusreacties in te schakelen.
• messages.statusReactions.emojis: overschrijft levenscyclus-emoji-sleutels: queued, thinking, compacting, tool, coding, web, deploy, build, concierge, done, error, stallSoft en stallHard. Telegram staat alleen een vaste reactieset toe, dus niet-ondersteunde geconfigureerde emoji vallen terug op de dichtstbijzijnde ondersteunde statusvariant voor die chat.

​

Inbound-debounce

​

TTS (tekst-naar-spraak)

{
  messages: {
    tts: {
      auto: "always", // off | always | inbound | tagged
      mode: "final", // final | all
      provider: "elevenlabs",
      summaryModel: "openai/gpt-5.4-mini",
      modelOverrides: { enabled: true },
      maxTextLength: 4000,
      timeoutMs: 30000,
      prefsPath: "~/.openclaw/settings/tts.json",
      providers: {
        elevenlabs: {
          apiKey: "elevenlabs_api_key",
          baseUrl: "https://api.elevenlabs.io",
          speakerVoiceId: "voice_id",
          modelId: "eleven_multilingual_v2",
          seed: 42,
          applyTextNormalization: "auto",
          languageCode: "en",
          voiceSettings: {
            stability: 0.5,
            similarityBoost: 0.75,
            style: 0.0,
            useSpeakerBoost: true,
            speed: 1.0,
          },
        },
        microsoft: {
          speakerVoice: "en-US-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",
          speakerVoice: "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 is standaard false (expliciet inschakelen).
• API-sleutels vallen terug op ELEVENLABS_API_KEY/XI_API_KEY en OPENAI_API_KEY.
• Meegeleverde spraakproviders worden door plugins beheerd. 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 de validatie van model en stem.

​

Praten

{
  talk: {
    provider: "elevenlabs",
    providers: {
      elevenlabs: {
        speakerVoiceId: "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",
          speakerVoice: "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 praatproviders zijn geconfigureerd.
• Verouderde platte praatkeys (talk.voiceId, talk.voiceAliases, talk.modelId, talk.outputFormat, talk.apiKey) zijn alleen bedoeld 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 plattetekstreeksen of SecretRef-objecten.
• De fallback ELEVENLABS_API_KEY geldt alleen wanneer er geen Talk-API-sleutel is geconfigureerd.
• Met providers.*.voiceAliases kunnen praatrichtlijnen gebruikmaken van vriendelijke namen.
• providers.mlx.modelId selecteert de Hugging Face-repository die wordt gebruikt door de lokale MLX-helper op macOS. Als dit wordt weggelaten, gebruikt macOS mlx-community/Soprano-80M-bf16.
• MLX-weergave op macOS loopt via de meegeleverde helper openclaw-mlx-tts wanneer die aanwezig is, of via een uitvoerbaar bestand op PATH; OPENCLAW_MLX_TTS_BIN overschrijft het helperpad voor ontwikkeling.
• consultThinkingLevel beheert het denkniveau voor de volledige OpenClaw-agentuitvoering achter realtime openclaw_agent_consult-aanroepen van Control UI Talk. Laat dit oningesteld om normaal sessie- en modelgedrag te behouden.
• consultFastMode stelt een eenmalige fast-mode-overschrijving in voor realtime consulten van Control UI Talk zonder de normale fast-mode-instelling van de sessie te wijzigen.
• speechLocale stelt de BCP 47-locale-id in die wordt gebruikt door spraakherkenning van iOS/macOS Talk. Laat dit oningesteld om de apparaatstandaard te gebruiken.
• silenceTimeoutMs bepaalt hoe lang de praatmodus na stilte van de gebruiker wacht voordat het transcript wordt verzonden. Oningesteld blijft de standaardpauzeperiode van het platform behouden (700 ms on macOS and Android, 900 ms on iOS).
• realtime.instructions voegt providergerichte systeeminstructies toe aan de ingebouwde realtime prompt van OpenClaw, zodat de stemstijl kan worden geconfigureerd zonder standaardbegeleiding voor openclaw_agent_consult te verliezen.
• realtime.consultRouting beheert de Gateway-relayfallback wanneer de realtime provider een definitief gebruikerstranscript produceert zonder openclaw_agent_consult: provider-direct behoudt directe providerantwoorden, terwijl force-agent-consult het afgeronde verzoek via OpenClaw routeert.

​

Gerelateerd

• Configuratiereferentie — alle andere configuratiekeys
• Configuratie — algemene taken en snelle installatie
• Configuratievoorbeelden