# OpenClaw: cómo corregir el error invalid beta flag

> El error invalid beta flag exige identificar qué función se solicita y qué servicio la rechaza. Corrige su origen y verifica una respuesta completa por la misma conexión.

- URL: https://blog.laozhang.ai/es/posts/openclaw-invalid-beta-flag
- Published: 2026-10-04
- Updated: 2026-10-04
- Author: LaoZhang AI Team (https://blog.laozhang.ai/es/about)
- Category: Solución de problemas
- Tags: OpenClaw, Anthropic, Claude, Errores API, Configuración

---
Si OpenClaw muestra **`invalid beta flag`**, busca el nombre de la función rechazada y el proveedor que ha respondido antes de cambiar la configuración. En la API de Claude, una beta no válida o un acceso no autorizado a ella puede producir **HTTP 400 con `invalid_request_error`**. La corrección consiste en retirar una beta opcional incompatible desde el lugar donde se añade, o mantener la función necesaria y utilizar una conexión que la admita. Reiniciar el Gateway por sí solo no cambia lo que acepta el proveedor. La [referencia de encabezados beta de Anthropic](https://platform.claude.com/docs/en/api/beta-headers) explica esas condiciones.

No borres todos los encabezados ni cambies de modelo como primera medida. Puedes perder una función necesaria, alterar la autenticación o conseguir una respuesta de otro proveedor sin haber corregido la conexión original.

## Identifica el proveedor y la beta que se rechaza

Conserva el mensaje completo del error. Un `400` aislado también puede corresponder a otro parámetro no válido; necesitas el texto que identifica la beta para seguir este diagnóstico. Anota estos datos del turno que falla:

- Proveedor y modelo seleccionados en esa conversación, incluido cualquier modelo de respaldo que haya intervenido.
- Servicio de destino: API directa de Anthropic, proxy compatible, Amazon Bedrock u otra integración gestionada.
- Nombre exacto de la beta y encabezado que la solicita, normalmente `anthropic-beta` en la API directa.
- Versión de OpenClaw, proceso del Gateway y configuración que utiliza ese proceso.

En el equipo del Gateway, estas consultas ayudan a situar el problema:

```bash
openclaw --version
openclaw config file
openclaw gateway status
openclaw logs --follow
```

`config file` localiza el archivo activo para la ejecución de la CLI. Comprueba que estás usando el mismo usuario, perfil y entorno que el servicio; de lo contrario, podrías inspeccionar una configuración distinta. En la conversación afectada, `/model status` permite comprobar su selección de modelo. El predeterminado global y una selección fijada para la sesión pueden diferir, como explica nuestra [guía para configurar los modelos de OpenClaw](https://blog.laozhang.ai/es/posts/openclaw-llm-setup).

Los registros sirven para correlacionar la petición y la respuesta. Si no muestran los encabezados salientes, pide al administrador del proxy una captura depurada de esa petición; no habilites volcados de claves o conversaciones privadas para obtenerla. Conserva el identificador de solicitud si está disponible y oculta credenciales, cookies y contenido sensible al compartir el caso. La [guía oficial de solución de problemas](https://docs.openclaw.ai/es/gateway/troubleshooting) separa los registros y el estado del servicio de los fallos del proveedor.

## Encuentra dónde se añade `anthropic-beta`

![Diagrama conceptual de los tres lugares que pueden añadir una beta: configuración explícita, adaptador de OpenClaw y proxy](https://blog.laozhang.ai/posts/es/openclaw-invalid-beta-flag/img/origen-beta.webp)

El nombre del modelo no basta para saber quién incorpora el encabezado. Distingue tres posibilidades y cambia únicamente la que esté acreditada:

| Origen de la beta | Qué debes comprobar | Cambio que corresponde |
|---|---|---|
| Encabezado explícito en la configuración | `models.providers` del proveedor real y su campo `headers` | Retirar el valor incompatible o sustituir la lista por las betas admitidas que sí necesitas |
| Función activada o comportamiento automático de OpenClaw | Función solicitada, versión instalada, adaptador y destino | Corregir la selección de conexión o la opción que activa esa función; actualizar si existe una corrección aplicable |
| Encabezado añadido por un proxy | Petición que recibe y petición que envía el intermediario | Corregir su regla de transformación, con el administrador del proxy |

La documentación actual de [proveedores personalizados de OpenClaw](https://docs.openclaw.ai/concepts/model-providers/custom-providers) indica que, con `api: "anthropic-messages"`, las conexiones no directas suprimen las betas implícitas de Anthropic. La distinción incluye un proveedor distinto del identificador canónico `anthropic` o una URL base personalizada de `anthropic` que no apunte al servicio público `api.anthropic.com`. Aun así, un encabezado explícito en `models.providers.<id>.headers["anthropic-beta"]` puede solicitar funciones beta al proxy.

Por eso, si el proxy recibe una beta inesperada, revisa tanto los encabezados explícitos como la versión del adaptador y las reglas del intermediario. La ausencia del campo en el archivo no demuestra que nadie añada el encabezado después.

En conexiones directas con clave API, OpenClaw también documenta betas automáticas asociadas a determinadas funciones y modelos, como controles del razonamiento conservado o del contexto de la conversación. No todas proceden de una opción que tú hayas escrito. Esos comportamientos tienen condiciones distintas para OAuth, proxies y servicios gestionados; consulta la [guía de Anthropic en OpenClaw](https://docs.openclaw.ai/providers/anthropic) antes de desactivar una función que necesitas.

## Corrige sólo la beta incompatible

Primero consulta la [documentación de la beta concreta](https://platform.claude.com/docs/en/api/beta-headers): su nombre exacto, disponibilidad, modelos, endpoint y requisitos de acceso. Que una beta exista no significa que esté disponible para cualquier organización o intermediario. La API admite varias betas separadas por comas o en encabezados repetidos; si una de ellas falla, no des por inválidas las demás.

**Si la beta es opcional y está declarada explícitamente**, retira sólo ese valor. Si compartía la lista con funciones necesarias, conserva las demás. Si la necesitas, corrige el nombre o los requisitos de acceso, o utiliza un adaptador compatible con esa función y con tu proveedor elegido. Evita eliminar el encabezado entero mientras no sepas qué funciones dependen de él.

Este ejemplo corresponde únicamente a un proveedor personalizado cuyo identificador es `mi-proxy`. Sustituye ese identificador por el real. La consulta permite revisar el valor configurado:

```bash
openclaw config get 'models.providers["mi-proxy"].headers["anthropic-beta"]'
```

**Sólo si ese campo contiene exclusivamente una beta incompatible que no necesitas**, puedes eliminar el campo completo:

```bash
openclaw config unset 'models.providers["mi-proxy"].headers["anthropic-beta"]'
openclaw config validate
```

Es un ejemplo condicionado, no una limpieza general del proveedor. Guarda una copia recuperable del archivo antes de modificarlo y no borres `Authorization`, claves, perfiles o el resto de `headers`. Si hay varias betas en el campo, edita su valor para excluir únicamente la rechazada y valida después.

La [referencia de `openclaw config`](https://docs.openclaw.ai/cli/config) explica que `unset` sobre una ruta que no existe devuelve un estado de error sin cambiarla. En ese caso, vuelve a localizar el origen; repetir el comando no elimina una beta añadida por el adaptador o el proxy. Las instalaciones de configuración de sólo lectura, incluidas las gestionadas mediante Nix, requieren cambiar la fuente que genera el archivo.

**Si la beta la añade una función de OpenClaw**, actúa sobre esa función y comprueba las notas o instrucciones correspondientes a tu versión. No añadas `beta_features: []` sólo porque aparezca en una respuesta de un buscador: no es una corrección universal documentada para estas conexiones. Tampoco hagas pasar una conexión proxy por la API directa de Anthropic para forzar otro comportamiento automático; conserva el proveedor, el adaptador y la URL que describen tu conexión real.

## `context1m: false` ya no es una solución general

Si el error nombra `context-1m-2025-08-07`, comprueba qué componente sigue enviando ese valor. La documentación actual de [OpenClaw para Anthropic](https://docs.openclaw.ai/providers/anthropic) indica que ese encabezado está retirado: OpenClaw ya no lo envía y elimina las entradas antiguas con ese valor durante la resolución de encabezados. Para los modelos que la misma guía enumera con contexto de un millón de tokens de disponibilidad general, `params.context1m` no modifica ese comportamiento.

Por tanto, poner `context1m: false` no demuestra que se haya retirado el encabezado de la petición. Si sigue apareciendo, comprueba la versión que ejecuta el servicio, una configuración explícita y cualquier proxy que lo añada. No atribuyas automáticamente el error a la capacidad de contexto del modelo.

Esto tampoco significa que todos los modelos o ejecuciones tengan una ventana de un millón de tokens. Claude CLI tiene su propio presupuesto de contexto y condiciones de acceso; el soporte de la API no lo configura automáticamente. Un **429 relacionado con la elegibilidad para contexto largo** requiere otro diagnóstico y no es el mismo rechazo de una beta mediante 400.

## Bedrock y Vertex requieren su integración correspondiente

Una beta aceptada por la API directa de Claude puede no tener el mismo mecanismo en un servicio gestionado. Antes de cambiar parámetros, identifica el producto y el endpoint reales:

| Conexión | Qué cambia para este diagnóstico |
|---|---|
| API directa de Claude | `anthropic-beta` solicita una beta documentada; comprueba nombre y acceso para la función concreta |
| Proxy compatible con Anthropic Messages | El proxy debe admitir la beta y transmitirla correctamente; compatibilidad con Messages no prueba compatibilidad con todas las funciones |
| Amazon Bedrock, operado por AWS | Utiliza la integración y autenticación de AWS; no copies el encabezado beta estándar de la API directa a sus interfaces |
| Claude Platform on AWS, operado por Anthropic | Es un producto distinto de Bedrock; admite el mecanismo de encabezados beta con las excepciones que documenta para cada función |
| Claude en Vertex AI | Utiliza la API y autenticación de Google Cloud para Claude; comprueba el soporte específico de la función y del adaptador |

La [comparación oficial de Claude Platform on AWS y Bedrock](https://platform.claude.com/docs/en/build-with-claude/claude-platform-on-aws) distingue sus APIs y el soporte del encabezado beta. No basta con saber que el servidor está en AWS. OpenClaw documenta el proveedor específico `amazon-bedrock` con credenciales AWS y región. Su [guía de Bedrock](https://docs.openclaw.ai/providers/bedrock) incluye tanto conexiones Converse como modelos actuales con Messages; no todos los modelos Claude en Bedrock utilizan Converse.

Para [Claude en Vertex AI](https://platform.claude.com/docs/en/build-with-claude/claude-on-vertex-ai), el modelo forma parte de la URL y el cuerpo utiliza `anthropic_version: "vertex-2023-10-16"`, junto con la autenticación de Google Cloud. Esto no establece una prohibición universal de betas en Vertex: hay que comprobar la función elegida. Además, el proveedor `google-vertex` de la [guía de Google de OpenClaw](https://docs.openclaw.ai/providers/google) describe Gemini; seleccionarlo no configura por sí solo Claude en Vertex ni corrige sus encabezados. Si empleas un adaptador personalizado, sigue las instrucciones de su responsable para esa integración.

Cambiar de infraestructura puede ser una decisión válida si necesitas una función que tu conexión no ofrece, pero incluye autenticación, disponibilidad y configuración nuevas. Hazlo como una migración deliberada, no como una sustitución de URL para ocultar el error.

## Comprueba la carga del cambio y una respuesta completa

![Ilustración de dos comprobaciones distintas: cargar el cambio en el Gateway y recibir una respuesta completa por la misma conexión](https://blog.laozhang.ai/posts/es/openclaw-invalid-beta-flag/img/respuesta-completa.webp)

Después de modificar la configuración, valida el archivo y sigue la indicación de recarga o reinicio que dé tu instalación. `openclaw config validate` comprueba la configuración sin iniciar el Gateway; un parámetro puede ser válido para OpenClaw y ser rechazado por el proveedor. La indicación de recarga expresa qué debería ocurrir, no confirma que el proceso ya haya aplicado el cambio. Son límites expresos de la [CLI de configuración](https://docs.openclaw.ai/cli/config).

Comprueba la carga efectiva en el proceso correcto. Si hace falta reiniciar, coordina la interrupción y confirma después el estado del servicio. A continuación, envía una petición breve en la conversación afectada, con el mismo proveedor, modelo y selección de cuenta. **Es una llamada real que puede consumir tokens.** Para dar por recuperada esa conexión, necesitas una respuesta que termine correctamente, sin el rechazo de la beta, y comprobar que la función que querías conservar sigue disponible. Un fragmento recibido durante el streaming no confirma que el turno haya terminado bien.

Interpreta el resultado antes de seguir cambiando opciones:

- **Desaparece la beta rechazada y termina la respuesta por la misma conexión:** el cambio ha resuelto ese rechazo para la prueba realizada. No extrapoles a otros modelos o funciones.
- **La petición sigue llevando la misma beta:** revisa carga, versión, encabezados explícitos y proxy. No sigas desactivando opciones sin localizar su origen.
- **La beta ha desaparecido pero aparece otro error:** trata el nuevo síntoma. Un 401 exige [comprobar la autenticación de OpenClaw](https://blog.laozhang.ai/es/posts/openclaw-401-authentication-error); un límite de uso o un fallo del servidor necesita su propio diagnóstico.
- **La función es necesaria y el destino no la admite:** detén los reintentos idénticos y solicita una conexión compatible o soporte del proveedor. Si necesitas ayuda, aporta versión, modelo, endpoint depurado, beta exacta e identificador de solicitud.

Esta guía se basa en documentación oficial; los ejemplos de comandos se han comprobado de forma local sin ejecutar OpenClaw ni enviar peticiones al modelo. No representan una recuperación observada de una instalación real.

## Preguntas frecuentes

### ¿Basta con reiniciar el Gateway para corregir `invalid beta flag`?

Sólo si el reinicio aplica un cambio correcto que estaba pendiente de cargar. Reiniciar una configuración idéntica no concede acceso a una beta ni cambia el soporte del proveedor. Una configuración válida y un Gateway activo deben completarse con una respuesta real por la conexión afectada.

### ¿Puedo borrar todo `anthropic-beta`?

Puedes retirar el campo si contiene únicamente una beta incompatible que no necesitas. Si incluye funciones necesarias, conserva sus valores admitidos y elimina sólo el rechazado. Si OpenClaw o un proxy lo añade automáticamente, borrar un campo inexistente no modifica la petición.

### ¿El error significa que mi clave API es incorrecta?

No por sí solo. La [documentación de Anthropic](https://platform.claude.com/docs/en/api/beta-headers) incluye nombres beta no válidos y falta de acceso a la beta entre las causas del 400. Comprueba el mensaje completo; renovar credenciales a ciegas no corrige un encabezado incompatible.

### ¿Por qué una conversación funciona y otra falla?

Pueden seleccionar modelos, proveedores, perfiles o funciones diferentes. Compara `/model status`, la beta solicitada y el destino de ambas. Una respuesta correcta de otra conversación sólo prueba su propia conexión; no demuestra que se haya corregido la que fallaba.