Ir al contenido

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.
SuperficieClaveÚsala cuandoMás
Tiempo de ejecución del modelo localagents.defaults.experimental.localModelLean, agents.list[].experimental.localModelLeanUn backend local más pequeño o más estricto se bloquea con la superficie de herramientas predeterminada completa de OpenClawModelos locales
Búsqueda de memoriaagents.defaults.memorySearch.experimental.sessionMemoryDesea que memory_search indexe las transcripciones de sesiones anteriores y acepte el costo adicional de almacenamiento/indexaciónReferencia de configuración de memoria
Arnés de Codexplugins.entries.codex.config.appServer.experimental.sandboxExecServerDesea 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ódigoReferencia del arnés de Codex
Herramienta de planificación estructuradatools.experimental.planToolDesea 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 compatiblesReferencia de configuración de Gateway

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.

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.

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:

  1. openclaw infer model run --gateway --model <ref> --prompt "Reply with exactly: pong" tiene éxito.
  2. Un turno normal del agente falla con llamadas a herramientas mal formadas, mensajes demasiado grandes o el modelo ignorando sus herramientas.
  3. Alternar localModelLean: true borra el fallo.

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.

{
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:

Ventana de terminal
openclaw status --deep

La salida de estado profundo lista las herramientas activas del agente; browser, cron y message deben estar ausentes cuando el modo reducido está activado.

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.