Codex çalıştırma ortamı referansı

​

Plugin yapılandırma yüzeyi

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

​

Gözetim

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

​

App-server aktarımı

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

​

Onay ve sandbox modları

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

​

Sandbox içindeki yerel yürütme

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

​

Kimlik doğrulama ve ortam yalıtımı

1. Aracı için açıkça belirtilmiş bir OpenClaw Codex kimlik doğrulama profili.
2. Uygulama sunucusunun söz konusu aracının Codex ana dizinindeki mevcut hesabı.
3. Yalnızca yerel stdio uygulama sunucusu başlatmalarında, hiçbir uygulama sunucusu hesabı yoksa ve OpenAI kimlik doğrulaması hâlâ gerekliyse önce CODEX_API_KEY, ardından OPENAI_API_KEY.

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

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

​

Dinamik araçlar

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

​

Zaman aşımları

• Çağrı başına pozitif bir timeoutMs bağımsız değişkeni.
• image_generate için agents.defaults.mediaModels.image.timeoutMs.
• Yapılandırılmış bir zaman aşımı bulunmayan image_generate için 120 saniyelik varsayılan görüntü oluşturma süresi.
• Medya anlama image aracı için seçilen görüntü özellikli tools.media.models[] girdisinin milisaniyeye dönüştürülmüş timeoutSeconds değeri veya 60 saniyelik varsayılan medya süresi. Görüntü anlamada bu süre isteğin kendisine uygulanır ve önceki hazırlık çalışmaları nedeniyle azaltılmaz.
• message aracı için Gateway teslimatını ve aynı anahtara yönelik sınırlı uzlaştırmayı kapsayan sabit 600 saniyelik dış bütçe.
• 90 saniyelik varsayılan dinamik araç süresi.

​

Model keşfi

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

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

​

Çalışma alanı önyükleme dosyaları

• TOOLS.md, devralınan Codex geliştirici talimatları olarak iletilir; böylece tur sırasında oluşturulan yerel Codex alt ajanları da bunları görür.
• SOUL.md, IDENTITY.md ve USER.md, tur kapsamlı iş birliği talimatları olarak iletilir. Yerel Codex alt ajanları bunları devralmaz; bu da alt ajan turlarının üst ajanın personasını ve kullanıcı profilini almasını önler.
• Yüklenen kompakt OpenClaw Skills listesi de tur kapsamlı iş birliği geliştirici talimatları olarak iletilir; dolayısıyla yerel Codex alt ajanları bunu da devralmaz.
• HEARTBEAT.md içeriği eklenmez; Heartbeat turları, dosya mevcut ve boş değilse dosyayı okumaya yönelik iş birliği modu işaretçisi alır.
• Yapılandırılmış ajan çalışma alanındaki MEMORY.md içeriği, bu çalışma alanı için bellek araçları kullanılabilir olduğunda yerel Codex tur girdisine yapıştırılmaz; içerik mevcutsa koşum takımı, tur kapsamlı iş birliği geliştirici talimatlarına küçük bir çalışma alanı belleği işaretçisi ekler ve kalıcı bellek gerekli olduğunda Codex, memory_search veya memory_get kullanmalıdır. Araçlar devre dışıysa, bellek araması kullanılamıyorsa veya etkin çalışma alanı ajan belleği çalışma alanından farklıysa MEMORY.md, bunun yerine normal sınırlı tur bağlamı yolunu kullanır.
• BOOTSTRAP.md, mevcut olduğunda OpenClaw tur girdisi referans bağlamı olarak iletilir.

​

Ortam geçersiz kılmaları

• 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

​

İlgili

• Codex koşum takımı
• Codex koşum takımı çalışma zamanı
• Codex gözetimi
• Yerel Codex Plugin’leri
• Codex Bilgisayar Kullanımı
• OpenAI sağlayıcısı
• Yapılandırma referansı