Arnés Codex de OpenClaw: sesiones, credenciales y facturación

El arnés de Codex de OpenClaw es el plugin oficial @openclaw/codex: entrega un turno de agente de OpenClaw al app-server Codex de OpenAI para que Codex se encargue del bucle del modelo, la reanudación del hilo, la continuación de herramientas y la compactación. No es un producto de delegación de programación, no es una capa de facturación y —la parte que confunde a la mayoría de las configuraciones— tampoco es una forma de ejecutar Codex contra un endpoint de API de terceros. Cuál de esas cosas necesitas realmente es la decisión que esta página pretende ayudarte a tomar.

Primero las fechas, para que nada de lo indicado aquí quede sin fecha. El paquete npm openclaw está en 2026.9.5 y requiere Node >=24.16.0 <25 || >=26.1.0; @openclaw/codex está en 2026.9.5, publicado el 18 de septiembre de 2026. Ambos se consultaron en el registro el 21 de septiembre de 2026. Tres proyectos no relacionados comparten estos nombres y ninguno de sus números corresponde aquí: pjasicek/OpenClaw se describe como una reimplementación del juego de plataformas de 1997 Captain Claw, el paquete npm sin ámbito codex es un «generador de sitios estáticos y documentación de código» cuya última publicación fue en 2012, y la CLI de OpenAI es @openai/codex (0.155.1 en la misma fecha).

Cinco superficies de OpenClaw comparten el nombre «Codex»

La documentación de agent-runtimes de OpenClaw las denomina «intencionadamente independientes». Elegir la incorrecta es la razón más común por la que una configuración parece correcta y no hace nada.

Un sexto nombre no pertenece en absoluto a OpenClaw. openclaw-code-agent es un plugin de terceros que ejecuta sesiones de programación en segundo plano con aprobación del plan y aislamiento del árbol de trabajo; su propio README indica que es independiente del plugin de tiempo de ejecución acpx incluido con OpenClaw y del plugin principal codex incluido. Si llegaste aquí buscando delegación en lugar de un cambio de tiempo de ejecución, se trata de otro producto con otras claves de configuración.

Activar el arnés y demostrar que está activado

La ruta documentada son dos comandos: el plugin y después el inicio de sesión.

openclaw plugins install @openclaw/codex
openclaw models auth login --provider openai

Después, la configuración mínima. Si utilizas una lista plugins.allow, añade también "codex".

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      // The docs' own example ref. Legacy codex-cli/* refs are
      // repaired to the same openai/<model> route by doctor --fix.
      model: "openai/gpt-6-astra",
    },
  },
}

La documentación del arnés es explícita sobre dos detalles. Los cambios de configuración del plugin se aplican automáticamente en el modo de recarga híbrida, pero un chat existente necesita primero /new o /reset para que el siguiente turno resuelva el arnés a partir de la configuración actual. Además, el perfil efectivo de herramientas debe permitir capacidades nativas de shell y sistema de archivos: coding y full las permiten, mientras que messaging y minimal desactivan la superficie nativa. Un sandbox ordinario de OpenClaw o una política de herramientas restringida es una limitación más estrecha descrita en la misma documentación: desactiva el modo de código nativo salvo que optes por la ruta experimental del servidor de ejecución del sandbox; y, cuando el sandbox desactiva la superficie nativa, los comandos de shell permitidos siguen siendo accesibles mediante sandbox_exec.

