Funciones experimentales

Las funciones experimentales son superficies de vista previa voluntarias tras indicadores explícitos. Necesitan más uso en situaciones reales antes de adoptar un valor predeterminado estable o un contrato duradero.

• Están desactivadas de forma predeterminada, salvo que la documentación indique que se habilite alguna.
• Su estructura y comportamiento pueden cambiar más rápido que la configuración estable.
• Prefiera una vía estable cuando ya exista.
• Impleméntelas ampliamente solo después de probarlas primero en un entorno más reducido.

Indicadores documentados actualmente

Modo ligero para modelos locales

agents.defaults.experimental.localModelLean: true elimina en cada turno las herramientas opcionales de mayor peso de la superficie directa del agente: browser, cron, message, image_generate, music_generate, video_generate, tts y pdf. Las herramientas permitidas explícitamente o necesarias para la entrega siguen disponibles, aunque la búsqueda de herramientas puede catalogarlas en lugar de exponerlas directamente. Cuando tools.toolSearch aún no está establecido, el modo ligero también hace que los catálogos de plugins, MCP y clientes utilicen de forma predeterminada la búsqueda estructurada de herramientas (tool_search, tool_describe, tool_call). Use agents.list[].experimental.localModelLean para limitarlo a un solo agente.

Si ya ajusta globalmente la búsqueda de herramientas, OpenClaw no modifica esa configuración. Establezca tools.toolSearch: false para no usar el valor predeterminado de búsqueda de herramientas del modo ligero.

En el modo estructurado de tools, las ejecuciones ligeras mantienen exec visible directamente junto a los controles de búsqueda de herramientas para que los modelos locales optimizados para programación puedan seguir eligiendo su ruta de shell habitual. Esto solo cambia la visibilidad del esquema: se siguen aplicando la política normal de herramientas, el aislamiento y las aprobaciones de ejecución. Los modos explícitos code y directory conservan su comportamiento normal de Compaction.

Por qué estas herramientas

Estas herramientas tienen las descripciones más extensas, las estructuras de parámetros más amplias o la mayor probabilidad de distraer a un modelo pequeño de la ruta normal de programación y conversación. En un backend con poco contexto o compatible con OpenAI más estricto, esto supone la diferencia entre:

• Que los esquemas de herramientas quepan en el prompt o desplacen el historial de conversación.
• Que el modelo elija la herramienta correcta o emita llamadas de herramientas mal formadas debido a demasiados esquemas similares.
• Que el adaptador de finalizaciones de chat se mantenga dentro de los límites de salida estructurada o se produzca un error 400 por el tamaño de la carga útil de la llamada a herramientas.

Eliminarlas solo acorta la lista directa de herramientas. El modelo sigue disponiendo de read, write, edit, exec, apply_patch, comprensión de imágenes, búsqueda y obtención de contenido web (cuando están configuradas), memoria y herramientas de sesión y agente. Se puede seguir accediendo a catálogos adicionales mediante la búsqueda de herramientas, salvo que establezca tools.toolSearch: false; las autorizaciones explícitas de herramientas permiten que un agente ligero vuelva a incorporar un flujo de trabajo reducido.

Cuándo activarlo

Habilite el modo ligero cuando haya comprobado que el modelo puede comunicarse con el Gateway, pero los turnos completos del agente funcionan incorrectamente:

1. openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong" se ejecuta correctamente.
2. Un turno normal del agente falla con llamadas de herramientas mal formadas, prompts demasiado grandes o porque el modelo ignora sus herramientas.
3. Activar localModelLean: true elimina el fallo.

Cuándo dejarlo desactivado

Si su backend gestiona correctamente el entorno de ejecución predeterminado completo, déjelo desactivado. Es una solución alternativa para entornos locales que necesitan una superficie de herramientas más pequeña, no un valor predeterminado para modelos alojados ni equipos locales con recursos suficientes.

El modo ligero no sustituye a tools.profile, tools.allow/tools.deny ni al mecanismo de escape compat.supportsTools: false del modelo. Para obtener una superficie de herramientas permanentemente más reducida en un agente específico, prefiera esas opciones estables.

Habilitar

{  agents: {    defaults: {      experimental: {        localModelLean: true,      },    },  },}

Solo para un agente:

{  agents: {    list: [      {        id: "local",        model: "lmstudio/gemma-4-e4b-it",        experimental: {          localModelLean: true,        },      },    ],  },}

Reinicie el Gateway después de cambiar el indicador. El filtrado ligero elimina browser, cron, message, image_generate, music_generate, video_generate, tts y pdf, salvo que los conserve explícitamente con tools.allow o tools.alsoAllow; la búsqueda de herramientas puede seguir catalogando las herramientas conservadas en lugar de exponerlas directamente.

Experimental no significa oculto

Una función experimental debe indicarlo claramente en la documentación y en la propia ruta de configuración, no ocultarse tras una opción predeterminada que parezca estable.

Relacionado

• Funciones
• Canales de versiones