Native Codex-Plugins

​

Anforderungen

• Die Agent-Runtime muss das native Codex-Harness sein.
• plugins.entries.codex.enabled ist true.
• plugins.entries.codex.config.codexPlugins.enabled ist true.
• Der Ziel-Codex-app-server kann auf den erwarteten Marketplace sowie den Plugin- und App-Bestand zugreifen.
• Die Migration unterstützt nur openai-curated-Plugins, die sie im Quell-Codex-Home als aus dem Quellcode installiert erkannt hat.
• Manuell konfigurierte workspace-directory-Plugins erfordern einen Codex-app-server, dessen plugin/list marketplaceKinds akzeptiert und dessen pfadlose Workspace- Zusammenfassungen remotePluginId enthalten. Das Plugin muss bereits installiert und aktiviert sein, und die zugehörigen Apps müssen in app/list zugänglich sein.

​

Schnellstart

openclaw migrate codex --dry-run

openclaw migrate codex --dry-run --verify-plugin-apps

openclaw migrate apply codex --yes

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

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          codexPlugins: {
            enabled: true,
            plugins: {
              "example-plugin": {
                enabled: true,
                marketplaceName: "workspace-directory",
                pluginName: "example-plugin@workspace-directory",
              },
            },
          },
        },
      },
    },
  },
}

​

Plugins über den Chat verwalten

/codex plugins
/codex plugins list
/codex plugins disable google-calendar
/codex plugins enable google-calendar

​

Funktionsweise der nativen Plugin-Einrichtung

• Während der Planung liest OpenClaw die plugin/read-Details des Quell-Codex und prüft, ob es sich beim Konto des Quell-Codex-app-server um ein ChatGPT-Abonnementkonto handelt. Bei einer Antwort mit einem Nicht-ChatGPT-Konto oder einem fehlenden Konto werden App-gestützte Plugins mit codex_subscription_required übersprungen.
• Standardmäßig überspringt die Migration den Quellaufruf app/list: App-gestützte Quell- Plugins, die die Kontoprüfung bestehen, werden ohne Überprüfung der App- Zugänglichkeit in der Quelle geplant, und Transportfehler bei der Kontoabfrage führen dazu, dass sie mit codex_account_unavailable übersprungen werden.
• Mit --verify-plugin-apps erstellt die Migration eine neue Quell-app/list- Momentaufnahme und verlangt, dass jede zugehörige App vorhanden, aktiviert und zugänglich ist, bevor die native Aktivierung geplant wird. Transportfehler bei der Kontoabfrage gehen dann in die Prüfung des App-Bestands der Quelle über, anstatt unmittelbar zum Überspringen zu führen.

​

V1-Unterstützungsgrenze

• Nur openai-curated-Plugins, die bereits im app-server-Bestand des Quell-Codex installiert sind, sind für die Migration geeignet.
• Die Runtime unterstützt außerdem explizite workspace-directory-Einträge auf app-server- Builds, deren plugin/list marketplaceKinds implementiert und remotePluginId für pfadlose Workspace-Zusammenfassungen zurückgibt. Diese Einträge müssen ihr exaktes Marketplace-qualifiziertes summary.id verwenden und bereits installiert, aktiviert sowie für Apps zugänglich sein. Eine abgelehnte Workspace-Listenanfrage erzeugt die vorhandene pluginspezifische Diagnose marketplace_missing; fehlende Marketplace-, Plugin-, Detail- oder App-Nachweise stellen keine Workspace-App bereit. Der kuratierte Bestand aus der standardmäßigen Listenanfrage bleibt nutzbar.
• App-gestützte Quell-Plugins müssen die Abonnementprüfung zum Migrationszeitpunkt bestehen. --verify-plugin-apps fügt die Prüfung des Quell-App-Bestands hinzu. Konten, die an der Abonnementprüfung scheitern, sowie im Überprüfungsmodus unzugängliche, deaktivierte oder fehlende Quell- Apps oder Fehler bei der Aktualisierung des App-Bestands werden als übersprungene manuelle Elemente statt als aktivierte Konfigurationseinträge gemeldet. Nicht lesbare Plugin-Details werden vor der Prüfung des App-Bestands übersprungen.
• Die Migration schreibt explizite Plugin-Identitäten (marketplaceName und pluginName); sie schreibt keine lokalen marketplacePath-Cache-Pfade.
• codexPlugins.enabled ist der einzige globale Aktivierungsschalter; es gibt weder einen plugins["*"]-Platzhalter noch einen Konfigurationsschlüssel, der beliebige Installations- berechtigungen gewährt.
• Nicht kuratierte Marketplaces, zwischengespeicherte Plugin-Bundles, Hooks und Codex-Konfigurations- dateien bleiben im Migrationsbericht zur manuellen Prüfung erhalten und werden nicht automatisch aktiviert. Die Runtime akzeptiert manuell konfigurierte workspace-directory- Einträge; andere Marketplaces werden weiterhin nicht unterstützt.