Requisitos de versión, comprobados el 21 de septiembre de 2026 contra la referencia del transporte del app-server: el plugin gestiona Codex app-server estable 0.154.0, mientras que los ejecutables personalizados explícitos, los app-server remotos y los binarios de escritorio de macOS deben informar de una versión semántica analizable de 0.149.0 o posterior. La última versión de npm de @openai/codex es 0.155.1 ese mismo día, por lo que la versión fijada gestionada está un parche por detrás; por eso cualquier tutorial que diga «última versión de Codex» sin fecha queda obsoleto en cuestión de días. También importa migrar una configuración antigua: la página de agent-runtimes indica que el backend de la CLI de Codex incluido con OpenClaw se eliminó en v2026.5.14, y que las referencias antiguas codex-cli/* se reparan hacia la misma ruta del app-server Codex openai/<model> bajo openclaw doctor --fix, que gestiona en general la reparación de rutas antiguas de Codex.

Para verificarlo: un turno respaldado por Codex informa de Runtime: OpenAI Codex en /status, y /codex status, /codex models y /codex binding inspeccionan el estado del app-server. Un lint —openclaw doctor --lint --only codex/managed-app-server --json— comprueba el binario gestionado, pero la documentación lo describe como de solo lectura y deja fuera de esa comprobación de paquete un binario seleccionado de Codex Desktop, un comando personalizado explícito y un app-server remoto.

Conviene conocer una tensión antes de basarte en esto. La propia documentación del app-server de OpenAI afirma que «el comando app-server y el transporte WebSocket son experimentales y no son compatibles con cargas de trabajo de producción»; observa que la advertencia menciona tanto el comando como el transporte. OpenClaw desarrolla una función distribuida sobre ese comando, y su campo transport tiene como valor predeterminado stdio, mientras que websocket solo se utiliza cuando configuras un url. Ambas afirmaciones son ciertas al mismo tiempo; decide teniendo presentes las dos.

Artefactos de delegación, permisos, cancelación y reanudación

La documentación del harness es honesta sobre los límites de lo que demuestra el estado de un subagente nativo: la ejecución, el resultado de la tarea y la entrega del resultado son hechos independientes; un hilo nativo inactivo, interrumpido o descargado no demuestra que la tarea haya tenido éxito; y, cuando no está disponible la confirmación del cierre, la tarea te pide que vuelvas a intentar cerrarlo. Los subagentes nativos de Codex son el mecanismo propio de Codex; la delegación explícita de OpenClaw o ACP sigue pasando por sessions_spawn.

Según la tabla de campos de configuración del plugin, los permisos de ejecución para el app-server que OpenClaw inicia tienen como valores predeterminados el modo yolo, la política de aprobación never y el sandbox danger-full-access, salvo que los requisitos locales de Codex no permitan esa configuración; en tal caso, los valores predeterminados del guardián prefieren las aprobaciones bajo petición y workspace-write; de lo contrario, read-only; requestTimeoutMs, el tiempo de espera de las llamadas al plano de control del app-server, tiene como valor predeterminado 60000. Estos son los valores predeterminados de OpenClaw para el proceso que inicia, no los propios de Codex CLI; en un repositorio desconocido, ese primer valor predeterminado es la configuración que debes revisar antes de la primera ejecución.

El control durante un turno es nativo: /codex stop, /codex steer, /codex resume, /codex detach, /codex bind, /codex compact, /codex threads, /codex goal, /codex model, /codex fast y /codex permissions. Un turno restringido se aplica por turno, no como modo de sesión, y desactiva únicamente durante ese turno el Code Mode nativo, las selecciones de entorno, los servidores MCP configurados y las retransmisiones de hooks nativos. El contrato de compatibilidad con runtime v1 de OpenClaw también indica como no compatibles: la mutación nativa de argumentos de herramientas (los hooks previos a la herramienta pueden bloquear, pero OpenClaw no reescribe los argumentos), un historial de transcripción nativo de Codex editable, la intervención de compactación y la captura byte por byte de las solicitudes a la API del modelo; por tanto, si tu requisito de auditoría es la solicitud saliente exacta, este runtime no puede proporcionarla.

La autorización, la habilitación del plan y el consumo de tokens son tres cosas diferentes

Leído en la página de políticas del app-server de Codex de OpenClaw el 21 de septiembre de 2026. Hay una confusión de nombres importante: la página de precios de la API de OpenAI indica que Priority processing pasó a llamarse Fast mode el 30 de julio de 2026 y que puedes enviar service_tier de "priority" o "fast", mientras que appServer.serviceTier de OpenClaw documenta "priority" y "flex" y normaliza un "fast" heredado a "priority"; en la dirección opuesta. «Activar el modo rápido» significa cosas diferentes en ambos sistemas.

Por qué un endpoint de terceros abandona el harness

Este es el único hecho que la mayoría de los análisis de terceros invierte. La tabla de runtime implícito por agente de OpenClaw, para un proveedor o runtime de modelo no establecido o auto, indica:

Por tanto, dirigir OpenClaw a cualquier URL base de terceros —incluido Kunavo— coloca el turno en el runtime integrado de OpenClaw, por diseño. El prefijo openai/* por sí solo nunca selecciona el harness, y forzar agentRuntime.id: "codex" no lo soluciona. La página de runtimes indica que esa configuración «requiere un harness de Codex registrado; las rutas o autenticaciones no compatibles fallan de forma cerrada, salvo que las sobrescrituras de solicitudes escritas por el usuario puedan usar el fallback exacto de OpenClaw declarado por Codex antes de la ejecución»; por tanto, los dos resultados posibles son un turno fallido o un turno de OpenClaw, y ninguno es Codex en un endpoint personalizado. Los campos de configuración documentados del plugin tampoco incluyen una configuración de URL base del modelo; el único campo url que aparece allí es la dirección WebSocket o unix:// propia del app-server. No está documentado ni probado si appServer.args podría introducir subrepticiamente una sobrescritura del proveedor en el app-server administrado; esta página no lo presenta como solución alternativa.

Una ruta del runtime integrado también transforma la solicitud, y la página de proveedores personalizados de OpenClaw especifica el alcance de cada regla. Para api: "openai-completions" en un endpoint no nativo —que define como cualquier baseUrl no vacío cuyo host no sea api.openai.com—, OpenClaw fuerza compat.supportsDeveloperRole a false y sobrescribe un true explícito. Por separado, las rutas compatibles con OpenAI de tipo proxy «omiten la transformación nativa de solicitudes exclusiva de OpenAI»: no hay service_tier, ni store de Responses, ni store de Completions, ni indicaciones de caché de prompts, ni transformación de payload compatible con el razonamiento de OpenAI, ni cabeceras de atribución ocultas. Sin service_tier en la red, Fast mode y Flex no se pueden seleccionar en esa ruta. Lo que ofrece esa misma página es el paso directo de params.extra_body para proxies de Completions compatibles con OpenAI, headers por proveedor y models.providers.<id>.timeoutSeconds para hosts lentos o remotos.

Codex es la otra mitad de la historia y es más permisivo: la página de configuración avanzada de Codex muestra ~/.codex/config.toml compatible con [model_providers.<id>] mediante base_url y env_key. Pero existe un límite estricto: la referencia de configuración establece que, para model_providers.<id>.wire_api, «responses es el único valor compatible y es el valor predeterminado cuando se omite». Por tanto, un endpoint que solo sirva Chat Completions no puede impulsar Codex. La misma página de configuración avanzada reserva los identificadores integrados openai, ollama y lmstudio, y enumera model_provider y model_providers entre las claves que Codex ignora en un .codex/config.toml a nivel de proyecto; por ello, las claves del proveedor deben estar en la configuración a nivel de usuario. Kunavo implementa una superficie nativa de Responses en /v1/responses, que es lo que hace posible la configuración de Codex CLI; pero eso es Codex CLI independiente, no el harness de OpenClaw, y Kunavo no ha probado en runtime ninguno de los dos clientes.

Cuánto cuesta el software y cuánto cuestan los tokens

OpenClaw en sí cuesta $0. Su índice de documentación describe el proyecto como licenciado bajo MIT, impulsado por la comunidad y desarrollado por una fundación independiente 501(c)(3), con «Ningún nivel de pago»; @openclaw/codex se publica gratuitamente en el registro npm público. Todo coste real corresponde a la máquina donde ejecutas el Gateway y al uso de modelos, y el uso de modelos llega mediante uno de tres contratos.

Según la página de precios de Codex de OpenAI, consultada el 21 de septiembre de 2026. Esta tabla debe incluir tres salvedades. La tarjeta de precios publica únicamente «Desde $100» para Pro; el artículo independiente de OpenAI Acerca de los niveles de ChatGPT Pro nombra un nivel superior de $200 cuyos nuevos registros y actualizaciones están pausados desde el 10 de septiembre de 2026, así que confirma el precio al finalizar la compra en lugar de presupuestar una cifra que esta página no vio en una tarjeta de precios. El uso incluido se publica únicamente como rangos estimados de mensajes locales por periodo de cinco horas, no como un número fijo de mensajes. Además, las tarifas de crédito después de los límites incluidos se publican en créditos por millón de tokens, sin valor en dólares para un crédito en esa página de precios; por tanto, no proporciona una conversión a dólares para esa fila. Por separado, GPT-5.5 se retira de ChatGPT, ChatGPT Work y Codex en todos los planes el 14 de octubre de 2026, mientras que la API de OpenAI no se ve afectada.

El tercer contrato es un gateway en el runtime integrado de OpenClaw. Supón un turno delegado que envía 180,000 tokens de entrada sin caché y recibe 9,000 tokens de salida; las tarifas son precios actuales del catálogo de Kunavo por millón de tokens.

Son cálculos ilustrativos de tokens, no costes de tareas medidos ni un límite máximo de facturación; la forma del turno es una suposición y un turno real de agente reenvía el contexto en cada intercambio de ida y vuelta con una herramienta. El importe del catálogo de Kunavo es un mínimo de facturación, no un límite máximo: cuando el upstream comunica su cargo, la factura es el mayor entre el coste del catálogo y el coste del upstream multiplicado por el margen aplicable. Los cargos de caché y las herramientas externas quedan fuera del ejemplo. La recarga mínima es $10 en crédito prepago, que financia un saldo en lugar de comprar un plan; consulta los detalles de facturación.

Kunavo no ofrece ningún modelo de embeddings, ningún modelo de texto a voz ni ningún modelo de voz a texto. Kunavo no sirve esos pasos en ninguna ruta, así que debes llevarlos a un proveedor que los ofrezca.

Ese límite es importante aquí porque la tabla de superficies anterior mantiene separada una ruta no perteneciente a agentes de OpenAI Platform del harness, y una clave del Gateway cubre únicamente los modelos de chat del catálogo de Kunavo.

Qué ruta gana en cada caso

Si la respuesta es la fila del gateway, empieza por la integración de Codex CLI para conocer la estructura de la API de Responses, compara las opciones en la mejor API para OpenClaw y la mejor API para Codex, y crea una cuenta de Kunavo cuando estés listo para financiar una clave. Para el aspecto presupuestario de un asistente autoalojado, los precios de OpenClaw separan el software, el alojamiento y el gasto en modelos.

Preguntas frecuentes

La tabla de runtimes, el orden de autenticación, la advertencia del app-server, el límite de wire_api, las versiones fijadas y los precios de los planes anteriores se obtuvieron el 21 de septiembre de 2026 de la documentación propia de OpenClaw y OpenAI, del centro de ayuda de OpenAI y de las entradas del registro npm para openclaw, @openclaw/codex, @openai/codex, codex y openclaw-code-agent. Cada afirmación enlaza con la página de la que procede; cuando un documento no resolvía una cuestión, el texto lo indica en lugar de completar la laguna. Kunavo no ha realizado ninguna prueba de runtime de OpenClaw ni del harness de Codex, por lo que toda configuración de aquí se ha comprobado frente a la documentación fuente, no frente al endpoint de Kunavo. Las tarifas de tokens de Kunavo proceden del catálogo actual, y cada cifra en dólares es un cálculo ilustrativo.