Dokumentacja środowiska uruchomieniowego Codex

​

Powierzchnia konfiguracji pluginu

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

​

Nadzór

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

​

Transport serwera aplikacji

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

​

Tryby zatwierdzania i piaskownicy

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

​

Natywne wykonywanie w piaskownicy

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

​

Izolacja uwierzytelniania i środowiska

1. Jawny profil uwierzytelniania OpenClaw Codex dla agenta.
2. Istniejące konto serwera aplikacji w katalogu domowym Codex tego agenta.
3. Tylko w przypadku lokalnych uruchomień serwera aplikacji stdio: CODEX_API_KEY, a następnie OPENAI_API_KEY, gdy nie istnieje konto serwera aplikacji, a uwierzytelnianie OpenAI jest nadal wymagane.

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

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

​

Narzędzia dynamiczne

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

​

Limity czasu

• Dodatni argument timeoutMs dla danego wywołania.
• Dla image_generate: agents.defaults.imageGenerationModel.timeoutMs.
• Dla image_generate bez skonfigurowanego limitu czasu: domyślny limit generowania obrazów wynoszący 120 sekund.
• Dla narzędzia rozumienia multimediów image: tools.media.image.timeoutSeconds przeliczone na milisekundy lub domyślny limit multimediów wynoszący 60 sekund. W przypadku rozumienia obrazów dotyczy to samego żądania i nie jest pomniejszane o wcześniejsze prace przygotowawcze.
• Dla narzędzia message: stały domyślny limit wynoszący 120 sekund.
• Domyślny limit narzędzia dynamicznego wynoszący 90 sekund.

​

Wykrywanie modeli

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

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

​

Pliki inicjalizacji przestrzeni roboczej

• TOOLS.md jest przekazywane jako dziedziczone instrukcje deweloperskie Codex, dzięki czemu natywne podagenty Codex uruchomione podczas tury również je otrzymują.
• SOUL.md, IDENTITY.md i USER.md są przekazywane jako ograniczone do tury instrukcje współpracy. Natywne podagenty Codex ich nie dziedziczą, dzięki czemu tury podagentów nie przejmują persony i profilu użytkownika agenta nadrzędnego.
• Skrócona lista załadowanych Skills OpenClaw jest również przekazywana jako ograniczone do tury deweloperskie instrukcje współpracy, dlatego natywne podagenty Codex także jej nie dziedziczą.
• Treść HEARTBEAT.md nie jest wstrzykiwana; tury Heartbeat otrzymują w trybie współpracy wskazówkę, aby odczytać plik, jeśli istnieje i nie jest pusty.
• Treść MEMORY.md ze skonfigurowanej przestrzeni roboczej agenta nie jest wklejana do danych wejściowych natywnej tury Codex, gdy dla tej przestrzeni roboczej dostępne są narzędzia pamięci; jeśli plik istnieje, mechanizm wykonawczy dodaje małą wskazówkę dotyczącą pamięci przestrzeni roboczej do ograniczonych do tury deweloperskich instrukcji współpracy, a Codex powinien użyć memory_search lub memory_get, gdy istotna jest pamięć trwała. Jeśli narzędzia są wyłączone, wyszukiwanie w pamięci jest niedostępne lub aktywna przestrzeń robocza różni się od przestrzeni roboczej pamięci agenta, MEMORY.md korzysta ze zwykłej, ograniczonej ścieżki kontekstu tury.
• BOOTSTRAP.md, jeśli jest dostępne, jest przekazywane jako kontekst referencyjny danych wejściowych tury OpenClaw.

​

Nadpisania środowiskowe

• 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

​

Powiązane

• Mechanizm wykonawczy Codex
• Środowisko uruchomieniowe mechanizmu wykonawczego Codex
• Nadzór Codex
• Natywne pluginy Codex
• Obsługa komputera przez Codex
• Dostawca OpenAI
• Dokumentacja konfiguracji