Riferimento dell'harness Codex

​

Superficie di configurazione del plugin

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

​

Supervisione

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

​

Trasporto dell’app-server

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

​

Modalità di approvazione e sandbox

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

​

Esecuzione nativa in sandbox

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

​

Isolamento dell’autenticazione e dell’ambiente

1. Un profilo di autenticazione Codex OpenClaw esplicito per l’agente.
2. L’account esistente dell’app-server nella home Codex di tale agente.
3. Solo per gli avvii locali dell’app-server tramite stdio, CODEX_API_KEY, quindi OPENAI_API_KEY, quando non è presente alcun account dell’app-server ed è ancora richiesta l’autenticazione OpenAI.

openclaw migrate codex --dry-run
openclaw migrate apply codex --yes

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

​

Strumenti dinamici

• read
• write
• edit
• apply_patch
• exec
• process
• update_plan
• tool_call
• tool_describe
• tool_search
• tool_search_code

​

Timeout

• Un argomento timeoutMs positivo per singola chiamata.
• Per image_generate, agents.defaults.imageGenerationModel.timeoutMs.
• Per image_generate senza un timeout configurato, il valore predefinito di 120 secondi per la generazione di immagini.
• Per lo strumento di comprensione multimediale image, tools.media.image.timeoutSeconds convertito in millisecondi oppure il valore predefinito multimediale di 60 secondi. Per la comprensione delle immagini, questo valore si applica alla richiesta stessa e non viene ridotto dal lavoro di preparazione precedente.
• Per lo strumento message, un valore predefinito fisso di 120 secondi.
• Il valore predefinito di 90 secondi per gli strumenti dinamici.

​

Rilevamento dei modelli

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

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

​

File di bootstrap dell’area di lavoro

• TOOLS.md viene inoltrato come istruzioni per gli sviluppatori Codex ereditate, pertanto anche i subagenti Codex nativi generati durante il turno lo ricevono.
• SOUL.md, IDENTITY.md e USER.md vengono inoltrati come istruzioni di collaborazione circoscritte al turno. I subagenti Codex nativi non le ereditano, evitando così che i turni dei subagenti acquisiscano la persona e il profilo utente dell’agente padre.
• Anche l’elenco compatto delle Skills OpenClaw caricate viene inoltrato come istruzioni per gli sviluppatori relative alla collaborazione e circoscritte al turno, pertanto nemmeno i subagenti Codex nativi lo ereditano.
• Il contenuto di HEARTBEAT.md non viene inserito; i turni Heartbeat ricevono un riferimento in modalità collaborazione per leggere il file quando esiste e non è vuoto.
• Il contenuto di MEMORY.md proveniente dall’area di lavoro configurata dell’agente non viene incollato nell’input del turno Codex nativo quando gli strumenti di memoria sono disponibili per tale area di lavoro; quando esiste, l’harness aggiunge un breve riferimento alla memoria dell’area di lavoro nelle istruzioni per gli sviluppatori relative alla collaborazione e circoscritte al turno, e Codex dovrebbe usare memory_search o memory_get quando la memoria persistente è pertinente. Se gli strumenti sono disabilitati, la ricerca nella memoria non è disponibile oppure l’area di lavoro attiva è diversa da quella della memoria dell’agente, MEMORY.md usa invece il normale percorso limitato del contesto del turno.
• BOOTSTRAP.md, quando presente, viene inoltrato come contesto di riferimento dell’input del turno OpenClaw.

​

Sostituzioni tramite variabili d’ambiente

• 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

​

Argomenti correlati

• Harness Codex
• Runtime dell’harness Codex
• Supervisione Codex
• Plugin Codex nativi
• Uso del computer con Codex
• Provider OpenAI
• Riferimento della configurazione