Codex-Harness-Referenz

​

Plugin-Konfigurationsoberfläche

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

​

Überwachung

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

​

App-Server-Transport

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",
            },
          },
        },
      },
    },
  },
};

​

Genehmigungs- und Sandbox-Modi

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

​

Native Ausführung in der Sandbox

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

​

Authentifizierungs- und Umgebungsisolation

1. Ein explizites OpenClaw-Codex-Authentifizierungsprofil für den Agenten.
2. Das bestehende Konto des App-Servers im Codex-Home-Verzeichnis dieses Agenten.
3. Nur für lokale stdio-App-Server-Starts: CODEX_API_KEY, anschließend OPENAI_API_KEY, wenn kein App-Server-Konto vorhanden ist und weiterhin eine OpenAI-Authentifizierung erforderlich ist.

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

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

​

Dynamische Tools

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

​

Zeitüberschreitungen

• Ein positives aufrufbezogenes Argument timeoutMs.
• Für image_generate: agents.defaults.mediaModels.image.timeoutMs.
• Für image_generate ohne konfigurierte Zeitüberschreitung gilt der Standardwert von 120 Sekunden für die Bilderzeugung.
• Für das Medienanalyse-Tool image: der Wert timeoutSeconds des ausgewählten bildfähigen Eintrags tools.media.models[], umgerechnet in Millisekunden, oder der Medienstandardwert von 60 Sekunden. Bei der Bildanalyse gilt dies für die Anfrage selbst und wird nicht durch vorherige Vorbereitungsarbeiten reduziert.
• Für das Tool message: ein festes äußeres Zeitbudget von 600 Sekunden, das die Gateway-Zustellung und den begrenzten Abgleich für denselben Schlüssel abdeckt.
• Der Standardwert von 90 Sekunden für dynamische Tools.

​

Modellerkennung

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

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

​

Bootstrap-Dateien des Arbeitsbereichs

• TOOLS.md wird als geerbte Codex-Entwickleranweisung weitergeleitet, sodass native Codex-Subagenten, die während des Turns gestartet werden, sie ebenfalls sehen.
• SOUL.md, IDENTITY.md und USER.md werden als turnbezogene Zusammenarbeitsanweisungen weitergeleitet. Native Codex-Subagenten erben sie nicht, wodurch verhindert wird, dass Subagenten-Turns die Persona und das Benutzerprofil des übergeordneten Agenten übernehmen.
• Die kompakte Liste der geladenen OpenClaw-Skills wird ebenfalls als turnbezogene Entwickleranweisung zur Zusammenarbeit weitergeleitet, sodass native Codex-Subagenten auch sie nicht erben.
• Der Inhalt von HEARTBEAT.md wird nicht eingefügt; Heartbeat-Turns erhalten einen Hinweis im Zusammenarbeitsmodus, die Datei zu lesen, wenn sie vorhanden und nicht leer ist.
• Der Inhalt von MEMORY.md aus dem konfigurierten Agentenarbeitsbereich wird nicht in die Eingabe nativer Codex-Turns eingefügt, wenn für diesen Arbeitsbereich Speicher-Tools verfügbar sind; wenn er vorhanden ist, fügt das Harness den turnbezogenen Entwickleranweisungen zur Zusammenarbeit einen kurzen Hinweis auf den Arbeitsbereichsspeicher hinzu, und Codex sollte memory_search oder memory_get verwenden, wenn dauerhafter Speicher relevant ist. Wenn Tools deaktiviert sind, die Speichersuche nicht verfügbar ist oder der aktive Arbeitsbereich vom Agentenspeicher-Arbeitsbereich abweicht, verwendet MEMORY.md stattdessen den normalen begrenzten Turn-Kontextpfad.
• BOOTSTRAP.md wird, sofern vorhanden, als Referenzkontext für OpenClaw-Turn-Eingaben weitergeleitet.

​

Umgebungsüberschreibungen

• 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

​

Verwandte Themen

• Codex-Harness
• Codex-Harness-Laufzeit
• Codex-Überwachung
• Native Codex-Plugins
• Codex-Computersteuerung
• OpenAI-Provider
• Konfigurationsreferenz