Entorno de Codex

​

Requisitos

• El plugin oficial @openclaw/codex instalado. Incluya codex en plugins.allow si la configuración usa una lista de permitidos.
• Un app-server estable de Codex desde 0.143.0 hasta 0.145.0. El plugin administra de forma predeterminada un binario compatible, por lo que un comando codex en PATH no afecta al inicio normal.
• Autenticación de Codex mediante openclaw models auth login --provider openai, una cuenta del app-server ya presente en el directorio principal de Codex del agente o un perfil explícito de autenticación con clave de API de Codex.

​

Inicio rápido

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

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

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

​

Compartir hilos con Codex Desktop y la CLI

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            homeScope: "user",
          },
        },
      },
    },
  },
}

​

Supervisar sesiones de Codex

​

Configuración

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

​

Compaction

​

Contexto largo de la API directa

{
  "context_window": 922000,
  "max_context_window": 922000,
  "auto_compact_token_limit": 700000
}

model = "gpt-5.6-terra"
model_provider = "openai_api_direct"
model_context_window = 922000
model_auto_compact_token_limit = 700000
model_auto_compact_token_limit_scope = "total"
model_catalog_json = "/absolute/path/to/models-api-1m.json"

[model_providers.openai_api_direct]
name = "OpenAI API direct"
base_url = "https://api.openai.com/v1"
wire_api = "responses"
requires_openai_auth = false

[model_providers.openai_api_direct.auth]
command = "/absolute/path/to/read-openai-inference-key"
timeout_ms = 5000
refresh_interval_ms = 300000

{
  auth: {
    order: {
      openai: ["openai:api-key"],
    },
  },
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            args: [
              "app-server",
              "--listen",
              "stdio://",
              "-c",
              'model_catalog_json="/absolute/path/to/models-api-1m.json"',
              "-c",
              "model_context_window=922000",
              "-c",
              "model_auto_compact_token_limit=700000",
              "-c",
              "model_auto_compact_token_limit_scope=total",
            ],
          },
        },
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.6-terra",
      models: {
        "openai/gpt-5.6-terra": { agentRuntime: { id: "codex" } },
      },
    },
  },
}

​

Verificar el entorno de ejecución de Codex

Entorno de ejecución: OpenAI Codex

/codex status
/codex models
/codex binding

​

Enrutamiento y selección de modelos

• Use openai/gpt-* para la selección canónica de modelos de OpenAI. El prefijo por sí solo nunca selecciona Codex.
• Cuando el entorno de ejecución no está establecido o es auto, solo una ruta oficial HTTPS exacta de Platform Responses o ChatGPT Responses sin ninguna sustitución de solicitud definida puede seleccionar Codex implícitamente.
• No use referencias heredadas de GPT de Codex en la configuración; ejecute openclaw doctor --fix para reparar las referencias heredadas y las fijaciones obsoletas de rutas de sesión.
• agentRuntime.id: "codex" convierte Codex en un requisito con cierre ante fallos para una ruta compatible. No convierte en compatible una ruta efectiva incompatible.
• agentRuntime.id: "openclaw" habilita para un proveedor o modelo el entorno de ejecución integrado de OpenClaw cuando esto es intencionado.
• /codex ... controla las conversaciones nativas del servidor de aplicaciones de Codex desde el chat.
• ACP/acpx es una ruta de arnés externo independiente. Úsela solo cuando el usuario solicite 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.6-sol",
    },
  },
}

​

Despliegue con varios proveedores

{
  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.6-sol",
      },
    ],
  },
}

​

Despliegue de Codex con cierre ante fallos

{
  models: {
    providers: {
      openai: {
        agentRuntime: {
          id: "codex",
        },
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.6-sol",
    },
  },
  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}",
          },
        },
      },
    },
  },
}

{
  tools: {
    exec: {
      mode: "auto",
    },
  },
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
}

​

Comandos y diagnósticos

• /codex status comprueba la conectividad del app-server, los modelos, la cuenta, los límites de uso, los servidores MCP y las skills.
• /codex models enumera los modelos activos del app-server de Codex.
• /codex threads [filter] enumera los hilos recientes del app-server de Codex.
• /codex goal lee o actualiza el objetivo nativo de Codex del hilo adjunto. La continuación automática de objetivos de Codex permanece deshabilitada; OpenClaw todavía no controla turnos de seguimiento autónomos.
• /codex resume <thread-id> asocia la sesión actual de OpenClaw con un hilo de Codex existente.
• /codex bind [thread-id] [--cwd <path>] [--model <model>] [--provider <provider>] asocia el chat actual.
• /codex detach (o /codex unbind) desvincula la asociación actual.
• /codex binding describe la asociación actual.
• /codex stop detiene el turno activo; /codex steer <text> lo dirige.
• /codex model <model>, /codex fast [on|off|status] y /codex permissions [default|yolo|status] cambian el estado de cada conversación.
• /codex compact solicita 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] solicita confirmación antes de enviar comentarios de Codex sobre el hilo adjunto.
• /codex account muestra el estado de la cuenta y de los límites de uso.
• /codex mcp enumera el estado de los servidores MCP del app-server de Codex.
• /codex skills enumera las skills del app-server de Codex.
• /codex plugins list, /codex plugins enable <name> y /codex plugins disable <name> gestionan los plugins nativos de Codex configurados.
• /codex computer-use [status|install] gestiona Computer Use de Codex.
• /codex help enumera el árbol de comandos completo.

