Configuración — agentes

Documentation Index

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

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

​

Valores predeterminados del agente

​

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

• Omite agents.defaults.skills para permitir Skills sin restricciones de forma predeterminada.
• Omite agents.list[].skills para heredar los valores predeterminados.
• Establece agents.list[].skills: [] para no usar Skills.
• Una lista no vacía de agents.list[].skills es el conjunto final para ese agente; no se combina con los valores predeterminados.

​

agents.defaults.skipBootstrap

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

​

agents.defaults.skipOptionalBootstrapFiles

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

​

agents.defaults.contextInjection

• "continuation-skip": los turnos de continuación seguros (después de una respuesta completada del asistente) omiten la reinyección de inicialización del espacio de trabajo, lo que reduce el tamaño del prompt. Las ejecuciones de Heartbeat y los reintentos posteriores a la Compaction siguen reconstruyendo el contexto.
• "never": desactiva la inicialización del espacio de trabajo y la inyección de archivos de contexto en cada turno. Usa esto solo para agentes que controlan por completo el ciclo de vida de su prompt (motores de contexto personalizados, runtimes nativos que construyen su propio contexto o flujos de trabajo especializados sin inicialización). Los turnos de Heartbeat y recuperación de Compaction también omiten la inyección.

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

​

agents.defaults.bootstrapMaxChars

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

​

agents.defaults.bootstrapTotalMaxChars

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

​

agents.defaults.bootstrapPromptTruncationWarning

• "off": nunca inyecta texto de aviso de truncamiento en el prompt del sistema.
• "once": inyecta un aviso conciso una vez por cada firma de truncamiento única (recomendado).
• "always": inyecta un aviso conciso en cada ejecución cuando existe truncamiento.

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

​

Mapa de propiedad del presupuesto de contexto

