Solución para el contexto de 16k de OpenClaw

Solución para el contexto de 16k de OpenClaw

El tamaño del contexto de los modelos de OpenClaw no está fijado en 16k, sino que depende principalmente de la configuración local. Revisa ~/.openclaw/openclaw.json o ~/.openclaw/agents/<agentId>/agent/models.json y cambia contextWindow y maxTokens del modelo correspondiente por los valores que realmente admita. Por ejemplo, para MiniMax-M2.5 puedes usar contextWindow: 196608 y maxTokens: 8192. Después del cambio, solo tienes que reiniciar OpenClaw. Tanto la referencia oficial de configuración como el ejemplo de MiniMax admiten esta sintaxis.

En esencia, lo que ocurre es que: en el provider personalizado o en el modelo personalizado se ha establecido contextWindow en 16000 (o incluso menos), y el contexto real de OpenClaw depende mucho de la configuración. Si el modelo admite realmente un contexto mayor, conviene aumentarlo; de lo contrario, es fácil encontrarse con problemas como API rate limit reached, contexto insuficiente o comportamientos inexplicables en conversaciones largas. La referencia oficial de configuración indica claramente que el archivo de configuración principal de OpenClaw es ~/.openclaw/openclaw.json y que también se puede incluir un models.json independiente en el directorio del agent. Al hacer coincidir los modelos, contextWindow / maxTokens adoptan el valor más alto entre la configuración y el catálogo implícito.

La imagen muestra la pestaña de configuración «Settings» de la página de…

Instrucciones para modificar la configuración del contexto en OpenClaw

Primero: descripción del problema

Si, al conectar un modelo personalizado o un modelo de un intermediario externo en OpenClaw, la ventana de contexto indicada en la configuración es demasiado pequeña, por ejemplo:

"contextWindow": 16000,
"maxTokens": 4096

pueden producirse los siguientes problemas:

• Las conversaciones largas pueden fallar con facilidad
• Es más probable que se produzcan errores al usar herramientas
• La página muestra API rate limit reached
• Aunque el modelo admita un contexto mayor, OpenClaw sigue procesándolo con el valor más pequeño

La documentación oficial de OpenClaw explica que contextWindow y maxTokens del modelo se pueden definir explícitamente en la configuración. La ruta del archivo de configuración principal es ~/.openclaw/openclaw.json, y también se puede usar un models.json en el directorio del agent para sobrescribirla de forma independiente.

Segundo: ubicación de los archivos de configuración

1) Ruta del archivo de configuración principal

Archivo de configuración principal predeterminado de OpenClaw:

~/.openclaw/openclaw.json

La documentación oficial lo indica claramente.

2) Ruta de configuración de modelos del agent

Si los modelos se configuran por separado para cada agent, la ruta suele ser:

~/.openclaw/agents/<agentId>/agent/models.json

La documentación oficial indica que los provider personalizados se pueden añadir en models.providers o escribir en ~/.openclaw/agents/<agentId>/agent/models.json.

3) Si has cambiado el directorio raíz personalizado del Agent

Si has definido la variable de entorno:

OPENCLAW_AGENT_DIR

el directorio de configuración del agent será sustituido por el valor de esta variable de entorno. La documentación oficial también indica que se puede cambiar el directorio raíz de configuración del agent mediante OPENCLAW_AGENT_DIR (o PI_CODING_AGENT_DIR).

Tercero: cómo modificarlo

Opción A: modificar la configuración principal

openclaw.json

Abre:

~/.openclaw/openclaw.json

Busca la configuración correspondiente al proveedor de tu modelo actual, por ejemplo:

{
  models: {
    mode: "merge",
    providers: {
      minimax: {
        baseUrl: "https://api.minimax.io/anthropic",
        api: "anthropic-messages",
        apiKey: "你的 API Key",
        models: [
          {
            id: "MiniMax-M2.5",
            name: "MiniMax-M2.5",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 196608,
            maxTokens: 8192
          }
        ]
      }
    }
  }
}

El ejemplo oficial de MiniMax presenta precisamente para MiniMax-M2.5 la configuración contextWindow: 196608 y maxTokens: 8192.

Opción B: modificar el archivo del agent

models.json

Abre:

~/.openclaw/agents/<agentId>/agent/models.json

Cambia en el modelo correspondiente:

"contextWindow": 16000,
"maxTokens": 4096

por valores más adecuados, por ejemplo:

"contextWindow": 196608,
"maxTokens": 8192

Cuarto: valores recomendados

No introduzcas valores al azar. No funciona así eso de «quiero un contexto de 1M, así que escribiré 1000000».

Principios recomendados

• contextWindow: introduce el valor que el modelo admita realmente
• maxTokens: introduce la salida máxima real del modelo
• Si usas una plataforma intermediaria, debes tener en cuenta el límite que el intermediario permite realmente, no solo el valor promocionado por el proveedor original

Ejemplo con MiniMax-M2.5

El ejemplo oficial de OpenClaw recomienda:

"contextWindow": 196608,
"maxTokens": 8192

Quinto: qué hacer después del cambio

Después de guardar la configuración, reinicia OpenClaw o el proceso gateway correspondiente.

Comandos habituales:

openclaw models list
openclaw models set minimax/MiniMax-M2.5

La documentación oficial también incluye estos dos comandos para comprobar y cambiar el modelo.

Si lo ejecutas como un servicio, también tendrás que reiniciar el servicio correspondiente, por ejemplo:

openclaw gateway restart

O reinicia tu propio contenedor de systemd / pm2 / docker.

Sexto: información adicional

La referencia oficial de configuración de OpenClaw también señala que:

• Los provider personalizados se pueden incluir directamente en models.providers
• contextWindow / maxTokens se pueden definir explícitamente
• Al hacer coincidir los modelos, se adopta el valor más alto entre la configuración explícita y el catálogo implícito
• Si quieres sustituir por completo models.json por tu propia configuración, puedes usar models.mode: "replace".

Además, la documentación oficial indica actualmente que: para los custom providers, si se omiten estos campos, los valores predeterminados serán contextWindow: 200000 y maxTokens: 8192. Por tanto, si el cliente sigue viendo 16k o 4k, lo más probable no es que «OpenClaw solo admita 16k de forma predeterminada», sino que la configuración local del modelo se haya reducido manualmente o que persista una configuración antigua.