Codex-Harness

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Anforderungen

• OpenClaw mit verfügbarem gebündeltem codex-Plugin.
• Wenn Ihre Konfiguration plugins.allow verwendet, schließen Sie codex ein.
• Codex-App-Server 0.125.0 oder neuer. Das gebündelte Plugin verwaltet standardmäßig eine kompatible Codex-App-Server-Binärdatei, daher wirken sich lokale codex-Befehle in PATH nicht auf den normalen Harness-Start aus.
• Codex-Authentifizierung verfügbar über openclaw models auth login --provider openai-codex, ein App-Server-Konto im Codex-Home des Agenten oder ein explizites Codex-API-Schlüssel-Auth-Profil.

​

Schnellstart

openclaw models auth login --provider openai-codex

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

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

​

Konfiguration

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

​

Codex-Laufzeitumgebung verifizieren

Runtime: OpenAI Codex

/codex status
/codex models

​

Routing und Modellauswahl

• Verwenden Sie openai/gpt-* für OpenAI-Agent-Durchläufe über Codex.
• Verwenden Sie openai-codex/gpt-* nicht in der Konfiguration. Führen Sie openclaw doctor --fix aus, um Legacy-Referenzen und veraltete Sitzungsrouten-Pins zu reparieren.
• agentRuntime.id: "codex" ist für den normalen OpenAI-Automodus optional, aber nützlich, wenn eine Bereitstellung geschlossen fehlschlagen soll, falls Codex nicht verfügbar ist.
• agentRuntime.id: "pi" schaltet einen Provider oder ein Modell auf direktes PI-Verhalten um, wenn dies beabsichtigt ist.
• /codex ... steuert native Codex-App-Server-Unterhaltungen aus dem Chat.
• ACP/acpx ist ein separater externer Harness-Pfad. Verwenden Sie ihn nur, wenn der Benutzer ACP/acpx oder einen externen Harness-Adapter anfordert.

​

Bereitstellungsmuster

​

Einfache Codex-Bereitstellung

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

​

Gemischte Provider-Bereitstellung

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

​

Fail-closed-Codex-Bereitstellung

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

​

App-Server-Richtlinie

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

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

​

Befehle und Diagnose

• /codex status prüft App-Server-Konnektivität, Modelle, Konto, Ratenlimits, MCP-Server und Skills.
• /codex models listet Live-Modelle des Codex-App-Servers auf.
• /codex threads [filter] listet aktuelle Threads des Codex-App-Servers auf.
• /codex resume <thread-id> hängt die aktuelle OpenClaw-Sitzung an einen vorhandenen Codex-Thread an.
• /codex compact fordert den Codex-App-Server auf, den angehängten Thread zu verdichten.
• /codex review startet eine native Codex-Review für den angehängten Thread.
• /codex diagnostics [note] fragt nach, bevor Codex-Feedback für den angehängten Thread gesendet wird.
• /codex account zeigt Konto- und Ratenlimitstatus an.
• /codex mcp listet den Status der MCP-Server des Codex-App-Servers auf.
• /codex skills listet Skills des Codex-App-Servers auf.

​

Codex-Threads lokal untersuchen

codex resume <thread-id>

1. Geordnete OpenAI-Auth-Profile für den Agenten, vorzugsweise unter auth.order.openai. Vorhandene openai-codex:*-Profil-IDs bleiben gültig.
2. Das vorhandene Konto des App-Servers im Codex-Home dieses Agenten.
3. Nur für lokale stdio-App-Server-Starts: CODEX_API_KEY, dann OPENAI_API_KEY, wenn kein App-Server-Konto vorhanden ist und OpenAI-Auth weiterhin erforderlich ist.

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

• 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

​

Native Codex-Plugins

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

​

Computer Use

​

Laufzeitgrenzen

• OpenClaw Dynamic Tools werden unterstützt. Codex bittet OpenClaw, diese Tools auszuführen, sodass OpenClaw im Ausführungspfad bleibt.
• Codex-native Shell-, Patch-, MCP- und native App-Tools gehören Codex. OpenClaw kann ausgewählte native Ereignisse über den unterstützten Relay beobachten oder blockieren, schreibt native Tool-Argumente aber nicht um.
• Codex besitzt native Compaction. OpenClaw behält eine Transkriptspiegelung für Kanal- Verlauf, Suche, /new, /reset und zukünftige Modell- oder Harness-Wechsel.
• Mediengenerierung, Medienverständnis, TTS, Genehmigungen und Messaging-Tool- Ausgabe laufen weiterhin über die passenden OpenClaw-Provider-/Modelleinstellungen.
• tool_result_persist gilt für OpenClaw-eigene Transkript-Tool-Ergebnisse, nicht für Codex-native Tool-Ergebnisdatensätze.

​

Problembehebung

​

Verwandte Themen

• Codex-Harness-Referenz
• Codex-Harness-Laufzeit
• Native Codex-Plugins
• Codex Computer Use
• Agent-Laufzeiten
• Modell-Provider
• OpenAI-Provider
• Agent-Harness-Plugins
• Plugin-Hooks
• Diagnoseexport
• Status
• Testen