Referencia del arnés de Codex

​

Superficie de configuración del Plugin

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          discovery: {
            enabled: true,
            timeoutMs: 2500,
          },
          appServer: {
            mode: "guardian",
          },
        },
      },
    },
  },
}

​

Transporte del app-server

codex app-server --listen stdio://

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

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

​

Modos de aprobación y sandbox

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

​

Ejecución nativa en sandbox

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            experimental: {
              sandboxExecServer: true,
            },
          },
        },
      },
    },
  },
}

​

Aislamiento de autenticación y entorno

1. Un perfil explícito de autenticación Codex de OpenClaw para el agente.
2. La cuenta existente del servidor de aplicaciones en el home de Codex de ese agente.
3. Solo para lanzamientos locales de servidor de aplicaciones por stdio, CODEX_API_KEY, luego OPENAI_API_KEY, cuando no hay ninguna cuenta de servidor de aplicaciones presente y la autenticación OpenAI aún es necesaria.

openclaw migrate codex --dry-run
openclaw migrate apply codex --yes

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

​

Herramientas dinámicas

• read
• write
• edit
• apply_patch
• exec
• process
• update_plan
• tool_call
• tool_describe
• tool_search
• tool_search_code

​

Tiempos de espera

• Un argumento positivo timeoutMs por llamada.
• Para image_generate, agents.defaults.imageGenerationModel.timeoutMs.
• Para image_generate sin un timeout configurado, el valor predeterminado de generación de imágenes de 120 segundos.
• Para la herramienta image de comprensión de medios, tools.media.image.timeoutSeconds convertido a milisegundos, o el valor predeterminado de medios de 60 segundos. Para comprensión de imágenes, esto se aplica a la solicitud en sí y no se reduce por trabajo de preparación anterior.
• Para la herramienta message, un valor predeterminado fijo de 120 segundos.
• El valor predeterminado de herramientas dinámicas de 90 segundos.

​

Descubrimiento de modelos

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          discovery: {
            enabled: true,
            timeoutMs: 2500,
          },
        },
      },
    },
  },
}

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          discovery: {
            enabled: false,
          },
        },
      },
    },
  },
}

​

Archivos de arranque del espacio de trabajo

• TOOLS.md se reenvía como instrucciones de desarrollador de Codex heredadas, por lo que los subagentes nativos de Codex creados durante el turno también lo ven.
• SOUL.md, IDENTITY.md y USER.md se reenvían como instrucciones de colaboración con alcance de turno. Los subagentes nativos de Codex no las heredan, lo que evita que los turnos de subagente adopten la persona y el perfil de usuario del agente padre.
• La lista compacta cargada de Skills de OpenClaw también se reenvía como instrucciones de desarrollador de colaboración con alcance de turno, por lo que los subagentes nativos de Codex tampoco la heredan.
• El contenido de HEARTBEAT.md no se inyecta; los turnos de Heartbeat reciben un puntero en modo colaboración para leer el archivo cuando existe y no está vacío.
• El contenido de MEMORY.md del espacio de trabajo de agente configurado no se pega en la entrada del turno nativo de Codex cuando hay herramientas de memoria disponibles para ese espacio de trabajo; cuando existe, el arnés agrega un pequeño puntero de memoria de espacio de trabajo a las instrucciones de desarrollador de colaboración con alcance de turno y Codex debería usar memory_search o memory_get cuando la memoria duradera sea relevante. Si las herramientas están desactivadas, la búsqueda de memoria no está disponible o el espacio de trabajo activo difiere del espacio de trabajo de memoria del agente, MEMORY.md usa en su lugar la ruta normal acotada de contexto de turno.
• BOOTSTRAP.md, cuando está presente, se reenvía como contexto de referencia de entrada de turno de OpenClaw.

​

Sobrescrituras de entorno

• 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

​

Relacionado

• Arnés de Codex
• Runtime del arnés de Codex
• Plugins nativos de Codex
• Uso de computadora de Codex
• Proveedor de OpenAI
• Referencia de configuración