xAI

Dołączony dostawca wyszukiwania w sieci grok może używać XAI_API_KEY albo klucza wyszukiwania w sieci Pluginu:

openclaw config set tools.web.search.provider grok

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, generowanie z obrazem referencyjnym, zdalna edycja wideo i zdalne przedłużanie wideo
• Proporcje obrazu: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3
• Rozdzielczości: 480P, 720P
• Czas trwania: 1-15 sekund dla generowania/obrazu-na-wideo, 1-10 sekund przy użyciu ról reference_image, 2-10 sekund dla przedłużania
• Generowanie z obrazem referencyjnym: ustaw imageRoles na reference_image dla każdego dostarczonego obrazu; xAI akceptuje do 7 takich obrazów

Aby używać xAI jako domyślnego dostawcy wideo:

{  agents: {    defaults: {      videoGenerationModel: {        primary: "xai/grok-imagine-video",      },    },  },}

Dołączony Plugin xai rejestruje generowanie obrazów przez współdzielone narzędzie image_generate.

• Domyślny model obrazu: xai/grok-imagine-image
• Dodatkowy model: xai/grok-imagine-image-pro
• Tryby: tekst-na-obraz i edycja obrazu referencyjnego
• Wejścia referencyjne: jeden image albo do pięciu images
• Proporcje obrazu: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Rozdzielczości: 1K, 2K
• Liczba: do 4 obrazów

OpenClaw prosi xAI o odpowiedzi obrazów b64_json, aby wygenerowane media mogły być przechowywane i dostarczane normalną ścieżką załączników kanału. Lokalne obrazy referencyjne są konwertowane na adresy URL danych; zdalne referencje http(s) są przekazywane bez zmian.

Aby używać xAI jako domyślnego dostawcy obrazów:

{  agents: {    defaults: {      imageGenerationModel: {        primary: "xai/grok-imagine-image",      },    },  },}

Dołączony Plugin xai rejestruje text-to-speech przez współdzieloną powierzchnię dostawcy tts.

• Głosy: eve, ara, rex, sal, leo, una
• Domyślny głos: eve
• Formaty: mp3, wav, pcm, mulaw, alaw
• Język: kod BCP-47 albo auto
• Szybkość: natywne dla dostawcy nadpisanie szybkości
• Natywny format notatki głosowej Opus nie jest obsługiwany

Aby używać xAI jako domyślnego dostawcy TTS:

{  messages: {    tts: {      provider: "xai",      providers: {        xai: {          voiceId: "eve",        },      },    },  },}

Dołączony Plugin xai rejestruje wsadowe speech-to-text przez powierzchnię transkrypcji rozumienia mediów OpenClaw.

• Domyślny model: grok-stt
• Punkt końcowy: xAI REST /v1/stt
• Ścieżka wejściowa: przesłanie wieloczęściowego pliku audio
• Obsługiwane przez OpenClaw wszędzie tam, gdzie transkrypcja przychodzącego audio używa tools.media.audio, w tym w segmentach kanałów głosowych Discord i załącznikach audio kanałów

Aby wymusić xAI dla transkrypcji przychodzącego audio:

{  tools: {    media: {      audio: {        models: [          {            type: "provider",            provider: "xai",            model: "grok-stt",          },        ],      },    },  },}

Język można podać przez współdzieloną konfigurację mediów audio albo przez żądanie transkrypcji dla pojedynczego wywołania. Wskazówki promptu są akceptowane przez współdzieloną powierzchnię OpenClaw, ale integracja xAI REST STT przekazuje tylko plik, model i język, ponieważ te elementy mapują się jasno na bieżący publiczny punkt końcowy xAI.

Dołączony Plugin xai rejestruje też dostawcę transkrypcji czasu rzeczywistego dla audio połączeń głosowych na żywo.

• Punkt końcowy: xAI WebSocket wss://api.x.ai/v1/stt
• Domyślne kodowanie: mulaw
• Domyślna częstotliwość próbkowania: 8000
• Domyślne wykrywanie końca wypowiedzi: 800ms
• Transkrypty tymczasowe: domyślnie włączone

Strumień mediów Twilio w Voice Call wysyła ramki audio G.711 µ-law, więc dostawca xAI może przekazywać te ramki bezpośrednio bez transkodowania:

{  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "xai",            providers: {              xai: {                apiKey: "${XAI_API_KEY}",                endpointingMs: 800,                language: "en",              },            },          },        },      },    },  },}

Konfiguracja należąca do dostawcy znajduje się pod plugins.entries.voice-call.config.streaming.providers.xai. Obsługiwane klucze to apiKey, baseUrl, sampleRate, encoding (pcm, mulaw lub alaw), interimResults, endpointingMs oraz language.

Dołączony Plugin xAI udostępnia x_search jako narzędzie OpenClaw do wyszukiwania treści X (dawniej Twitter) przez Grok.

Ścieżka konfiguracji: plugins.entries.xai.config.xSearch

{  plugins: {    entries: {      xai: {        config: {          xSearch: {            enabled: true,            model: "grok-4-1-fast",            baseUrl: "https://api.x.ai/v1",            inlineCitations: true,          },        },      },    },  },}

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

{  plugins: {    entries: {      xai: {        config: {          codeExecution: {            enabled: true,            model: "grok-4-1-fast",          },        },      },    },  },}

• Uwierzytelnianie odbywa się obecnie tylko przez klucz API. Klucz API może być przechowywany w profilu uwierzytelniania xAI, zmiennej środowiskowej albo konfiguracji pluginu; w OpenClaw nie ma jeszcze przepływu OAuth xAI ani przepływu z kodem urządzenia.
• grok-4.20-multi-agent-experimental-beta-0304 nie jest obsługiwany na normalnej ścieżce dostawcy xAI, ponieważ wymaga innej powierzchni API upstream niż standardowy transport xAI OpenClaw.
• xAI Realtime voice nie jest jeszcze zarejestrowany jako dostawca OpenClaw. Wymaga innego kontraktu dwukierunkowej sesji głosowej niż wsadowe STT lub transkrypcja strumieniowa.
• quality obrazu xAI, mask obrazu oraz dodatkowe współczynniki proporcji dostępne tylko natywnie nie są udostępniane, dopóki współdzielone narzędzie image_generate nie będzie mieć odpowiadających im kontrolek międzydostawcowych.

• OpenClaw automatycznie stosuje poprawki zgodności schematu narzędzi i wywołań narzędzi specyficzne dla xAI na współdzielonej ścieżce runnera.
• Natywne żądania xAI domyślnie ustawiają 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 oraz klucze ładunku reasoning przed wysłaniem natywnych żądań xAI.
• web_search, x_search i code_execution są udostępniane jako narzędzia OpenClaw. OpenClaw włącza konkretną wbudowaną funkcję xAI, której potrzebuje, wewnątrz każdego żądania narzędzia, zamiast dołączać wszystkie natywne narzędzia do każdej tury czatu.
• Grok web_search odczytuje plugins.entries.xai.config.webSearch.baseUrl. x_search odczytuje plugins.entries.xai.config.xSearch.baseUrl, a następnie wraca do bazowego URL wyszukiwania webowego Grok.
• x_search i code_execution należą do dołączonego pluginu xAI, a nie są zakodowane na stałe w głównym runtime modelu.
• code_execution to zdalne wykonywanie w sandboxie xAI, a nie lokalne exec.