Arnés de Codex

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Requisitos

• OpenClaw con el Plugin codex incluido disponible.
• Si tu configuración usa plugins.allow, incluye codex.
• App-server de Codex 0.125.0 o posterior. El Plugin incluido gestiona un binario compatible del app-server de Codex de forma predeterminada, por lo que los comandos locales codex en PATH no afectan al inicio normal del arnés.
• Autenticación de Codex disponible mediante openclaw models auth login --provider openai-codex, una cuenta de app-server en el directorio de inicio de Codex del agente, o un perfil de autenticación explícito de clave de API de Codex.

​

Inicio rápido

openclaw models auth login --provider openai-codex

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
}

{
  plugins: {
    allow: ["codex"],
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
}

​

Configuración

{
  auth: {
    order: {
      openai: ["openai-codex:user@example.com", "openai:api-key-backup"],
    },
  },
}

​

Verificar el tiempo de ejecución de Codex

Runtime: OpenAI Codex

/codex status
/codex models

​

Enrutamiento y selección de modelo

• Usa openai/gpt-* para turnos de agente OpenAI a través de Codex.
• No uses openai-codex/gpt-* en la configuración. Ejecuta openclaw doctor --fix para reparar referencias heredadas y pines obsoletos de ruta de sesión.
• agentRuntime.id: "codex" es opcional para el modo automático normal de OpenAI, pero útil cuando un despliegue debe fallar en cerrado si Codex no está disponible.
• agentRuntime.id: "pi" opta un proveedor o modelo al comportamiento directo de PI cuando eso es intencional.
• /codex ... controla conversaciones nativas del app-server de Codex desde el chat.
• ACP/acpx es una ruta de arnés externo independiente. Úsala solo cuando el usuario pida ACP/acpx o un adaptador de arnés externo.

​

Patrones de despliegue

​

Despliegue básico de Codex

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
}

​

Despliegue con proveedores mixtos

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      model: "anthropic/claude-opus-4-6",
    },
    list: [
      {
        id: "main",
        default: true,
        model: "anthropic/claude-opus-4-6",
      },
      {
        id: "codex",
        name: "Codex",
        model: "openai/gpt-5.5",
      },
    ],
  },
}

​

Despliegue Codex con fallo en cerrado

{
  models: {
    providers: {
      openai: {
        agentRuntime: {
          id: "codex",
        },
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
}

​

Política del app-server

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            transport: "websocket",
            url: "ws://gateway-host:39175",
            authToken: "${CODEX_APP_SERVER_TOKEN}",
          },
        },
      },
    },
  },
}

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            mode: "guardian",
            serviceTier: "priority",
          },
        },
      },
    },
  },
}

​

Comandos y diagnósticos

• /codex status comprueba la conectividad de app-server, modelos, cuenta, límites de tasa, servidores MCP y skills.
• /codex models enumera los modelos activos de app-server de Codex.
• /codex threads [filter] enumera los hilos recientes de app-server de Codex.
• /codex resume <thread-id> adjunta la sesión actual de OpenClaw a un hilo existente de Codex.
• /codex compact pide al app-server de Codex que compacte el hilo adjunto.
• /codex review inicia la revisión nativa de Codex para el hilo adjunto.
• /codex diagnostics [note] pide confirmación antes de enviar feedback de Codex para el hilo adjunto.
• /codex account muestra el estado de la cuenta y de los límites de tasa.
• /codex mcp enumera el estado de los servidores MCP de app-server de Codex.
• /codex skills enumera las skills de app-server de Codex.

​

Inspeccionar hilos de Codex localmente

codex resume <thread-id>

1. Perfiles de autenticación de OpenAI ordenados para el agente, preferiblemente bajo auth.order.openai. Los ids de perfil existentes openai-codex:* siguen siendo válidos.
2. La cuenta existente de app-server en el home de Codex de ese agente.
3. Solo para lanzamientos locales de app-server stdio, CODEX_API_KEY, luego OPENAI_API_KEY, cuando no hay cuenta de app-server presente y la autenticación de OpenAI sigue siendo necesaria.

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            clearEnv: ["CODEX_API_KEY", "OPENAI_API_KEY"],
          },
        },
      },
    },
  },
}

• OPENCLAW_CODEX_APP_SERVER_BIN
• OPENCLAW_CODEX_APP_SERVER_ARGS
• OPENCLAW_CODEX_APP_SERVER_MODE=yolo|guardian
• OPENCLAW_CODEX_APP_SERVER_APPROVAL_POLICY
• OPENCLAW_CODEX_APP_SERVER_SANDBOX

​

Plugins nativos de Codex

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          codexPlugins: {
            enabled: true,
            allow_destructive_actions: true,
            plugins: {
              "google-calendar": {
                enabled: true,
                marketplaceName: "openai-curated",
                pluginName: "google-calendar",
              },
            },
          },
        },
      },
    },
  },
}

​

Computer Use

​

Límites de runtime

• Las herramientas dinámicas de OpenClaw son compatibles. Codex pide a OpenClaw que ejecute esas herramientas, por lo que OpenClaw permanece en la ruta de ejecución.
• Las herramientas nativas de shell, patch, MCP y app de Codex son propiedad de Codex. OpenClaw puede observar o bloquear eventos nativos seleccionados mediante el relay compatible, pero no reescribe los argumentos de herramientas nativas.
• Codex es propietario de la Compaction nativa. OpenClaw conserva un espejo de transcripción para el historial del canal, la búsqueda, /new, /reset y futuros cambios de modelo o harness.
• La generación de medios, la comprensión de medios, TTS, las aprobaciones y la salida de herramientas de mensajería continúan mediante los ajustes correspondientes de proveedor/modelo de OpenClaw.
• tool_result_persist se aplica a los resultados de herramientas de transcripción propiedad de OpenClaw, no a los registros de resultados de herramientas nativas de Codex.

​

Solución de problemas

​

Relacionado

• Referencia del harness de Codex
• Runtime del harness de Codex
• Plugins nativos de Codex
• Codex Computer Use
• Runtimes de agentes
• Proveedores de modelos
• Proveedor OpenAI
• Plugins de harness de agentes
• Hooks de Plugin
• Exportación de diagnósticos
• Estado
• Pruebas