Arnés de Codex

​

Requisitos

• OpenClaw con el Plugin codex incluido disponible. Incluye codex en plugins.allow si tu configuración usa una lista de permitidos.
• Codex app-server 0.125.0 o posterior. El Plugin gestiona un binario compatible de forma predeterminada, 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 de app-server ya presente en el directorio home de Codex del agente, o un perfil explícito de autenticación de Codex con clave de API.

​

Inicio rápido

openclaw models auth login --provider openai

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

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

​

Compartir hilos con Codex Desktop y CLI

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

​

Configuración

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

​

Compaction

​

Verificar el runtime de Codex

Runtime: OpenAI Codex

/codex status
/codex models

​

Enrutamiento y selección de modelo

• Usa openai/gpt-* para turnos de agente de OpenAI mediante Codex.
• No uses referencias GPT heredadas de Codex 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 de forma cerrada si Codex no está disponible.
• agentRuntime.id: "openclaw" hace que un proveedor o modelo use el runtime incrustado de OpenClaw cuando esa sea la intención.
• /codex ... controla conversaciones nativas de Codex app-server 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 proveedor mixto

{
  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 de Codex con fallo cerrado

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

​

Política del servidor de aplicaciones

{
  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 servidor de aplicaciones, modelos, cuenta, límites de tasa, servidores MCP y skills.
• /codex models enumera los modelos activos del servidor de aplicaciones de Codex.
• /codex threads [filter] enumera hilos recientes del servidor de aplicaciones de Codex.
• /codex resume <thread-id> adjunta la sesión actual de OpenClaw a un hilo existente de Codex.
• /codex bind [thread-id] [--cwd <path>] [--model <model>] [--provider <provider>] adjunta el chat actual.
• /codex detach (o /codex unbind) elimina la vinculación actual.
• /codex binding describe la vinculació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 por conversación.
• /codex compact pide al servidor de aplicaciones de Codex que compacte el hilo adjunto.
• /codex review inicia la revisión nativa de Codex para el hilo adjunto.
• /codex diagnostics [note] pregunta antes de enviar feedback de Codex para el hilo adjunto.
• /codex account muestra el estado de cuenta y límite de tasa.
• /codex mcp enumera el estado de servidores MCP del servidor de aplicaciones de Codex.
• /codex skills enumera las skills del servidor de aplicaciones de Codex.
• /codex plugins list, /codex plugins enable <name> y /codex plugins disable <name> administran Plugins nativos configurados de Codex.
• /codex computer-use [status|install] administra Codex Computer Use.
• /codex help enumera el árbol completo de comandos.

​

Inspeccionar hilos de Codex localmente

codex resume <thread-id>

​

Orden de autenticación

1. Perfiles de autenticación de OpenAI ordenados para el agente, preferiblemente bajo auth.order.openai. Ejecute openclaw doctor --fix para migrar ids heredados antiguos de perfiles de autenticación de Codex y el orden de autenticación heredado de Codex.
2. La cuenta existente del servidor de aplicaciones en el home de Codex de ese agente.
3. Solo para lanzamientos locales del servidor de aplicaciones stdio, CODEX_API_KEY, luego OPENAI_API_KEY, cuando no hay ninguna cuenta de servidor de aplicaciones presente y la autenticación de OpenAI todavía es necesaria.

​

Aislamiento de 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 dinámicos de llamadas a herramientas

​

Sobrescrituras del entorno de pruebas local

• OPENCLAW_CODEX_APP_SERVER_BIN omite el binario administrado cuando appServer.command no está definido.
• 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 de computadora

​

Límites de runtime

• Las herramientas dinámicas de OpenClaw son compatibles. Codex le 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 aplicación 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 dueño de la Compaction nativa. OpenClaw mantiene un espejo de transcripción para el historial del canal, búsqueda, /new, /reset y futuros cambios de modelo o arnés, pero no reemplaza la Compaction de Codex con un resumidor de OpenClaw o del motor de contexto.
• La generación de medios, la comprensión de medios, TTS, aprobaciones y la salida de herramientas de mensajería continúan mediante la configuración correspondiente 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

(
  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

​

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
• Ayuda de OpenAI Codex
• Plugins de harness de agente
• Hooks de Plugin
• Exportación de diagnósticos
• Status
• Pruebas