​

Inspeccionar localmente los hilos de Codex

codex resume <thread-id>

​

Orden de autenticación

1. Perfiles de autenticación de OpenAI ordenados para el agente, preferiblemente en auth.order.openai. Ejecute openclaw doctor --fix para migrar los identificadores de perfiles de autenticación heredados de Codex y el orden de autenticación heredado de Codex.
2. La cuenta existente del app-server en el directorio de inicio de Codex de ese agente.
3. Solo para inicios locales del app-server mediante stdio, CODEX_API_KEY y después OPENAI_API_KEY, cuando no hay ninguna cuenta del app-server y aún se requiere autenticación de OpenAI.

​

Aislamiento del entorno

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

​

Herramientas dinámicas y búsqueda web

​

Campos de configuración

{
  plugins: {
    entries: {
      codex: {
        config: {
          appServer: {
            sandbox: "workspace-write",
            networkProxy: {
              enabled: true,
              domains: {
                "api.openai.com": "allow",
                "blocked.example.com": "deny",
              },
              unixSockets: {
                "/tmp/proxy.sock": "allow",
                "/tmp/blocked.sock": "none",
              },
              allowUpstreamProxy: true,
              proxyUrl: "http://127.0.0.1:3128",
            },
          },
        },
      },
    },
  },
}

​

Tiempos de espera de llamadas dinámicas a herramientas

​

Sustituciones de entorno para pruebas locales

• OPENCLAW_CODEX_APP_SERVER_BIN omite el binario administrado cuando appServer.command no está establecido.
• 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",
              },
            },
          },
        },
      },
    },
  },
}

​

Uso del equipo

​

Límites del entorno de ejecución

• Se admiten las herramientas dinámicas de OpenClaw. Codex solicita a OpenClaw que ejecute esas herramientas, por lo que OpenClaw permanece en la ruta de ejecución.
• El shell, los parches, MCP y las herramientas de aplicaciones nativas de Codex son gestionados por Codex. OpenClaw puede observar o bloquear determinados eventos nativos mediante la retransmisión compatible, pero no reescribe los argumentos de las herramientas nativas.
• Codex gestiona la Compaction nativa. OpenClaw mantiene un duplicado de la transcripción para el historial del canal, la búsqueda, /new, /reset y futuros cambios de modelo o entorno, pero no sustituye la Compaction de Codex por un resumidor de OpenClaw o del motor de contexto.
• La generación multimedia, la comprensión multimedia, TTS, las aprobaciones y la salida de las herramientas de mensajería siguen pasando por la configuración correspondiente del proveedor o 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

(
  pattern='openai/gpt-5\.[45]|openai[-]codex|agentRuntime(\.id)?|harnessRuntime|Runtime: OpenAI Codex|legacy OpenAI Codex prefix|resolveSelectedOpenAIRuntimeProvider|candidateProvider[": ]+openai|status[": ]+401|Incorrect API key|No API key|api-key path|API-key path|OAuth'

  if ls /tmp/openclaw/openclaw-*.log >/dev/null 2>&1; then
    grep -E -i -n "$pattern" /tmp/openclaw/openclaw-*.log 2>/dev/null || true
  else
    journalctl --user -u openclaw-gateway --since today --no-pager 2>/dev/null \
      | grep -E -i "$pattern" || true
  fi
) | sed -E \
    -e 's/(Authorization: Bearer )[A-Za-z0-9._~+\/-]+/\1[REDACTED]/Ig' \
    -e 's/(Bearer )[A-Za-z0-9._~+\/-]+/\1[REDACTED]/Ig' \
    -e 's/(api[_ -]?key[=: ]+)[^ ,}"]+/\1[REDACTED]/Ig' \
    -e 's/(OPENAI_API_KEY[=: ]+)[^ ,}"]+/\1[REDACTED]/Ig' \
    -e 's/sk-[A-Za-z0-9_-]{12,}/sk-[REDACTED]/g' \
    -e 's/[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/[EMAIL-REDACTED]/g' \
  | tail -200

{
  plugins: {
    entries: {
      codex: {
        config: {
          appServer: {
            args: ["-c", "agents.max_threads=3", "app-server", "--listen", "stdio://"],
          },
        },
      },
    },
  },
}

​

Relacionado

• Referencia del entorno de Codex
• Entorno de ejecución de Codex
• Supervisión de Codex
• Plugins nativos de Codex
• Computer Use de Codex
• Entornos de ejecución de agentes
• Proveedores de modelos
• Proveedor OpenAI
• Ayuda de OpenAI Codex
• Plugins de entorno de agentes
• Hooks de plugins
• Exportación de diagnósticos
• Estado
• Pruebas