Codex-harnas

Documentation Index

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

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

​

Wat deze plugin wijzigt

• Codex gaan gebruiken voor elk OpenAI-model
• openai-codex/*-modelreferenties omzetten naar de native runtime
• ACP/acpx het standaard Codex-pad maken
• bestaande sessies hot-switchen die al een PI-runtime hebben vastgelegd
• OpenClaw-kanaalaflevering, sessiebestanden, opslag van auth-profielen of berichtroutering vervangen

• before_prompt_build
• before_compaction, after_compaction
• llm_input, llm_output
• before_tool_call, after_tool_call
• before_message_write voor gespiegelde transcriptrecords
• before_agent_finalize via Codex Stop-relay
• agent_end

​

Routekaart

• openai-codex/* beantwoordt “welke provider-/auth-route moet PI gebruiken?”
• agentRuntime.id: "codex" beantwoordt “welke loop moet deze ingebedde beurt uitvoeren?”
• /codex ... beantwoordt “welke native Codex-conversatie moet deze chat koppelen of besturen?”
• ACP beantwoordt “welk extern harnessproces moet acpx starten?”

​

Kies de juiste modelprefix

​

Wat doctor-waarschuwingen betekenen

• de gebundelde codex-plugin is ingeschakeld of toegestaan
• het primaire model van een agent is openai-codex/*
• de effectieve runtime van die agent is niet codex

• Er is geen wijziging vereist als je ChatGPT/Codex OAuth via PI bedoelde.
• Wijzig het model naar openai/<model> en stel agentRuntime.id: "codex" in als je native app-serveruitvoering bedoelde.
• Bestaande sessies hebben na een runtimewijziging nog steeds /new of /reset nodig, omdat sessieruntimepins sticky zijn.

​

Vereisten

• OpenClaw met de gebundelde codex-plugin beschikbaar.
• Codex app-server 0.125.0 of nieuwer. De gebundelde plugin beheert standaard een compatibele Codex app-server-binary, dus lokale codex-opdrachten op PATH hebben geen invloed op normale harnessstart.
• Codex-authenticatie beschikbaar voor het app-serverproces of voor OpenClaw’s Codex-authenticatiebridge.

​

Minimale configuratie

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

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

​

Codex naast andere modellen toevoegen

• Plaats Codex op een speciale agent met agentRuntime.id: "codex".
• Houd de standaardagent op agentRuntime.id: "auto" en Pi-fallback voor normaal gemengd providergebruik.
• Gebruik verouderde codex/*-refs alleen voor compatibiliteit. Nieuwe configuraties moeten de voorkeur geven aan openai/* plus een expliciet Codex-runtimebeleid.

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      agentRuntime: {
        id: "auto",
        fallback: "pi",
      },
    },
    list: [
      {
        id: "main",
        default: true,
        model: "anthropic/claude-opus-4-6",
      },
      {
        id: "codex",
        name: "Codex",
        model: "openai/gpt-5.5",
        agentRuntime: {
          id: "codex",
        },
      },
    ],
  },
}

• De standaardagent main gebruikt het normale providerpad en Pi-compatibiliteitsfallback.
• De agent codex gebruikt de Codex-app-server-harness.
• Als Codex ontbreekt of niet wordt ondersteund voor de agent codex, mislukt de beurt in plaats van stilletjes Pi te gebruiken.

​

Routering van agentopdrachten

​

Alleen-Codex-deployments

{
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
      agentRuntime: {
        id: "codex",
        fallback: "none",
      },
    },
  },
}

OPENCLAW_AGENT_RUNTIME=codex openclaw gateway run

​

Codex per agent

{
  agents: {
    defaults: {
      agentRuntime: {
        id: "auto",
        fallback: "pi",
      },
    },
    list: [
      {
        id: "main",
        default: true,
        model: "anthropic/claude-opus-4-6",
      },
      {
        id: "codex",
        name: "Codex",
        model: "openai/gpt-5.5",
        agentRuntime: {
          id: "codex",
          fallback: "none",
        },
      },
    ],
  },
}

​

Modeldetectie

• GPT-5.5
• GPT-5.4 mini
• GPT-5.2

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

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

​

App-serververbinding en -beleid

codex app-server --listen stdio://

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

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

1. Een expliciet OpenClaw Codex-authprofiel voor de agent.
2. Het bestaande account van de app-server, zoals een lokale Codex-CLI ChatGPT-aanmelding.
3. Alleen voor lokale stdio-app-serverstarts: CODEX_API_KEY, daarna OPENAI_API_KEY, wanneer er geen app-serveraccount aanwezig is en OpenAI-auth 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

​

Computergebruik

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          computerUse: {
            autoInstall: true,
          },
        },
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
      agentRuntime: {
        id: "codex",
        fallback: "none",
      },
    },
  },
}

• /codex computer-use status
• /codex computer-use install
• /codex computer-use install --source <marketplace-source>
• /codex computer-use install --marketplace-path <path>

​

Veelgebruikte recepten

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
}

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

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            mode: "guardian",
            approvalPolicy: "on-request",
            approvalsReviewer: "auto_review",
            sandbox: "workspace-write",
          },
        },
      },
    },
  },
}

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            transport: "websocket",
            url: "ws://gateway-host:39175",
            headers: {
              "X-OpenClaw-Agent": "main",
            },
          },
        },
      },
    },
  },
}

​

Codex-opdracht

• /codex status toont live app-server-connectiviteit, modellen, account, ratelimits, MCP-servers en skills.
• /codex models toont live Codex-app-servermodellen.
• /codex threads [filter] toont recente Codex-threads.
• /codex resume <thread-id> koppelt de huidige OpenClaw-sessie aan een bestaande Codex-thread.
• /codex compact vraagt Codex app-server om de gekoppelde thread te comprimeren.
• /codex review start een native Codex-review voor de gekoppelde thread.
• /codex diagnostics [note] vraagt toestemming voordat Codex-diagnostische feedback voor de gekoppelde thread wordt verzonden.
• /codex computer-use status controleert de geconfigureerde Computergebruik-Plugin en MCP-server.
• /codex computer-use install installeert de geconfigureerde Computergebruik-Plugin en herlaadt MCP-servers.
• /codex account toont account- en ratelimitstatus.
• /codex mcp toont de MCP-serverstatus van Codex app-server.
• /codex skills toont Codex app-server-Skills.

​

Veelgebruikte debugworkflow

1. Voer /diagnostics bad tool choice after image upload uit of een andere korte notitie die beschrijft wat je zag.
2. Keur het diagnostiekverzoek eenmalig goed. De goedkeuring maakt de lokale Gateway-diagnostiekzip en stuurt, omdat de sessie de Codex-harness gebruikt, ook de relevante Codex-feedbackbundel naar OpenAI-servers.
3. Kopieer het voltooide diagnostiekantwoord naar het bugrapport of de supportthread. Het bevat het lokale bundelpad, de privacysamenvatting, OpenClaw-sessie-id’s, Codex-thread-id’s en een regel Inspect locally voor elke Codex-thread.
4. Als je de run zelf wilt debuggen, voer je de afgedrukte Inspect locally- opdracht uit in een terminal. Deze ziet eruit als codex resume <thread-id> en opent de native Codex-thread zodat je het gesprek kunt inspecteren, lokaal kunt voortzetten of Codex kunt vragen waarom het een bepaalde tool of bepaald plan koos.

​

Een Codex-thread vanuit de CLI inspecteren

codex resume <thread-id>

​

Hook-grenzen

​

V1-ondersteuningscontract

​

Tools, media en Compaction

​

Problemen oplossen

​

Gerelateerd

• Agent-harnas-plugins
• Agentruntimes
• Modelproviders
• OpenAI-provider
• Status
• Plugin-hooks
• Configuratiereferentie
• Testen