• agents.defaults.bootstrapMaxChars / agents.defaults.bootstrapTotalMaxChars: inyección normal de inicialización del espacio de trabajo.
• agents.defaults.startupContext.*: preámbulo único de ejecución de modelo al restablecer/iniciar, incluidos los archivos recientes diarios memory/*.md. Los comandos de chat sin argumentos /new y /reset se reconocen sin invocar el modelo.
• skills.limits.*: la lista compacta de Skills inyectada en el prompt del sistema.
• agents.defaults.contextLimits.*: extractos acotados de runtime y bloques inyectados propiedad del runtime.
• memory.qmd.limits.*: fragmento de búsqueda de memoria indexado y dimensionamiento de inyección.

• 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: límite predeterminado del extracto de memory_get antes de agregar metadatos de truncamiento y aviso de continuación.
• memoryGetDefaultLines: ventana de líneas predeterminada de memory_get cuando se omite lines.
• toolResultMaxChars: límite de resultado de herramienta en vivo usado para resultados persistidos y recuperación de desbordamiento.
• postCompactionMaxChars: límite del extracto de AGENTS.md usado durante la inyección de actualización posterior a la 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: acepta una cadena ("provider/model") o un objeto ({ primary, fallbacks }).
  • La forma de cadena establece solo el modelo principal.
  • La forma de objeto establece el principal más modelos de conmutación por error ordenados.
• imageModel: acepta una cadena ("provider/model") o un objeto ({ primary, fallbacks }).
  • Lo usa la ruta de la herramienta image como su configuración de modelo de visión.
  • También se usa como enrutamiento de respaldo cuando el modelo seleccionado/predeterminado no puede aceptar entrada de imagen.
  • Prefiere referencias provider/model explícitas. Los identificadores sin prefijo se aceptan por compatibilidad; si un identificador sin prefijo coincide de forma única con una entrada configurada compatible con imágenes en models.providers.*.models, OpenClaw lo califica para ese proveedor. Las coincidencias configuradas ambiguas requieren un prefijo de proveedor explícito.
• imageGenerationModel: acepta una cadena ("provider/model") o un objeto ({ primary, fallbacks }).
  • Lo usan la capacidad compartida de generación de imágenes y cualquier superficie futura de herramienta/Plugin que genere imágenes.
  • Valores típicos: google/gemini-3.1-flash-image-preview para la generación de imágenes nativa de Gemini, fal/fal-ai/flux/dev para fal, openai/gpt-image-2 para OpenAI Images, o openai/gpt-image-1.5 para salida PNG/WebP de OpenAI con fondo transparente.
  • Si seleccionas un proveedor/modelo directamente, configura también la autenticación del proveedor correspondiente (por ejemplo GEMINI_API_KEY o GOOGLE_API_KEY para google/*, OPENAI_API_KEY o OpenAI Codex OAuth para openai/gpt-image-2 / openai/gpt-image-1.5, FAL_KEY para fal/*).
  • Si se omite, image_generate aún puede inferir un valor predeterminado de proveedor respaldado por autenticación. Primero prueba el proveedor predeterminado actual y luego los proveedores de generación de imágenes registrados restantes en orden de identificador de proveedor.
• musicGenerationModel: acepta una cadena ("provider/model") o un objeto ({ primary, fallbacks }).
  • Lo usan la capacidad compartida de generación de música y la herramienta integrada music_generate.
  • Valores típicos: google/lyria-3-clip-preview, google/lyria-3-pro-preview o minimax/music-2.6.
  • Si se omite, music_generate aún puede inferir un valor predeterminado de proveedor respaldado por autenticación. Primero prueba el proveedor predeterminado actual y luego los proveedores de generación de música registrados restantes en orden de identificador de proveedor.
  • Si seleccionas un proveedor/modelo directamente, configura también la autenticación/clave de API del proveedor correspondiente.
• videoGenerationModel: acepta una cadena ("provider/model") o un objeto ({ primary, fallbacks }).
  • Lo usan la capacidad compartida de generación de video y la herramienta integrada video_generate.
  • Valores típicos: qwen/wan2.6-t2v, qwen/wan2.6-i2v, qwen/wan2.6-r2v, qwen/wan2.6-r2v-flash o qwen/wan2.7-r2v.
  • Si se omite, video_generate aún puede inferir un valor predeterminado de proveedor respaldado por autenticación. Primero prueba el proveedor predeterminado actual y luego los proveedores de generación de video registrados restantes en orden de identificador de proveedor.
  • Si seleccionas un proveedor/modelo directamente, configura también la autenticación/clave de API del proveedor correspondiente.
  • El proveedor incluido de generación de video Qwen admite hasta 1 video de salida, 1 imagen de entrada, 4 videos de entrada, 10 segundos de duración y opciones de nivel de proveedor size, aspectRatio, resolution, audio y watermark.
• pdfModel: acepta una cadena ("provider/model") o un objeto ({ primary, fallbacks }).
  • Lo usa la herramienta pdf para el enrutamiento de modelos.
  • Si se omite, la herramienta PDF recurre a imageModel y luego al modelo de sesión/predeterminado resuelto.
• pdfMaxBytesMb: límite de tamaño de PDF predeterminado para la herramienta pdf cuando maxBytesMb no se pasa en el momento de la llamada.
• pdfMaxPages: máximo de páginas predeterminado que considera el modo de respaldo de extracción en la herramienta pdf.
• verboseDefault: nivel detallado predeterminado para agentes. Valores: "off", "on", "full". Predeterminado: "off".
• toolProgressDetail: modo de detalle para resúmenes de herramientas de /verbose y líneas de herramienta de borrador de progreso. Valores: "explain" (predeterminado, etiquetas humanas compactas) o "raw" (añade comando/detalle sin procesar cuando está disponible). agents.list[].toolProgressDetail por agente sobrescribe este valor predeterminado.
• reasoningDefault: visibilidad de razonamiento predeterminada para agentes. Valores: "off", "on", "stream". agents.list[].reasoningDefault por agente sobrescribe este valor predeterminado. Los valores predeterminados de razonamiento configurados solo se aplican a propietarios, remitentes autorizados o contextos de Gateway de administrador operador cuando no hay una sobrescritura de razonamiento por mensaje o por sesión.
• elevatedDefault: nivel predeterminado de salida elevada para agentes. Valores: "off", "on", "ask", "full". Predeterminado: "on".
• model.primary: formato provider/model (p. ej., openai/gpt-5.5 para acceso con clave de API de OpenAI o Codex OAuth). Si omites el proveedor, OpenClaw prueba primero un alias, luego una coincidencia única de proveedor configurado para ese identificador de modelo exacto y solo entonces recurre al proveedor predeterminado configurado (comportamiento de compatibilidad obsoleto, así que prefiere provider/model explícito). Si ese proveedor ya no expone el modelo predeterminado configurado, OpenClaw recurre al primer proveedor/modelo configurado en lugar de mostrar un valor predeterminado obsoleto de un proveedor eliminado.
• models: el catálogo de modelos configurado y la lista de permitidos para /model. Cada entrada puede incluir alias (atajo) y params (específicos del proveedor, por ejemplo temperature, maxTokens, cacheRetention, context1m, responsesServerCompaction, responsesCompactThreshold, chat_template_kwargs, extra_body/extraBody).
  • Usa entradas provider/* como "openai-codex/*": {} o "vllm/*": {} para mostrar todos los modelos descubiertos de los proveedores seleccionados sin listar manualmente cada identificador de modelo.
  • Ediciones seguras: usa openclaw config set agents.defaults.models '<json>' --strict-json --merge para añadir entradas. config set rechaza reemplazos que eliminarían entradas existentes de la lista de permitidos salvo que pases --replace.
  • Los flujos de configuración/incorporación con ámbito de proveedor fusionan los modelos de proveedor seleccionados en este mapa y conservan los proveedores no relacionados que ya estén configurados.
  • Para modelos directos de OpenAI Responses, la Compaction del lado del servidor se habilita automáticamente. Usa params.responsesServerCompaction: false para dejar de inyectar context_management, o params.responsesCompactThreshold para sobrescribir el umbral. Consulta Compaction del lado del servidor de OpenAI.
• params: parámetros globales predeterminados de proveedor aplicados a todos los modelos. Se establece en agents.defaults.params (p. ej. { cacheRetention: "long" }).
• Prioridad de fusión de params (configuración): agents.defaults.params (base global) se sobrescribe con agents.defaults.models["provider/model"].params (por modelo), luego agents.list[].params (identificador de agente coincidente) sobrescribe por clave. Consulta almacenamiento en caché de prompts para obtener detalles.
• params.extra_body/params.extraBody: JSON avanzado de paso directo fusionado en cuerpos de solicitud api: "openai-completions" para proxies compatibles con OpenAI. Si entra en conflicto con claves de solicitud generadas, gana el cuerpo adicional; las rutas de completions no nativas aún eliminan después store, que solo es de OpenAI.
• params.chat_template_kwargs: argumentos de plantilla de chat compatibles con vLLM/OpenAI fusionados en cuerpos de solicitud de nivel superior api: "openai-completions". Para vllm/nemotron-3-* con pensamiento desactivado, el Plugin vLLM incluido envía automáticamente enable_thinking: false y force_nonempty_content: true; chat_template_kwargs explícito sobrescribe los valores predeterminados generados, y extra_body.chat_template_kwargs aún tiene la prioridad final. Para controles de pensamiento Qwen de vLLM, establece params.qwenThinkingFormat en "chat-template" o "top-level" en esa entrada de modelo.
• compat.thinkingFormat: estilo de carga útil de pensamiento compatible con OpenAI. Usa "qwen" para enable_thinking de nivel superior de estilo Qwen, o "qwen-chat-template" para chat_template_kwargs.enable_thinking en backends de la familia Qwen que admitan kwargs de plantilla de chat a nivel de solicitud, como vLLM. OpenClaw asigna el pensamiento deshabilitado a false y el pensamiento habilitado a true.
• compat.supportedReasoningEfforts: lista de esfuerzo de razonamiento compatible con OpenAI por modelo. Incluye "xhigh" para endpoints personalizados que realmente lo acepten; entonces OpenClaw expone /think xhigh en menús de comandos, filas de sesión de Gateway, validación de parches de sesión, validación de CLI de agente y validación de llm-task para ese proveedor/modelo configurado. Usa compat.reasoningEffortMap cuando el backend requiera un valor específico del proveedor para un nivel canónico.
• params.preserveThinking: activación opcional solo para Z.AI de pensamiento preservado. Cuando se habilita y el pensamiento está activado, OpenClaw envía thinking.clear_thinking: false y reproduce reasoning_content anterior; consulta pensamiento y pensamiento preservado de Z.AI.
• localService: gestor de procesos opcional a nivel de proveedor para servidores de modelos locales/autohospedados. Cuando el modelo seleccionado pertenece a ese proveedor, OpenClaw sondea healthUrl (o baseUrl + "/models"), inicia command con args si el endpoint está caído, espera hasta readyTimeoutMs y luego envía la solicitud del modelo. command debe ser una ruta absoluta. idleStopMs: 0 mantiene el proceso vivo hasta que OpenClaw sale; un valor positivo detiene el proceso iniciado por OpenClaw después de esa cantidad de milisegundos inactivos. Consulta servicios de modelos locales.
• La política de runtime pertenece a proveedores o modelos, no a agents.defaults. Usa models.providers.<provider>.agentRuntime para reglas de todo el proveedor o agents.defaults.models["provider/model"].agentRuntime / agents.list[].models["provider/model"].agentRuntime para reglas específicas del modelo. Los modelos de agente de OpenAI en el proveedor oficial de OpenAI seleccionan Codex de forma predeterminada.
• Los escritores de configuración que mutan estos campos (por ejemplo /models set, /models set-image y comandos de añadir/eliminar respaldos) guardan la forma de objeto canónica y conservan las listas de respaldos existentes cuando es posible.
• maxConcurrent: máximo de ejecuciones paralelas de agentes entre sesiones (cada sesión sigue serializada). Predeterminado: 4.

​

Política de runtime

{
  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", un identificador de harness de Plugin registrado o un alias de backend de CLI compatible. El Plugin Codex incluido registra codex; el Plugin Anthropic incluido proporciona el backend de CLI claude-cli.
• id: "auto" permite que los harnesses de Plugin registrados reclamen turnos compatibles y usa PI cuando ningún harness coincide. Un runtime de Plugin explícito como id: "codex" requiere ese harness y falla de forma cerrada si no está disponible o falla.
• Las claves de runtime de agente completo son heredadas. agents.defaults.agentRuntime, agents.list[].agentRuntime, las fijaciones de runtime de sesión y OPENCLAW_AGENT_RUNTIME se ignoran en la selección de runtime. Ejecuta openclaw doctor --fix para eliminar valores obsoletos.
• Los modelos de agente de OpenAI usan el harness de Codex de forma predeterminada; agentRuntime.id: "codex" de proveedor/modelo sigue siendo válido cuando quieres hacerlo explícito.
• Para despliegues de Claude CLI, prefiere model: "anthropic/claude-opus-4-7" más agentRuntime.id: "claude-cli" con ámbito de modelo. Las referencias de modelo heredadas claude-cli/claude-opus-4-7 aún funcionan por compatibilidad, pero la configuración nueva debe mantener canónica la selección de proveedor/modelo y colocar el backend de ejecución en la política de runtime de proveedor/modelo.
• Esto solo controla la ejecución de turnos de agente de texto. La generación de medios, visión, PDF, música, video y TTS siguen usando sus ajustes de proveedor/modelo.

​

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

• Los backends CLI priorizan el texto; las herramientas siempre están deshabilitadas.
• Las sesiones son compatibles cuando sessionArg está definido.
• El paso directo de imágenes es compatible cuando imageArg acepta rutas de archivo.
• reseedFromRawTranscriptWhenUncompacted: true permite que un backend recupere sesiones invalidadas seguras a partir de una cola acotada de transcripción sin procesar de OpenClaw antes de que exista el primer resumen de Compaction. Los cambios de perfil de autenticación o de época de credenciales siguen sin volver a sembrarse nunca desde datos sin procesar.

​

agents.defaults.systemPromptOverride

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

​

agents.defaults.promptOverlays

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

• "friendly" (valor predeterminado) y "on" habilitan la capa de estilo de interacción amigable.
• "off" deshabilita solo la capa amigable; el contrato de comportamiento GPT-5 etiquetado permanece habilitado.
• El ajuste heredado plugins.entries.openai.config.personality se sigue leyendo cuando este ajuste compartido no está definido.

​

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: cadena de duración (ms/s/m/h). Valor predeterminado: 30m (autenticación con clave de API) o 1h (autenticación OAuth). Configúralo como 0m para deshabilitarlo.
• includeSystemPromptSection: cuando es false, omite la sección Heartbeat del prompt de sistema y omite la inyección de HEARTBEAT.md en el contexto de arranque. Valor predeterminado: true.
• suppressToolErrorWarnings: cuando es true, suprime las cargas de advertencia de error de herramienta durante las ejecuciones de heartbeat.
• timeoutSeconds: tiempo máximo en segundos permitido para un turno del agente de heartbeat antes de abortarlo. Déjalo sin definir para usar agents.defaults.timeoutSeconds.
• directPolicy: política de entrega directa/DM. allow (valor predeterminado) permite la entrega a destino directo. block suprime la entrega a destino directo y emite reason=dm-blocked.
• lightContext: cuando es true, las ejecuciones de heartbeat usan contexto de arranque ligero y conservan solo HEARTBEAT.md de los archivos de arranque del espacio de trabajo.
• isolatedSession: cuando es true, cada heartbeat se ejecuta en una sesión nueva sin historial de conversación previo. El mismo patrón de aislamiento que cron sessionTarget: "isolated". Reduce el costo de tokens por heartbeat de ~100K a ~2-5K tokens.
• skipWhenBusy: cuando es true, las ejecuciones de heartbeat se aplazan en las rutas ocupadas adicionales de ese agente: su propio subagente con clave de sesión o trabajo de comandos anidados. Las rutas de Cron siempre aplazan los heartbeats, incluso sin esta marca.
• Por agente: configura agents.list[].heartbeat. Cuando cualquier agente define heartbeat, solo esos agentes ejecutan heartbeats.
• Los heartbeats ejecutan turnos completos del agente: intervalos más cortos consumen más 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 o safeguard (resumen por fragmentos para historiales largos). Consulta Compaction.
• provider: id de un Plugin de proveedor de compaction registrado. Cuando está definido, se llama a summarize() del proveedor en lugar del resumen LLM integrado. Recurre al integrado si falla. Configurar un proveedor fuerza mode: "safeguard". Consulta Compaction.
• timeoutSeconds: segundos máximos permitidos para una única operación de compaction antes de que OpenClaw la aborte. Valor predeterminado: 900.
• keepRecentTokens: presupuesto de punto de corte de Pi para conservar literalmente la cola más reciente de la transcripción. /compact manual respeta esto cuando se define explícitamente; de lo contrario, la compaction manual es un punto de control estricto.
• identifierPolicy: strict (valor predeterminado), off o custom. strict antepone una guía integrada de retención de identificadores opacos durante el resumen de compaction.
• identifierInstructions: texto personalizado opcional de preservación de identificadores usado cuando identifierPolicy=custom.
• qualityGuard: comprobaciones de reintento ante salida mal formada para resúmenes de safeguard. Habilitado de forma predeterminada en modo safeguard; configura enabled: false para omitir la auditoría.
• midTurnPrecheck: comprobación opcional de presión del bucle de herramientas de Pi. Cuando enabled: true, OpenClaw comprueba la presión del contexto después de anexar los resultados de herramientas y antes de la siguiente llamada al modelo. Si el contexto ya no cabe, aborta el intento actual antes de enviar el prompt y reutiliza la ruta existente de recuperación de precomprobación para truncar resultados de herramientas o compactar y reintentar. Funciona con los modos de compaction default y safeguard. Valor predeterminado: deshabilitado.
• postCompactionSections: nombres opcionales de secciones H2/H3 de AGENTS.md para reinyectar después de la compaction. El valor predeterminado es ["Session Startup", "Red Lines"]; configura [] para deshabilitar la reinyección. Cuando no está definido o se define explícitamente como ese par predeterminado, también se aceptan los encabezados antiguos Every Session/Safety como alternativa heredada.
• model: reemplazo opcional provider/model-id solo para el resumen de compaction. Úsalo cuando la sesión principal deba conservar un modelo, pero los resúmenes de compaction deban ejecutarse en otro; cuando no está definido, la compaction usa el modelo principal de la sesión.
• maxActiveTranscriptBytes: umbral opcional en bytes (number o cadenas como "20mb") que activa la compaction local normal antes de una ejecución cuando el JSONL activo supera el umbral. Requiere truncateAfterCompaction para que una compaction correcta pueda rotar a una transcripción sucesora más pequeña. Deshabilitado cuando no está definido o es 0.
• notifyUser: cuando es true, envía avisos breves al usuario cuando empieza la compaction y cuando se completa (por ejemplo, “Compacting context…” y “Compaction complete”). Deshabilitado de forma predeterminada para mantener la compaction en silencio.
• memoryFlush: turno agéntico silencioso antes de la compaction automática para almacenar memorias duraderas. Configura model como un proveedor/modelo exacto, como ollama/qwen3:8b, cuando este turno de mantenimiento deba permanecer en un modelo local; el reemplazo no hereda la cadena de alternativas de la sesión activa. Se omite cuando el espacio de trabajo es de solo lectura.

​

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: número base de iteraciones de reintento de ejecución para el bucle externo de ejecución. Valor predeterminado: 24.
• perProfile: iteraciones adicionales de reintento de ejecución concedidas por cada candidato de perfil alternativo. Valor predeterminado: 8.
• min: límite absoluto mínimo para las iteraciones de reintento de ejecución. Valor predeterminado: 32.
• max: límite absoluto máximo para las iteraciones de reintento de ejecución para evitar ejecuciones descontroladas. Valor predeterminado: 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"] },
      },
    },
  },
}

​

Transmisión por bloques

{
  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)
    },
  },
}

• Los canales que no son Telegram requieren *.blockStreaming: true explícito para habilitar las respuestas por bloques.
• Sobrescrituras de canal: channels.<channel>.blockStreamingCoalesce (y variantes por cuenta). Signal/Slack/Discord/Google Chat tienen minChars: 1500 de forma predeterminada.
• humanDelay: pausa aleatorizada entre respuestas por bloques. natural = 800–2500 ms. Sobrescritura por agente: agents.list[].humanDelay.

​

Indicadores de escritura

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

• Valores predeterminados: instant para chats directos/menciones, message para chats grupales sin mención.
• Sobrescrituras por sesión: 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 (sobrescrituras por agente)

{
  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: id de agente estable (obligatorio).
• default: cuando se configuran varios, gana el primero (se registra una advertencia). Si no se configura ninguno, la primera entrada de la lista es la predeterminada.
• model: la forma de cadena establece un primario estricto por agente sin alternativa de modelo; la forma de objeto { primary } también es estricta a menos que agregues fallbacks. Usa { primary, fallbacks: [...] } para habilitar alternativas para ese agente, o { primary, fallbacks: [] } para hacer explícito el comportamiento estricto. Los trabajos Cron que solo sobrescriben primary siguen heredando las alternativas predeterminadas a menos que configures fallbacks: [].
• params: parámetros de flujo por agente fusionados sobre la entrada del modelo seleccionado en agents.defaults.models. Usa esto para sobrescrituras específicas del agente como cacheRetention, temperature o maxTokens sin duplicar todo el catálogo de modelos.
• tts: sobrescrituras opcionales de texto a voz por agente. El bloque se fusiona en profundidad sobre messages.tts, así que mantén las credenciales de proveedor compartidas y la política de alternativas en messages.tts, y configura aquí solo valores específicos de la personalidad, como proveedor, voz, modelo, estilo o modo automático.
• skills: lista de permitidos opcional de Skills por agente. Si se omite, el agente hereda agents.defaults.skills cuando está configurado; una lista explícita reemplaza los valores predeterminados en lugar de fusionarse, y [] significa sin Skills.
• thinkingDefault: nivel de razonamiento predeterminado opcional por agente (off | minimal | low | medium | high | xhigh | adaptive | max). Sobrescribe agents.defaults.thinkingDefault para este agente cuando no se configura una sobrescritura por mensaje o sesión. El perfil de proveedor/modelo seleccionado controla qué valores son válidos; para Google Gemini, adaptive mantiene el razonamiento dinámico gestionado por el proveedor (thinkingLevel omitido en Gemini 3/3.1, thinkingBudget: -1 en Gemini 2.5).
• reasoningDefault: visibilidad de razonamiento predeterminada opcional por agente (on | off | stream). Sobrescribe agents.defaults.reasoningDefault para este agente cuando no se configura una sobrescritura de razonamiento por mensaje o sesión.
• fastModeDefault: valor predeterminado opcional por agente para el modo rápido (true | false). Se aplica cuando no se configura una sobrescritura de modo rápido por mensaje o sesión.
• models: catálogo de modelos/sobrescrituras de runtime opcionales por agente, indexados por ids completos provider/model. Usa models["provider/model"].agentRuntime para excepciones de runtime por agente.
• runtime: descriptor de runtime opcional por agente. Usa type: "acp" con los valores predeterminados de runtime.acp (agent, backend, mode, cwd) cuando el agente deba usar sesiones del arnés ACP de forma predeterminada.
• identity.avatar: ruta relativa al espacio de trabajo, URL http(s) o URI data:.
• identity deriva valores predeterminados: ackReaction desde emoji, mentionPatterns desde name/emoji.
• subagents.allowAgents: lista de permitidos de ids de agente para destinos explícitos sessions_spawn.agentId (["*"] = cualquiera; predeterminado: solo el mismo agente). Incluye el id del solicitante cuando deban permitirse llamadas agentId dirigidas a sí mismo.
• Protección de herencia de sandbox: si la sesión solicitante está en sandbox, sessions_spawn rechaza destinos que se ejecutarían sin sandbox.
• subagents.requireAgentId: cuando es true, bloquea las llamadas sessions_spawn que omiten agentId (fuerza la selección explícita de perfil; predeterminado: false).

​

Enrutamiento multiagente

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

​

Campos de coincidencia de vinculación

• type (opcional): route para enrutamiento normal (si falta el tipo, el valor predeterminado es route), acp para vinculaciones de conversación ACP persistentes.
• match.channel (obligatorio)
• match.accountId (opcional; * = cualquier cuenta; omitido = cuenta predeterminada)
• match.peer (opcional; { kind: direct|group|channel, id })
• match.guildId / match.teamId (opcional; específico del canal)
• acp (opcional; solo para type: "acp"): { mode, label, cwd, backend }

1. match.peer
2. match.guildId
3. match.teamId
4. match.accountId (exacto, sin peer/guild/team)
5. match.accountId: "*" (todo el canal)
6. Agente predeterminado

​

Perfiles de acceso por agente

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

​

Sesión

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

​

Mensajes

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

​

Prefijo de respuesta

​

Reacción de confirmación

• El valor predeterminado es identity.emoji del agente activo; de lo contrario, "👀". Configura "" para desactivarla.
• Anulaciones por canal: channels.<channel>.ackReaction, channels.<channel>.accounts.<id>.ackReaction.
• Orden de resolución: cuenta → canal → messages.ackReaction → respaldo de identidad.
• Alcance: group-mentions (predeterminado), group-all, direct, all.
• removeAckAfterReply: elimina la confirmación después de responder en canales con capacidad de reacción como Slack, Discord, Telegram, WhatsApp e iMessage.
• messages.statusReactions.enabled: activa reacciones de estado del ciclo de vida en Slack, Discord y Telegram. En Slack y Discord, si no se define, mantiene activas las reacciones de estado cuando las reacciones de confirmación están activas. En Telegram, configúralo explícitamente en true para activar las reacciones de estado del ciclo de vida.

​

Debounce de entrada

​

TTS (texto a voz)

{
  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 controla el modo TTS automático predeterminado: off, always, inbound o tagged. /tts on|off puede anular las preferencias locales, y /tts status muestra el estado efectivo.
• summaryModel anula agents.defaults.model.primary para el resumen automático.
• modelOverrides está activado de forma predeterminada; modelOverrides.allowProvider usa false de forma predeterminada (activación explícita).
• Las claves de API recurren a ELEVENLABS_API_KEY/XI_API_KEY y OPENAI_API_KEY.
• Los proveedores de voz incluidos son propiedad de plugins. Si plugins.allow está definido, incluye cada Plugin proveedor de TTS que quieras usar, por ejemplo microsoft para Edge TTS. El id de proveedor heredado edge se acepta como alias de microsoft.
• providers.openai.baseUrl anula el endpoint de TTS de OpenAI. El orden de resolución es configuración, luego OPENAI_TTS_BASE_URL, luego https://api.openai.com/v1.
• Cuando providers.openai.baseUrl apunta a un endpoint que no es de OpenAI, OpenClaw lo trata como un servidor TTS compatible con OpenAI y relaja la validación de modelo/voz.

​

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 debe coincidir con una clave en talk.providers cuando se configuran varios proveedores de Talk.
• Las claves planas heredadas de Talk (talk.voiceId, talk.voiceAliases, talk.modelId, talk.outputFormat, talk.apiKey) existen solo por compatibilidad. Ejecuta openclaw doctor --fix para reescribir la configuración persistida en talk.providers.<provider>.
• Los IDs de voz recurren a ELEVENLABS_VOICE_ID o SAG_VOICE_ID.
• providers.*.apiKey acepta cadenas de texto sin formato u objetos SecretRef.
• El respaldo ELEVENLABS_API_KEY se aplica solo cuando no hay una clave de API de Talk configurada.
• providers.*.voiceAliases permite que las directivas de Talk usen nombres descriptivos.
• providers.mlx.modelId selecciona el repositorio de Hugging Face usado por el asistente local MLX de macOS. Si se omite, macOS usa mlx-community/Soprano-80M-bf16.
• La reproducción MLX de macOS se ejecuta mediante el asistente incluido openclaw-mlx-tts cuando está presente, o mediante un ejecutable en PATH; OPENCLAW_MLX_TTS_BIN anula la ruta del asistente para desarrollo.
• consultThinkingLevel controla el nivel de razonamiento para la ejecución completa del agente OpenClaw detrás de las llamadas openclaw_agent_consult en tiempo real de Talk de la UI de control. Déjalo sin definir para conservar el comportamiento normal de sesión/modelo.
• consultFastMode establece una anulación de modo rápido de un solo uso para las consultas en tiempo real de Talk de la UI de control sin cambiar la configuración normal de modo rápido de la sesión.
• speechLocale establece el id de configuración regional BCP 47 usado por el reconocimiento de voz de Talk en iOS/macOS. Déjalo sin definir para usar el valor predeterminado del dispositivo.
• silenceTimeoutMs controla cuánto tiempo espera el modo Talk después del silencio del usuario antes de enviar la transcripción. Si no se define, mantiene la ventana de pausa predeterminada de la plataforma (700 ms on macOS and Android, 900 ms on iOS).
• realtime.instructions agrega instrucciones de sistema orientadas al proveedor al prompt en tiempo real integrado de OpenClaw, para que el estilo de voz pueda configurarse sin perder la guía predeterminada de openclaw_agent_consult.

​

Relacionado

• Referencia de configuración — todas las demás claves de configuración
• Configuración — tareas comunes y configuración rápida
• Ejemplos de configuración