Środowisko uruchomieniowe Codex

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Wymagania

• OpenClaw z dostępnym dołączonym Plugin codex.
• Jeśli Twoja konfiguracja używa plugins.allow, uwzględnij codex.
• App-server Codex 0.125.0 lub nowszy. Dołączony Plugin domyślnie zarządza zgodnym binarium app-server Codex, więc lokalne polecenia codex w PATH nie wpływają na zwykłe uruchamianie uprzęży.
• Uwierzytelnianie Codex dostępne przez openclaw models auth login --provider openai-codex, konto app-server w katalogu domowym Codex agenta albo jawny profil uwierzytelniania Codex z kluczem API.

​

Szybki start

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

​

Konfiguracja

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

​

Weryfikacja środowiska uruchomieniowego Codex

Runtime: OpenAI Codex

/codex status
/codex models

​

Routing i wybór modelu

• Używaj openai/gpt-* dla tur agentów OpenAI przez Codex.
• Nie używaj openai-codex/gpt-* w konfiguracji. Uruchom openclaw doctor --fix, aby naprawić starsze odwołania i nieaktualne przypięcia tras sesji.
• agentRuntime.id: "codex" jest opcjonalne w zwykłym trybie automatycznym OpenAI, ale przydatne, gdy wdrożenie powinno zamknąć się awaryjnie, jeśli Codex jest niedostępny.
• agentRuntime.id: "pi" przełącza dostawcę lub model na bezpośrednie zachowanie PI, gdy jest to zamierzone.
• /codex ... steruje natywnymi konwersacjami app-server Codex z czatu.
• ACP/acpx to osobna ścieżka zewnętrznej uprzęży. Używaj jej tylko wtedy, gdy użytkownik prosi o ACP/acpx albo adapter zewnętrznej uprzęży.

​

Wzorce wdrożenia

​

Podstawowe wdrożenie Codex

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

​

Wdrożenie z mieszanymi dostawcami

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

​

Wdrożenie Codex z zamknięciem awaryjnym

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

​

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

​

Polecenia i diagnostyka

• /codex status sprawdza łączność z app-serverem, modele, konto, limity szybkości, serwery MCP i Skills.
• /codex models wyświetla modele app-servera Codex dostępne na żywo.
• /codex threads [filter] wyświetla ostatnie wątki app-servera Codex.
• /codex resume <thread-id> dołącza bieżącą sesję OpenClaw do istniejącego wątku Codex.
• /codex compact prosi app-server Codex o skompaktowanie dołączonego wątku.
• /codex review uruchamia natywną recenzję Codex dla dołączonego wątku.
• /codex diagnostics [note] pyta przed wysłaniem opinii Codex dla dołączonego wątku.
• /codex account pokazuje stan konta i limitów szybkości.
• /codex mcp wyświetla stan serwera MCP app-servera Codex.
• /codex skills wyświetla Skills app-servera Codex.

​

Lokalna inspekcja wątków Codex

codex resume <thread-id>

1. Uporządkowane profile uwierzytelniania OpenAI dla agenta, najlepiej pod auth.order.openai. Istniejące identyfikatory profili openai-codex:* pozostają prawidłowe.
2. Istniejące konto app-servera w katalogu domowym Codex tego agenta.
3. Tylko w przypadku lokalnych uruchomień app-servera stdio: CODEX_API_KEY, następnie OPENAI_API_KEY, gdy nie ma konta app-servera, a uwierzytelnianie OpenAI nadal jest wymagane.

{
  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

​

Natywne pluginy Codex

{
  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

​

Granice środowiska uruchomieniowego

• Dynamiczne narzędzia OpenClaw są obsługiwane. Codex prosi OpenClaw o wykonanie tych narzędzi, więc OpenClaw pozostaje na ścieżce wykonania.
• Natywne narzędzia powłoki, poprawek, MCP i aplikacji Codex należą do Codex. OpenClaw może obserwować lub blokować wybrane natywne zdarzenia przez obsługiwany przekaźnik, ale nie przepisuje argumentów natywnych narzędzi.
• Codex posiada natywną Compaction. OpenClaw utrzymuje lustrzaną kopię transkrypcji na potrzeby historii kanału, wyszukiwania, /new, /reset oraz przyszłego przełączania modelu lub harnessu.
• Generowanie multimediów, rozumienie multimediów, TTS, zatwierdzenia i wyjście narzędzi komunikacyjnych nadal przechodzą przez odpowiadające im ustawienia dostawcy/modelu OpenClaw.
• tool_result_persist dotyczy należących do OpenClaw wyników narzędzi w transkrypcji, a nie natywnych rekordów wyników narzędzi Codex.

​

Rozwiązywanie problemów

​

Powiązane

• Dokumentacja referencyjna harnessu Codex
• Środowisko uruchomieniowe harnessu Codex
• Natywne pluginy Codex
• Codex Computer Use
• Środowiska uruchomieniowe agentów
• Dostawcy modeli
• Dostawca OpenAI
• Pluginy harnessów agentów
• Hooki pluginów
• Eksport diagnostyki
• Status
• Testowanie