Codex-harnas

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.

​

Vereisten

• OpenClaw met de meegeleverde codex Plugin beschikbaar.
• Als je configuratie plugins.allow gebruikt, neem dan codex op.
• Codex-app-server 0.125.0 of nieuwer. De meegeleverde Plugin beheert standaard een compatibel binair bestand voor de Codex-app-server, dus lokale codex-opdrachten op PATH hebben geen invloed op het normale starten van de harness.
• Codex-authenticatie beschikbaar via openclaw models auth login --provider openai-codex, een app-serveraccount in de Codex-home van de agent, of een expliciet authenticatieprofiel met Codex API-sleutel.

​

Snelstart

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

​

Configuratie

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

​

Codex-uitvoeringsomgeving verifiëren

Runtime: OpenAI Codex

/codex status
/codex models

​

Routering en modelselectie

• Gebruik openai/gpt-* voor OpenAI-agentbeurten via Codex.
• Gebruik openai-codex/gpt-* niet in configuratie. Voer openclaw doctor --fix uit om verouderde verwijzingen en vastgezette oude sessieroutes te herstellen.
• agentRuntime.id: "codex" is optioneel voor de normale automatische OpenAI-modus, maar nuttig wanneer een uitrol gesloten moet falen als Codex niet beschikbaar is.
• agentRuntime.id: "pi" kiest een provider of model voor rechtstreeks PI-gedrag wanneer dat de bedoeling is.
• /codex ... stuurt native Codex-app-servergesprekken vanuit chat aan.
• ACP/acpx is een apart extern harness-pad. Gebruik het alleen wanneer de gebruiker om ACP/acpx of een externe harnessadapter vraagt.

​

Uitrolpatronen

​

Basisuitrol van Codex

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

​

Uitrol met gemengde providers

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

​

Codex-uitrol met gesloten falen

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

​

App-serverbeleid

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

​

Opdrachten en diagnostiek

• /codex status controleert app-server-connectiviteit, modellen, account, snelheidslimieten, MCP-servers en Skills.
• /codex models vermeldt live Codex app-server-modellen.
• /codex threads [filter] vermeldt recente Codex app-server-threads.
• /codex resume <thread-id> koppelt de huidige OpenClaw-sessie aan een bestaande Codex-thread.
• /codex compact vraagt de Codex app-server om de gekoppelde thread te compacteren.
• /codex review start native Codex-beoordeling voor de gekoppelde thread.
• /codex diagnostics [note] vraagt om bevestiging voordat Codex-feedback voor de gekoppelde thread wordt verzonden.
• /codex account toont account- en snelheidslimietstatus.
• /codex mcp vermeldt de status van Codex app-server-MCP-servers.
• /codex skills vermeldt Codex app-server-Skills.

​

Codex-threads lokaal inspecteren

codex resume <thread-id>

1. Geordende OpenAI-authenticatieprofielen voor de agent, bij voorkeur onder auth.order.openai. Bestaande openai-codex:*-profiel-id’s blijven geldig.
2. Het bestaande account van de app-server in de Codex-home van die agent.
3. Alleen voor lokale stdio app-server-starts: CODEX_API_KEY, daarna OPENAI_API_KEY, wanneer er geen app-server-account aanwezig is en OpenAI-authenticatie nog steeds vereist is.

{
  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

​

Runtimegrenzen

• Dynamische OpenClaw-tools worden ondersteund. Codex vraagt OpenClaw om die tools uit te voeren, waardoor OpenClaw in het uitvoeringspad blijft.
• Codex-native shell-, patch-, MCP- en native app-tools zijn eigendom van Codex. OpenClaw kan geselecteerde native events observeren of blokkeren via de ondersteunde relay, maar herschrijft native toolargumenten niet.
• Codex is eigenaar van native compaction. OpenClaw houdt een transcriptspiegel bij voor kanaalgeschiedenis, zoeken, /new, /reset en toekomstig wisselen van model of harness.
• Mediageneratie, mediabegrip, TTS, goedkeuringen en messaging-tool-uitvoer blijven via de bijpassende OpenClaw-provider-/modelinstellingen lopen.
• tool_result_persist geldt voor transcripttoolresultaten die eigendom zijn van OpenClaw, niet voor Codex-native toolresultaatrecords.

​

Problemen oplossen

​

Gerelateerd

• Codex-harnessreferentie
• Codex-harnessruntime
• Native Codex-plugins
• Codex Computer Use
• Agentruntimes
• Modelproviders
• OpenAI-provider
• Agent-harnessplugins
• Plugin-hooks
• Diagnostiekexport
• Status
• Testen