Codex bağlayıcısı

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.

​

Gereksinimler

• Paketle gelen codex Plugin’i kullanılabilir olan OpenClaw.
• Yapılandırmanız plugins.allow kullanıyorsa codex ekleyin.
• Codex app-server 0.125.0 veya daha yeni. Paketle gelen Plugin, varsayılan olarak uyumlu bir Codex app-server ikili dosyasını yönetir, bu nedenle PATH üzerindeki yerel codex komutları normal harness başlangıcını etkilemez.
• openclaw models auth login --provider openai-codex üzerinden kullanılabilir Codex kimlik doğrulaması, ajanın Codex ana dizininde bir app-server hesabı veya açık bir Codex API anahtarı kimlik doğrulama profili.

​

Hızlı başlangıç

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

​

Yapılandırma

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

​

Codex çalışma zamanını doğrulama

Runtime: OpenAI Codex

/codex status
/codex models

​

Yönlendirme ve model seçimi

• Codex üzerinden OpenAI ajan dönüşleri için openai/gpt-* kullanın.
• Yapılandırmada openai-codex/gpt-* kullanmayın. Eski ref’leri ve bayat oturum rota sabitlemelerini onarmak için openclaw doctor --fix çalıştırın.
• agentRuntime.id: "codex" normal OpenAI otomatik modu için isteğe bağlıdır, ancak bir dağıtımın Codex kullanılamadığında kapalı başarısız olması gerektiğinde kullanışlıdır.
• agentRuntime.id: "pi", kasıtlı olduğunda bir sağlayıcıyı veya modeli doğrudan PI davranışına geçirir.
• /codex ..., sohbetten yerel Codex app-server konuşmalarını denetler.
• ACP/acpx ayrı bir harici harness yoludur. Bunu yalnızca kullanıcı ACP/acpx veya harici bir harness bağdaştırıcısı istediğinde kullanın.

​

Dağıtım kalıpları

​

Temel Codex dağıtımı

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

​

Karma sağlayıcı dağıtımı

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

​

Kapalı başarısız Codex dağıtımı

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

​

App-server politikası

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

​

Komutlar ve tanılama

• /codex status uygulama sunucusu bağlantısını, modelleri, hesabı, oran sınırlarını, MCP sunucularını ve Skills’i denetler.
• /codex models canlı Codex uygulama sunucusu modellerini listeler.
• /codex threads [filter] son Codex uygulama sunucusu iş parçacıklarını listeler.
• /codex resume <thread-id> geçerli OpenClaw oturumunu mevcut bir Codex iş parçacığına bağlar.
• /codex compact Codex uygulama sunucusundan bağlı iş parçacığını sıkıştırmasını ister.
• /codex review bağlı iş parçacığı için Codex yerel incelemesini başlatır.
• /codex diagnostics [note] bağlı iş parçacığı için Codex geri bildirimi göndermeden önce onay ister.
• /codex account hesap ve oran sınırı durumunu gösterir.
• /codex mcp Codex uygulama sunucusu MCP sunucusu durumunu listeler.
• /codex skills Codex uygulama sunucusu Skills’ini listeler.

​

Codex iş parçacıklarını yerel olarak inceleyin

codex resume <thread-id>

1. Aracı için sıralı OpenAI kimlik doğrulama profilleri; tercihen auth.order.openai altında. Mevcut openai-codex:* profil kimlikleri geçerli kalır.
2. Bu aracının Codex ana dizinindeki uygulama sunucusunun mevcut hesabı.
3. Yalnızca yerel stdio uygulama sunucusu başlatmaları için, uygulama sunucusu hesabı yoksa ve OpenAI kimlik doğrulaması hâlâ gerekiyorsa önce CODEX_API_KEY, ardından OPENAI_API_KEY.

{
  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

​

Yerel Codex Plugin’leri

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          codexPlugins: {
            enabled: true,
            allow_destructive_actions: true,
            plugins: {
              "google-calendar": {
                enabled: true,
                marketplaceName: "openai-curated",
                pluginName: "google-calendar",
              },
            },
          },
        },
      },
    },
  },
}

​

Bilgisayar Kullanımı

​

Çalışma zamanı sınırları

• OpenClaw dinamik araçları desteklenir. Codex, OpenClaw’dan bu araçları yürütmesini ister; bu nedenle OpenClaw yürütme yolunda kalır.
• Codex’e yerel shell, patch, MCP ve yerel uygulama araçları Codex’e aittir. OpenClaw, desteklenen relay üzerinden seçili yerel olayları gözlemleyebilir veya engelleyebilir, ancak yerel araç argümanlarını yeniden yazmaz.
• Yerel Compaction Codex’e aittir. OpenClaw kanal geçmişi, arama, /new, /reset ve gelecekteki model veya harness geçişleri için bir transkript yansısı tutar.
• Medya üretimi, medya anlama, TTS, onaylar ve mesajlaşma aracı çıktısı eşleşen OpenClaw sağlayıcı/model ayarları üzerinden devam eder.
• tool_result_persist, Codex’e yerel araç sonucu kayıtlarına değil, OpenClaw’a ait transkript araç sonuçlarına uygulanır.

​

Sorun giderme

​

İlgili

• Codex harness başvurusu
• Codex harness çalışma zamanı
• Yerel Codex Plugin’leri
• Codex Bilgisayar Kullanımı
• Aracı çalışma zamanları
• Model sağlayıcıları
• OpenAI sağlayıcısı
• Aracı harness Plugin’leri
• Plugin kancaları
• Tanılamaları dışa aktarma
• Durum
• Test Etme