Distingue entre límites de 429, exceso de contexto y errores de metadatos locales del modelo, y luego ajusta con seguridad contextWindow, contextTokens y maxTokens.

Primero, determina el tipo de error

API rate limit reached generalmente indica un 429 devuelto por el upstream, una limitación de concurrencia o un límite de cuota; no se puede determinar solo con esta frase que el problema se debe a la configuración de contexto de 16k. Primero revisa el código de estado y el error original, y luego decide si modificas la configuración.

Síntoma	Causa más probable	Qué hacer primero
`429`, `rate_limit`, `quota`, `too many requests`	Limitación de upstream, concurrencia o cuota insuficiente	Reduce la concurrencia y reintenta más tarde; revisa la cuota y el estado del upstream
`context_length_exceeded`, solicitud demasiado grande, entrada excedida	La entrada más la salida reservada superan el límite del modelo o de la puerta de enlace	Acorta la conversación, activa la compresión y luego verifica la configuración de contexto
Ventana de aviso local de OpenClaw demasiado pequeña	Faltan metadatos del modelo personalizado o hay una configuración antigua residual	Revisa `contextWindow`, `contextTokens`, `maxTokens`
Solo falla un modelo	Problema de enrutamiento del modelo o de sus parámetros	Usa la misma Key y URL Base para probar otro modelo con una solicitud mínima

Ubicación de Model Window en la página de configuración de OpenClaw. Los…

Qué representa cada uno de los tres campos

contextWindow: metadatos de la ventana de contexto nativa del modelo.
contextTokens: el límite máximo que OpenClaw permite realmente usar para la entrada; puede ser menor que la ventana nativa.
maxTokens: el límite máximo de salida de tokens de una sola respuesta; no es el tamaño total del contexto.

No rellenes 1M de forma arbitraria solo para “obtener más contexto”. Los valores introducidos deben cumplir a la vez la capacidad del modelo, las limitaciones de enrutamiento actuales de LLM API Gateway y la versión del cliente.

Ubicación de la configuración

La configuración principal suele estar en:

~/.openclaw/openclaw.json

Cuando se configura por separado por Agent, suele estar en:

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

Si has definido OPENCLAW_AGENT_DIR, busca la configuración del Agent correspondiente en ese directorio.

Ejemplo de modificación segura

Los valores siguientes solo muestran la relación entre los campos; no representan los límites reales de ningún modelo. Confirma primero los valores en la lista de modelos de este sitio y en la documentación de enrutamiento actual:

{
  models: {
    mode: "merge",
    providers: {
      guishu: {
        baseUrl: "https://api.llm-token.cn/v1",
        apiKey: "YOUR_API_KEY",
        api: "openai-completions",
        models: [
          {
            id: "YOUR_MODEL_ID",
            name: "YOUR_MODEL_ID",
            contextWindow: 128000,
            contextTokens: 96000,
            maxTokens: 8192,
            input: ["text"]
          }
        ]
      }
    }
  }
}

Reserva parte de la ventana para los mensajes del sistema, los resultados de las herramientas y la salida del modelo. Si el upstream solo permite una entrada o salida menor, se debe seguir reduciendo el valor; no se puede rellenar solo con el valor publicitado por el fabricante del modelo.

Orden de modificación y verificación

Haz una copia de seguridad del archivo de configuración actual; no sobrescribas la única copia.
Modifica solo las entradas del provider y del modelo actual; conserva el resto de la configuración.
Ejecuta openclaw models list para confirmar que el modelo es reconocido.
Ejecuta openclaw models set guishu/YOUR_MODEL_ID para confirmar que el provider/model seleccionado es correcto.
Reinicia la puerta de enlace: openclaw gateway restart.
Primero envía una solicitud de prueba muy corta y luego aumenta el contexto de forma progresiva.

Si la solicitud corta también devuelve 429, seguir agrandando la ventana de contexto no ayudará; en su lugar revisa la concurrencia, la cuota de la cuenta y el estado del upstream. Si solo fallan las solicitudes largas, revisa entonces la longitud de la entrada, la estrategia de compresión y los tres campos de contexto.

Las capturas de configuración y los registros pueden contener una API Key. Antes de enviarlos al soporte, tapa la Key completa y conserva solo la hora del error, el código de estado, el ID del modelo y el ID de la solicitud.

Your privacy choices

OpenClaw y contrastación de límites