Harnais 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.

​

Exigences

• OpenClaw avec le Plugin codex inclus disponible.
• Si votre configuration utilise plugins.allow, incluez codex.
• Codex app-server 0.125.0 ou plus récent. Le Plugin inclus gère par défaut un binaire Codex app-server compatible ; les commandes codex locales dans PATH n’affectent donc pas le démarrage normal du harnais.
• Authentification Codex disponible via openclaw models auth login --provider openai-codex, un compte app-server dans le répertoire Codex home de l’agent, ou un profil d’authentification explicite avec clé d’API Codex.

​

Démarrage rapide

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

​

Configuration

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

​

Vérifier le runtime Codex

Runtime: OpenAI Codex

/codex status
/codex models

​

Routage et sélection de modèle

• Utilisez openai/gpt-* pour les tours d’agent OpenAI via Codex.
• N’utilisez pas openai-codex/gpt-* dans la configuration. Exécutez openclaw doctor --fix pour réparer les références héritées et les anciennes épingles de route de session.
• agentRuntime.id: "codex" est facultatif pour le mode automatique OpenAI normal, mais utile lorsqu’un déploiement doit échouer de façon fermée si Codex est indisponible.
• agentRuntime.id: "pi" fait opter un fournisseur ou un modèle pour le comportement PI direct lorsque cela est intentionnel.
• /codex ... contrôle les conversations Codex app-server natives depuis le chat.
• ACP/acpx est un chemin de harnais externe distinct. Utilisez-le uniquement lorsque l’utilisateur demande ACP/acpx ou un adaptateur de harnais externe.

​

Modèles de déploiement

​

Déploiement Codex de base

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

​

Déploiement à fournisseurs mixtes

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

​

Déploiement Codex à échec fermé

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

​

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

​

Commandes et diagnostics

• /codex status vérifie la connectivité du serveur d’application, les modèles, le compte, les limites de débit, les serveurs MCP et les Skills.
• /codex models liste les modèles actifs du serveur d’application Codex.
• /codex threads [filter] liste les threads récents du serveur d’application Codex.
• /codex resume <thread-id> attache la session OpenClaw actuelle à un thread Codex existant.
• /codex compact demande au serveur d’application Codex de compacter le thread attaché.
• /codex review démarre la revue native de Codex pour le thread attaché.
• /codex diagnostics [note] demande confirmation avant d’envoyer les retours Codex pour le thread attaché.
• /codex account affiche le statut du compte et des limites de débit.
• /codex mcp liste l’état des serveurs MCP du serveur d’application Codex.
• /codex skills liste les Skills du serveur d’application Codex.

​

Inspecter les threads Codex localement

codex resume <thread-id>

1. Les profils d’authentification OpenAI ordonnés pour l’agent, de préférence sous auth.order.openai. Les identifiants de profil openai-codex:* existants restent valides.
2. Le compte existant du serveur d’application dans le répertoire Codex de cet agent.
3. Pour les lancements locaux du serveur d’application stdio uniquement, CODEX_API_KEY, puis OPENAI_API_KEY, lorsqu’aucun compte de serveur d’application n’est présent et que l’authentification OpenAI est toujours requise.

{
  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

​

Plugins Codex natifs

{
  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

​

Limites d’exécution

• Les outils dynamiques OpenClaw sont pris en charge. Codex demande à OpenClaw d’exécuter ces outils, OpenClaw reste donc dans le chemin d’exécution.
• Les outils natifs shell, patch, MCP et application de Codex sont détenus par Codex. OpenClaw peut observer ou bloquer certains événements natifs via le relais pris en charge, mais il ne réécrit pas les arguments des outils natifs.
• Codex détient la Compaction native. OpenClaw conserve un miroir de transcription pour l’historique du canal, la recherche, /new, /reset et le futur changement de modèle ou de harnais.
• La génération de médias, la compréhension des médias, la synthèse vocale, les approbations et la sortie de l’outil de messagerie continuent à passer par les paramètres de fournisseur/modèle OpenClaw correspondants.
• tool_result_persist s’applique aux résultats d’outils de transcription détenus par OpenClaw, et non aux enregistrements de résultats d’outils natifs Codex.

​

Dépannage

​

Connexe

• Référence du harnais Codex
• Exécution du harnais Codex
• Plugins Codex natifs
• Codex Computer Use
• Exécutions d’agents
• Fournisseurs de modèles
• Fournisseur OpenAI
• Plugins de harnais d’agent
• Hooks de Plugin
• Export des diagnostics
• Statut
• Tests