​

App-Bestand und Eigentümerschaft

• Die Überprüfung der Quellmigration verwendet das Quell-Codex-Home und die Start- optionen. Sie wird nur mit --verify-plugin-apps ausgeführt und erzwingt für diesen Planungslauf eine neue Traversierung des Quell-app/list.
• Die Einrichtung der Ziel-Runtime verwendet die Codex-app-server-Identität des Ziel-Agenten, wenn die Thread-App-Konfiguration erstellt wird. Die Aktivierung eines kuratierten Plugins invalidiert diesen Ziel-Cache-Schlüssel und erzwingt anschließend nach plugin/install dessen Aktualisierung. Bei der Einrichtung von workspace-directory wird dieser Aktivierungspfad nie ausgeführt.

​

Apps verbundener Konten

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          codexPlugins: {
            enabled: true,
            allow_all_plugins: true,
            allow_destructive_actions: "auto",
          },
        },
      },
    },
  },
}

​

App-Konfiguration für Threads

​

Richtlinie für destruktive Aktionen

• Der globale Wert allow_destructive_actions ist standardmäßig true.
• Der Plugin-spezifische Wert allow_destructive_actions überschreibt die globale Richtlinie für dieses Plugin.
• false: OpenClaw gibt eine deterministische Ablehnung zurück.
• true: OpenClaw akzeptiert nur sichere Schemas automatisch, die es einer Genehmigungsantwort zuordnen kann, beispielsweise einem booleschen Genehmigungsfeld.
• "auto": OpenClaw macht destruktive Plugin-Aktionen für Codex verfügbar und wandelt anschließend MCP-Genehmigungsabfragen mit nachgewiesener Eigentümerschaft in OpenClaw-Plugin- Genehmigungen um, bevor es die Codex-Genehmigungsantwort zurückgibt.
• "ask": OpenClaw verwendet dieselbe Codex-Sperrlogik für Schreibvorgänge und destruktive Aktionen wie "auto", löscht vor dem Start des Threads dauerhafte Codex-Genehmigungsüberschreibungen pro Tool für die App und bietet nur eine einmalige Genehmigung oder Ablehnung an, damit dauerhafte Genehmigungen spätere Aufforderungen für Schreibaktionen nicht unterdrücken können. Für jede zugelassene App, die "ask" verwendet, wählt OpenClaw den Prüfer für menschliche Genehmigungen von Codex für diese App aus, sodass Codex seine Genehmigungsabfragen an OpenClaw sendet; andere Apps und Thread-Genehmigungen, die sich nicht auf Apps beziehen, behalten ihren konfigurierten Prüfer und ihre Richtlinie.
• Eine fehlende Plugin-Identität, eine mehrdeutige Eigentümerschaft, eine fehlende oder nicht übereinstimmende Turn-ID oder ein unsicheres Abfrageschema führt zur Ablehnung, statt eine Aufforderung anzuzeigen.

​

Fehlerbehebung

​

Verwandte Themen

• Codex-Harness
• Codex-Harness-Referenz
• Codex-Harness-Laufzeit
• Konfigurationsreferenz
• Migrations-CLI