Référence du harnais Codex

​

Surface de configuration du plugin

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

​

Supervision

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

​

Transport de l’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",
            },
          },
        },
      },
    },
  },
};

​

Modes d’approbation et de bac à sable

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

​

Exécution native dans un bac à sable

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

​

Isolation de l’authentification et de l’environnement

1. Un profil d’authentification Codex OpenClaw explicite pour l’agent.
2. Le compte existant de l’app-server dans le répertoire personnel Codex de cet agent.
3. Uniquement pour les lancements locaux de l’app-server stdio, CODEX_API_KEY, puis OPENAI_API_KEY, lorsqu’aucun compte app-server n’est présent et que l’authentification OpenAI reste requise.

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

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

​

Outils dynamiques

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

​

Délais d’expiration

• Un argument positif timeoutMs propre à l’appel.
• Pour image_generate, agents.defaults.imageGenerationModel.timeoutMs.
• Pour image_generate sans délai d’expiration configuré, la valeur par défaut de 120 secondes pour la génération d’images.
• Pour l’outil de compréhension des médias image, tools.media.image.timeoutSeconds converti en millisecondes, ou la valeur par défaut de 60 secondes pour les médias. Pour la compréhension des images, cela s’applique à la requête elle-même et n’est pas réduit par les travaux de préparation antérieurs.
• Pour l’outil message, une valeur par défaut fixe de 120 secondes.
• La valeur par défaut de 90 secondes pour les outils dynamiques.

​

Découverte des modèles

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

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

​

Fichiers d’amorçage de l’espace de travail

• TOOLS.md est transmis en tant qu’instructions de développement Codex héritées, afin que les sous-agents Codex natifs créés pendant le tour les reçoivent également.
• SOUL.md, IDENTITY.md et USER.md sont transmis en tant qu’instructions de collaboration limitées au tour. Les sous-agents Codex natifs ne les héritent pas, ce qui évite que les tours des sous-agents reprennent la personnalité et le profil utilisateur de l’agent parent.
• La liste compacte des Skills OpenClaw chargés est également transmise sous forme d’instructions de développement de collaboration limitées au tour, afin que les sous-agents Codex natifs ne l’héritent pas non plus.
• Le contenu de HEARTBEAT.md n’est pas injecté ; les tours Heartbeat reçoivent un pointeur en mode collaboration leur demandant de lire le fichier lorsqu’il existe et n’est pas vide.
• Le contenu de MEMORY.md provenant de l’espace de travail configuré de l’agent n’est pas inséré dans l’entrée native du tour Codex lorsque des outils de mémoire sont disponibles pour cet espace de travail ; lorsqu’il existe, le dispositif ajoute un petit pointeur vers la mémoire de l’espace de travail aux instructions de développement de collaboration limitées au tour, et Codex doit utiliser memory_search ou memory_get lorsque la mémoire persistante est pertinente. Si les outils sont désactivés, si la recherche dans la mémoire est indisponible ou si l’espace de travail actif diffère de l’espace de travail de mémoire de l’agent, MEMORY.md utilise plutôt le chemin normal de contexte limité au tour.
• BOOTSTRAP.md, lorsqu’il est présent, est transmis en tant que contexte de référence d’entrée du tour OpenClaw.

​

Remplacements par variables d’environnement

• 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

​

Rubriques connexes

• Dispositif Codex
• Environnement d’exécution du dispositif Codex
• Supervision de Codex
• Plugins Codex natifs
• Utilisation de l’ordinateur avec Codex
• Fournisseur OpenAI
• Référence de configuration