Przejdź do głównej treści

​
xAI

OpenClaw dostarcza dołączony Plugin dostawcy xai dla modeli Grok.

​
Pierwsze kroki

1

Utwórz klucz API

Utwórz klucz API w konsoli xAI.
2

Ustaw klucz API

Ustaw XAI_API_KEY albo uruchom:
openclaw onboard --auth-choice xai-api-key
3

Wybierz model

{
  agents: { defaults: { model: { primary: "xai/grok-4" } } },
}
OpenClaw używa xAI Responses API jako dołączonego transportu xAI. Ten sam XAI_API_KEY może także zasilać web_search oparty na Grok, natywne x_search oraz zdalne code_execution. Jeśli przechowujesz klucz xAI w plugins.entries.xai.config.webSearch.apiKey, dołączony dostawca modeli xAI także używa tego klucza jako fallbacku. Dostrajanie code_execution znajduje się w plugins.entries.xai.config.codeExecution.

​
Dołączony katalog modeli

OpenClaw zawiera domyślnie następujące rodziny modeli xAI:
RodzinaIdentyfikatory modeli
Grok 3grok-3, grok-3-fast, grok-3-mini, grok-3-mini-fast
Grok 4grok-4, grok-4-0709
Grok 4 Fastgrok-4-fast, grok-4-fast-non-reasoning
Grok 4.1 Fastgrok-4-1-fast, grok-4-1-fast-non-reasoning
Grok 4.20 Betagrok-4.20-beta-latest-reasoning, grok-4.20-beta-latest-non-reasoning
Grok Codegrok-code-fast-1
Plugin dodatkowo forward-resolve’uje nowsze identyfikatory grok-4* i grok-code-fast*, gdy mają ten sam kształt API.
grok-4-fast, grok-4-1-fast oraz warianty grok-4.20-beta-* to obecne referencje Grok z obsługą obrazów w dołączonym katalogu.

​
Mapowania trybu fast

/fast on lub agents.defaults.models["xai/<model>"].params.fastMode: true przepisuje natywne żądania xAI w następujący sposób:
Model źródłowyCel trybu fast
grok-3grok-3-fast
grok-3-minigrok-3-mini-fast
grok-4grok-4-fast
grok-4-0709grok-4-fast

​
Aliasy zgodności legacy

Aliasom legacy nadal odpowiadają kanoniczne dołączone identyfikatory:
Alias legacyIdentyfikator kanoniczny
grok-4-fast-reasoninggrok-4-fast
grok-4-1-fast-reasoninggrok-4-1-fast
grok-4.20-reasoninggrok-4.20-beta-latest-reasoning
grok-4.20-non-reasoninggrok-4.20-beta-latest-non-reasoning

​
Funkcje

Dołączony Plugin xai rejestruje generowanie wideo przez współdzielone narzędzie video_generate.
  • Domyślny model wideo: xai/grok-imagine-video
  • Tryby: tekst-na-wideo, obraz-na-wideo oraz zdalne przepływy edycji/rozszerzania wideo
  • Obsługuje aspectRatio i resolution
Lokalne bufory wideo nie są akceptowane. Używaj zdalnych URL-i http(s) dla wejść referencyjnych wideo i wejść edycji.
Aby używać xAI jako domyślnego dostawcy wideo:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "xai/grok-imagine-video",
      },
    },
  },
}
Zobacz Video Generation, aby poznać wspólne parametry narzędzia, wybór dostawcy i zachowanie failover.
Dołączony Plugin xAI udostępnia code_execution jako narzędzie OpenClaw do zdalnego wykonywania kodu w środowisku sandbox xAI.Ścieżka konfiguracji: plugins.entries.xai.config.codeExecution
KluczTypDomyślnieOpis
enabledbooleantrue (jeśli klucz jest dostępny)Włącza lub wyłącza wykonywanie kodu
modelstringgrok-4-1-fastModel używany do żądań wykonywania kodu
maxTurnsnumber—Maksymalna liczba tur rozmowy
timeoutSecondsnumber—Timeout żądania w sekundach
To jest zdalne wykonywanie w sandboxie xAI, a nie lokalne exec.
{
  plugins: {
    entries: {
      xai: {
        config: {
          codeExecution: {
            enabled: true,
            model: "grok-4-1-fast",
          },
        },
      },
    },
  },
}
  • Obecnie uwierzytelnianie obsługuje tylko klucz API. OpenClaw nie ma jeszcze OAuth ani przepływu device-code dla xAI.
  • grok-4.20-multi-agent-experimental-beta-0304 nie jest obsługiwany na zwykłej ścieżce dostawcy xAI, ponieważ wymaga innej powierzchni upstream API niż standardowy transport xAI w OpenClaw.
  • OpenClaw automatycznie stosuje poprawki zgodności schematów narzędzi i wywołań narzędzi specyficzne dla xAI na współdzielonej ścieżce runnera.
  • Natywne żądania xAI domyślnie używają tool_stream: true. Ustaw agents.defaults.models["xai/<model>"].params.tool_stream na false, aby to wyłączyć.
  • Dołączony wrapper xAI usuwa nieobsługiwane ścisłe flagi schematu narzędzi i klucze payloadu reasoning przed wysłaniem natywnych żądań xAI.
  • web_search, x_search i code_execution są udostępniane jako narzędzia OpenClaw. OpenClaw włącza konkretny wbudowany mechanizm xAI, którego potrzebuje, wewnątrz każdego żądania narzędzia, zamiast dołączać wszystkie natywne narzędzia do każdej tury czatu.
  • x_search i code_execution należą do dołączonego Pluginu xAI, a nie są na stałe zakodowane w głównym runtime modeli.
  • code_execution to zdalne wykonywanie w sandboxie xAI, a nie lokalne exec.

​
Powiązane

Wybór modelu

Wybór dostawców, referencji modeli i zachowania failover.

Generowanie wideo

Wspólne parametry narzędzia wideo i wybór dostawcy.

Wszyscy dostawcy

Szerszy przegląd dostawców.

Rozwiązywanie problemów

Typowe problemy i poprawki.