Características experimentales
Las características experimentales en OpenClaw son superficies de vista previa opcionales. Están detrás de marcas explícitas porque aún necesitan kilometraje en el mundo real antes de que merezcan un valor predeterminado estable o un contrato público de larga duración.
Trátalas de manera diferente a la configuración normal:
- Mantenlas desactivadas por defecto a menos que la documentación relacionada te indique probar una.
- Espera que la forma y el comportamiento cambien más rápido que en la configuración estable.
- Prefiere la ruta estable primero cuando ya exista una.
- Si estás implementando OpenClaw ampliamente, prueba las marcas experimentales en un entorno más pequeño antes de integrarlas en una línea base compartida.
Marcas actualmente documentadas
Sección titulada «Marcas actualmente documentadas»| Superficie | Clave | Úsala cuando | Más |
|---|---|---|---|
| Tiempo de ejecución del modelo local | agents.defaults.experimental.localModelLean, agents.list[].experimental.localModelLean | Un backend local más pequeño o más estricto se bloquea con la superficie de herramientas predeterminada completa de OpenClaw | Modelos locales |
| Búsqueda de memoria | agents.defaults.memorySearch.experimental.sessionMemory | Desea que memory_search indexe las transcripciones de sesiones anteriores y acepte el costo adicional de almacenamiento/indexación | Referencia de configuración de memoria |
| Arnés de Codex | plugins.entries.codex.config.appServer.experimental.sandboxExecServer | Desea que el servidor de aplicaciones nativo Codex 0.132.0 o más reciente apunte a un servidor de ejecución respaldado por sandbox de OpenClaw en lugar de desactivar el Modo de Código | Referencia del arnés de Codex |
| Herramienta de planificación estructurada | tools.experimental.planTool | Desea que la herramienta estructurada update_plan esté expuesta para el seguimiento de trabajo de múltiples pasos en tiempos de ejecución e interfaces de usuario compatibles | Referencia de configuración de Gateway |
Modo optimizado de modelo local
Sección titulada «Modo optimizado de modelo local»agents.defaults.experimental.localModelLean: true es una válvula de alivio de presión para configuraciones de modelos locales más débiles. Cuando está activado, OpenClaw elimina tres herramientas predeterminadas — browser, cron y message — de la superficie de herramientas del agente en cada turno. Nada más cambia. Use agents.list[].experimental.localModelLean para habilitar o deshabilitar el mismo comportamiento para un agente configurado.
Por qué estas tres herramientas
Sección titulada «Por qué estas tres herramientas»Estas tres herramientas tienen las descripciones más grandes y la mayor cantidad de formas de parámetros en el tiempo de ejecución predeterminado de OpenClaw. En un backend compatible con OpenAI de contexto pequeño o más estricto, esa es la diferencia entre:
- Los esquemas de herramientas encajando limpiamente en el mensaje frente a desplazar el historial de la conversación.
- El modelo eligiendo la herramienta correcta frente a emitir llamadas a herramientas mal formadas porque hay demasiados esquemas con apariencia similar.
- El adaptador de Chat Completions manteniéndose dentro de los límites de salida estructurada del servidor frente a encontrar un error 400 en el tamaño de la carga útil de la llamada a la herramienta.
Eliminarlas no reconfigura silenciosamente OpenClaw, solo hace que la lista de herramientas sea más corta. El modelo todavía tiene read, write, edit, exec, apply_patch, búsqueda/recuperación web (cuando está configurado), memoria, y herramientas de sesión/agente disponibles.
Cuándo activarlo
Sección titulada «Cuándo activarlo»Active el modo optimizado cuando ya haya demostrado que el modelo puede comunicarse con el Gateway, pero los turnos completos del agente se comporten mal. La cadena de señal típica es:
openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong"tiene éxito.- Un turno normal del agente falla con llamadas a herramientas mal formadas, mensajes demasiado grandes o el modelo ignorando sus herramientas.
- Alternar
localModelLean: trueborra el fallo.
Cuándo dejarlo desactivado
Sección titulada «Cuándo dejarlo desactivado»Si tu backend maneja el tiempo de ejecución predeterminado completo sin problemas, deja esto desactivado. El modo reducido (lean mode) es una solución alternativa, no un valor predeterminado. Existe porque algunas pilas locales necesitan una superficie de herramientas más pequeña para comportarse; los modelos alojados y las configuraciones locales con buenos recursos no lo necesitan.
El modo reducido tampoco reemplaza a tools.profile, tools.allow/tools.deny, o el mecanismo de escape del modelo compat.supportsTools: false. Si necesitas una superficie de herramientas más estrecha de forma permanente para un agente específico, prefiere esos controles estables sobre la marca experimental.
Activar
Sección titulada «Activar»{ agents: { defaults: { experimental: { localModelLean: true, }, }, },}Para un solo agente:
{ agents: { list: [ { id: "local", model: "lmstudio/gemma-4-e4b-it", experimental: { localModelLean: true, }, }, ], },}Reinicia la puerta de enlace (Gateway) después de cambiar la marca y, a continuación, confirma la lista de herramientas recortada con:
openclaw status --deepLa salida de estado profundo lista las herramientas activas del agente; browser, cron y message deben estar ausentes cuando el modo reducido está activado.
Experimental no significa oculto
Sección titulada «Experimental no significa oculto»Si una característica es experimental, OpenClaw debería indicarlo claramente en la documentación y en la propia ruta de configuración. Lo que no debería hacer es introducir a escondidas un comportamiento de vista previa en un control predeterminado que parezca estable y fingir que es normal. Así es como las superficies de configuración se vuelven un desastre.