Uprząż Codex

​

Wymagania

• Zainstalowany oficjalny plugin @openclaw/codex. Jeśli konfiguracja używa listy dozwolonych, uwzględnij codex w plugins.allow.
• App-server Codex w wersji 0.143.0 lub nowszej. Plugin domyślnie zarządza zgodnym plikiem binarnym, więc polecenie codex dostępne w PATH nie wpływa na normalne uruchamianie.
• Uwierzytelnianie Codex przez openclaw models auth login --provider openai, konto app-servera już obecne w katalogu domowym Codex agenta lub jawny profil uwierzytelniania Codex za pomocą klucza API.

​

Szybki start

openclaw plugins install @openclaw/codex
openclaw models auth login --provider openai

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

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

​

Współdzielenie wątków z Codex Desktop i CLI

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

​

Nadzorowanie sesji Codex

​

Konfiguracja

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

​

Compaction

​

Weryfikacja środowiska uruchomieniowego Codex

Środowisko uruchomieniowe: OpenAI Codex

/codex status
/codex models

​

Routing i wybór modelu

• Użyj openai/gpt-* do kanonicznego wyboru modelu OpenAI. Sam prefiks nigdy nie wybiera środowiska Codex.
• Gdy środowisko uruchomieniowe nie jest ustawione lub ma wartość auto, tylko dokładna oficjalna trasa HTTPS Platform Responses albo ChatGPT Responses bez jawnego nadpisania żądania może niejawnie wybrać Codex.
• Nie używaj starszych odwołań Codex GPT w konfiguracji; uruchom openclaw doctor --fix, aby naprawić starsze odwołania i nieaktualne przypięcia tras sesji.
• agentRuntime.id: "codex" sprawia, że Codex jest wymaganiem bez mechanizmu awaryjnego dla zgodnej trasy. Nie powoduje, że faktycznie używana niezgodna trasa staje się zgodna.
• agentRuntime.id: "openclaw" włącza dostawcę lub model do osadzonego środowiska uruchomieniowego OpenClaw, gdy jest to zamierzone.
• /codex ... steruje natywnymi konwersacjami serwera aplikacji Codex z poziomu czatu.
• ACP/acpx stanowi oddzielną ścieżkę zewnętrznej uprzęży. Używaj jej tylko wtedy, gdy użytkownik prosi o ACP/acpx lub adapter zewnętrznej uprzęży.

​

Wzorce wdrożeń

​

Podstawowe wdrożenie Codex

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

​

Wdrożenie z wieloma 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.6-sol",
      },
    ],
  },
}

​

Wdrożenie Codex bez mechanizmu awaryjnego

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

​

Zasady serwera aplikacji

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

​

Polecenia i diagnostyka

• /codex status sprawdza łączność z serwerem aplikacji, modele, konto, limity szybkości, serwery MCP oraz Skills.
• /codex models wyświetla aktualne modele serwera aplikacji Codex.
• /codex threads [filter] wyświetla ostatnie wątki serwera aplikacji Codex.
• /codex resume <thread-id> dołącza bieżącą sesję OpenClaw do istniejącego wątku Codex.
• /codex bind [thread-id] [--cwd <path>] [--model <model>] [--provider <provider>] dołącza bieżący czat.
• /codex detach (lub /codex unbind) odłącza bieżące powiązanie.
• /codex binding opisuje bieżące powiązanie.
• /codex stop zatrzymuje aktywną turę; /codex steer <text> nią kieruje.
• /codex model <model>, /codex fast [on|off|status] oraz /codex permissions [default|yolo|status] zmieniają stan poszczególnych konwersacji.
• /codex compact zleca serwerowi aplikacji Codex skompaktowanie dołączonego wątku.
• /codex review rozpoczyna natywną recenzję Codex dla dołączonego wątku.
• /codex diagnostics [note] prosi o potwierdzenie przed wysłaniem opinii o Codex dla dołączonego wątku.
• /codex account wyświetla stan konta i limitów szybkości.
• /codex mcp wyświetla stan serwerów MCP serwera aplikacji Codex.
• /codex skills wyświetla Skills serwera aplikacji Codex.
• /codex plugins list, /codex plugins enable <name> oraz /codex plugins disable <name> zarządzają skonfigurowanymi natywnymi pluginami Codex.
• /codex computer-use [status|install] zarządza funkcją Codex Computer Use.
• /codex help wyświetla pełne drzewo poleceń.

​

Lokalne sprawdzanie wątków Codex

codex resume <thread-id>

​

Kolejność uwierzytelniania

1. Uporządkowane profile uwierzytelniania OpenAI dla agenta, najlepiej w auth.order.openai. Uruchom openclaw doctor --fix, aby zmigrować starsze, przestarzałe identyfikatory profili uwierzytelniania Codex i przestarzałą kolejność uwierzytelniania Codex.
2. Istniejące konto serwera aplikacji w katalogu domowym Codex tego agenta.
3. Tylko w przypadku lokalnych uruchomień serwera aplikacji przez stdio: CODEX_API_KEY, a następnie OPENAI_API_KEY, gdy konto serwera aplikacji nie istnieje, a uwierzytelnianie OpenAI jest nadal wymagane.

​

Izolacja środowiska

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

​

Narzędzia dynamiczne i wyszukiwanie w internecie

​

Pola konfiguracji

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

​

Limity czasu dynamicznych wywołań narzędzi

​

Lokalne nadpisania środowiska testowego

• OPENCLAW_CODEX_APP_SERVER_BIN pomija zarządzany plik binarny, gdy appServer.command nie jest ustawione.
• 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 zleca OpenClaw wykonanie tych narzędzi, więc OpenClaw pozostaje w ścieżce wykonania.
• Natywne narzędzia powłoki, poprawek, MCP i aplikacji Codex należą do Codex. OpenClaw może obserwować lub blokować wybrane zdarzenia natywne za pomocą obsługiwanego przekaźnika, ale nie przepisuje argumentów natywnych narzędzi.
• Codex odpowiada za natywne Compaction. OpenClaw przechowuje kopię transkrypcji na potrzeby historii kanału, wyszukiwania, /new, /reset oraz przyszłej zmiany modelu lub mechanizmu, ale nie zastępuje Compaction Codex podsumowywaniem OpenClaw ani silnika kontekstu.
• Generowanie i analiza multimediów, TTS, zatwierdzenia oraz wyjście narzędzia wiadomości nadal korzystają z odpowiednich ustawień dostawcy/modelu OpenClaw.
• tool_result_persist dotyczy wyników narzędzi transkrypcji należących do OpenClaw, a nie natywnych rekordów wyników narzędzi Codex.

​

Rozwiązywanie problemów

(
  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

​

Powiązane

• Dokumentacja uprzęży Codex
• Środowisko uruchomieniowe uprzęży Codex
• Nadzór Codex
• Natywne pluginy Codex
• Codex Computer Use
• Środowiska uruchomieniowe agentów
• Dostawcy modeli
• Dostawca OpenAI
• Pomoc dotycząca OpenAI Codex
• Pluginy uprzęży agentów
• Hooki Pluginów
• Eksport diagnostyki
• Stan
• Testowanie