Harnais Codex

​

Prérequis

• 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, donc les commandes codex locales sur PATH n’affectent pas le démarrage normal du harnais.
• Authentification Codex disponible via openclaw models auth login --provider openai, un compte app-server dans le dossier personnel Codex de l’agent, ou un profil d’authentification Codex explicite par clé API.

​

Démarrage rapide

openclaw models auth login --provider openai

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

{
  plugins: {
    allow: ["codex"],
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
}

​

Partager des fils avec Codex Desktop et la CLI

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            homeScope: "user",
          },
        },
      },
    },
  },
}

​

Configuration

{
  auth: {
    order: {
      openai: ["openai: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 de références GPT Codex héritées dans la configuration. Exécutez openclaw doctor --fix pour réparer les références héritées et les anciens verrouillages de route de session.
• agentRuntime.id: "codex" est facultatif pour le mode automatique OpenAI normal, mais utile lorsqu’un déploiement doit échouer de manière fermée si Codex est indisponible.
• agentRuntime.id: "openclaw" inscrit explicitement un fournisseur ou un modèle dans le runtime intégré OpenClaw lorsque c’est intentionnel.
• /codex ... contrôle les conversations natives Codex app-server depuis la discussion.
• ACP/acpx est un chemin de harnais externe séparé. 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 avec 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 en échec fermé

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

​

Politique d’app-server

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          appServer: {
            transport: "websocket",
            url: "ws://gateway-host:39175",
            authToken: "${CODEX_APP_SERVER_TOKEN}",
          },
        },
      },
    },
  },
}

{
  tools: {
    exec: {
      mode: "auto",
    },
  },
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
}

​

Commandes et diagnostics

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

​

Inspecter les fils Codex localement

codex resume <thread-id>

1. Profils d’authentification OpenAI ordonnés pour l’agent, de préférence sous auth.order.openai. Exécutez openclaw doctor --fix pour migrer les anciens ids de profil d’authentification Codex hérités et l’ancien ordre d’authentification Codex.
2. Le compte existant de l’app-server dans le répertoire personnel Codex de cet agent.
3. Pour les lancements d’app-server stdio locaux uniquement, CODEX_API_KEY, puis OPENAI_API_KEY, lorsqu’aucun compte app-server 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"],
          },
        },
      },
    },
  },
}

export default {
  plugins: {
    entries: {
      codex: {
        config: {
          appServer: {
            sandbox: "workspace-write",
            networkProxy: {
              enabled: true,
              domains: {
                "api.openai.com": "allow",
                "blocked.example.com": "deny",
              },
              unixSockets: {
                "/tmp/proxy.sock": "allow",
                "/tmp/blocked.sock": "none",
              },
              allowUpstreamProxy: true,
              proxyUrl: "http://127.0.0.1:3128",
            },
          },
        },
      },
    },
  },
};

• 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

​

Frontières 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 shell, patch, MCP et applications natives propres à Codex appartiennent à 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 possède la compaction native. OpenClaw conserve un miroir de transcript pour l’historique du canal, la recherche, /new, /reset et les futurs changements de modèle ou de harnais, mais il ne remplace pas la compaction Codex par un résumé OpenClaw ou de moteur de contexte.
• La génération multimédia, la compréhension multimédia, le TTS, les approbations et la sortie d’outils de messagerie continuent de passer par les paramètres fournisseur/modèle OpenClaw correspondants.
• tool_result_persist s’applique aux résultats d’outils de transcript appartenant à OpenClaw, pas aux enregistrements de résultats d’outils natifs Codex.

​

Dépannage

(
  pattern='openai/gpt-5\.[45]|openai[-]codex|agentRuntime(\.id)?|harnessRuntime|Runtime: OpenAI Codex|legacy OpenAI Codex prefix|resolveSelectedOpenAIRuntimeProvider|candidateProvider[": ]+openai|status[": ]+401|Incorrect API key|No API key|api-key path|API-key path|OAuth'

  if ls /tmp/openclaw/openclaw-*.log >/dev/null 2>&1; then
    grep -E -i -n "$pattern" /tmp/openclaw/openclaw-*.log 2>/dev/null || true
  else
    journalctl --user -u openclaw-gateway --since today --no-pager 2>/dev/null \
      | grep -E -i "$pattern" || true
  fi
) | sed -E \
    -e 's/(Authorization: Bearer )[A-Za-z0-9._~+\/-]+/\1[REDACTED]/Ig' \
    -e 's/(Bearer )[A-Za-z0-9._~+\/-]+/\1[REDACTED]/Ig' \
    -e 's/(api[_ -]?key[=: ]+)[^ ,}"]+/\1[REDACTED]/Ig' \
    -e 's/(OPENAI_API_KEY[=: ]+)[^ ,}"]+/\1[REDACTED]/Ig' \
    -e 's/sk-[A-Za-z0-9_-]{12,}/sk-[REDACTED]/g' \
    -e 's/[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/[EMAIL-REDACTED]/g' \
  | tail -200

​

Connexe

• Référence du harnais Codex
• Runtime du harnais Codex
• Plugins Codex natifs
• Codex Computer Use
• Runtimes d’agent
• Fournisseurs de modèles
• Fournisseur OpenAI
• Aide OpenAI Codex
• Plugins de harnais d’agent
• Hooks de Plugin
• Export des diagnostics
• État
• Tests