Codex-harnasreferentie

​

Configuratieoppervlak van de plugin

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

​

Supervisie

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

​

App-servertransport

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

​

Goedkeurings- en sandboxmodi

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

​

Gesandboxte native uitvoering

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

​

Authenticatie en omgevingsisolatie

1. Een expliciet OpenClaw Codex-authenticatieprofiel voor de agent.
2. Het bestaande account van de app-server in de Codex-home van die agent.
3. Alleen voor lokale stdio-starts van de app-server: CODEX_API_KEY, en daarna OPENAI_API_KEY, wanneer er geen app-serveraccount aanwezig is en OpenAI-authenticatie nog steeds vereist is.

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

​

Time-outs

• Een positief argument timeoutMs per aanroep.
• Voor image_generate: agents.defaults.mediaModels.image.timeoutMs.
• Voor image_generate zonder geconfigureerde time-out: de standaardwaarde van 120 seconden voor het genereren van afbeeldingen.
• Voor de tool image voor mediabegrip: de naar milliseconden geconverteerde timeoutSeconds van de geselecteerde afbeeldingsgeschikte vermelding tools.media.models[], of de mediastandaard van 60 seconden. Voor afbeeldingsbegrip geldt dit voor het verzoek zelf en wordt dit niet verkort door eerder voorbereidend werk.
• Voor de tool message: een vast extern budget van 600 seconden dat Gateway-bezorging en begrensde reconciliatie met dezelfde sleutel omvat.
• De standaardwaarde van 90 seconden voor dynamische tools.

​

Modeldetectie

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

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

​

Bootstrapbestanden voor de werkruimte

• TOOLS.md wordt doorgestuurd als overgenomen Codex-ontwikkelaarsinstructies, zodat systeemeigen Codex-subagents die tijdens de beurt worden gestart deze ook zien.
• SOUL.md, IDENTITY.md en USER.md worden doorgestuurd als beurtgebonden samenwerkingsinstructies. Systeemeigen Codex-subagents nemen deze niet over, zodat subagentbeurten niet de persona en het gebruikersprofiel van de bovenliggende agent overnemen.
• De compacte lijst met geladen OpenClaw-Skills wordt ook doorgestuurd als beurtgebonden ontwikkelaarsinstructies voor samenwerking, zodat systeemeigen Codex-subagents deze evenmin overnemen.
• De inhoud van HEARTBEAT.md wordt niet geïnjecteerd; Heartbeat-beurten krijgen een verwijzing in samenwerkingsmodus om het bestand te lezen wanneer het bestaat en niet leeg is.
• De inhoud van MEMORY.md uit de geconfigureerde agentwerkruimte wordt niet in de invoer van de systeemeigen Codex-beurt geplakt wanneer geheugentools beschikbaar zijn voor die werkruimte; wanneer het bestand bestaat, voegt het harnas een kleine verwijzing naar het werkruimtegeheugen toe aan de beurtgebonden ontwikkelaarsinstructies voor samenwerking en moet Codex memory_search of memory_get gebruiken wanneer duurzaam geheugen relevant is. Als tools zijn uitgeschakeld, zoeken in het geheugen niet beschikbaar is of de actieve werkruimte afwijkt van de agentgeheugenwerkruimte, gebruikt MEMORY.md in plaats daarvan het normale begrensde pad voor beurtcontext.
• BOOTSTRAP.md wordt, wanneer aanwezig, doorgestuurd als referentiecontext voor OpenClaw-beurtinvoer.

​

Omgevingsoverschrijvingen

• 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

​

Gerelateerd

• Codex-harnas
• Codex-harnasruntime
• Codex-supervisie
• Systeemeigen Codex-plugins
• Codex-computergebruik
• OpenAI-provider
• Configuratiereferentie