Harness di Codex

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.

​

Requisiti

• OpenClaw con il Plugin codex incluso disponibile.
• Se la tua configurazione usa plugins.allow, includi codex.
• Codex app-server 0.125.0 o più recente. Il Plugin incluso gestisce per impostazione predefinita un binario Codex app-server compatibile, quindi i comandi locali codex in PATH non influenzano il normale avvio dell’harness.
• Autenticazione Codex disponibile tramite openclaw models auth login --provider openai-codex, un account app-server nella home Codex dell’agente, oppure un profilo di autenticazione Codex esplicito con chiave API.

​

Avvio rapido

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

​

Configurazione

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

​

Verificare il runtime Codex

Runtime: OpenAI Codex

/codex status
/codex models

​

Instradamento e selezione modello

• Usa openai/gpt-* per i turni agente OpenAI tramite Codex.
• Non usare openai-codex/gpt-* nella configurazione. Esegui openclaw doctor --fix per riparare riferimenti legacy e pin di route di sessione obsoleti.
• agentRuntime.id: "codex" è opzionale per la normale modalità automatica OpenAI, ma utile quando una distribuzione deve fallire chiusa se Codex non è disponibile.
• agentRuntime.id: "pi" opta un provider o un modello nel comportamento PI diretto quando è intenzionale.
• /codex ... controlla conversazioni native Codex app-server dalla chat.
• ACP/acpx è un percorso di harness esterno separato. Usalo solo quando l’utente chiede ACP/acpx o un adattatore di harness esterno.

​

Pattern di distribuzione

​

Distribuzione Codex di base

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

​

Distribuzione provider mista

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

​

Distribuzione Codex fail-closed

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

​

Policy app-server

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

​

Comandi e diagnostica

• /codex status verifica connettività dell’app-server, modelli, account, limiti di frequenza, server MCP e skills.
• /codex models elenca i modelli live dell’app-server Codex.
• /codex threads [filter] elenca i thread recenti dell’app-server Codex.
• /codex resume <thread-id> collega la sessione OpenClaw corrente a un thread Codex esistente.
• /codex compact chiede all’app-server Codex di compattare il thread collegato.
• /codex review avvia la review nativa di Codex per il thread collegato.
• /codex diagnostics [note] chiede conferma prima di inviare feedback Codex per il thread collegato.
• /codex account mostra lo stato dell’account e dei limiti di frequenza.
• /codex mcp elenca lo stato dei server MCP dell’app-server Codex.
• /codex skills elenca le skills dell’app-server Codex.

​

Ispeziona localmente i thread Codex

codex resume <thread-id>

1. Profili di autenticazione OpenAI ordinati per l’agente, preferibilmente sotto auth.order.openai. Gli ID profilo openai-codex:* esistenti restano validi.
2. L’account esistente dell’app-server nella home Codex di quell’agente.
3. Solo per avvii app-server stdio locali, CODEX_API_KEY, poi OPENAI_API_KEY, quando non è presente alcun account app-server e l’autenticazione OpenAI è ancora richiesta.

{
  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

​

Plugin Codex nativi

{
  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

​

Confini di runtime

• Gli strumenti dinamici OpenClaw sono supportati. Codex chiede a OpenClaw di eseguire quegli strumenti, quindi OpenClaw resta nel percorso di esecuzione.
• Gli strumenti shell, patch, MCP e app nativi di Codex sono di proprietà di Codex. OpenClaw può osservare o bloccare eventi nativi selezionati tramite il relay supportato, ma non riscrive gli argomenti degli strumenti nativi.
• Codex possiede la Compaction nativa. OpenClaw mantiene uno specchio della trascrizione per la cronologia dei canali, la ricerca, /new, /reset e futuri cambi di modello o harness.
• Generazione multimediale, comprensione multimediale, TTS, approvazioni e output degli strumenti di messaggistica continuano tramite le impostazioni OpenClaw provider/modello corrispondenti.
• tool_result_persist si applica ai risultati degli strumenti nella trascrizione di proprietà di OpenClaw, non ai record dei risultati degli strumenti nativi Codex.

​

Risoluzione dei problemi

​

Correlati

• Riferimento dell’harness Codex
• Runtime dell’harness Codex
• Plugin Codex nativi
• Codex Computer Use
• Runtime degli agenti
• Provider di modelli
• Provider OpenAI
• Plugin di harness agente
• Hook dei Plugin
• Esportazione diagnostica
• Stato
• Testing