xAI

번들 grok 웹 검색 provider는 xAI OAuth를 우선 사용한 후, XAI_API_KEY 또는 plugin 웹 검색 키를 대체 수단으로 사용합니다.

openclaw models auth login --provider xai --method oauthopenclaw config set tools.web.search.provider grok

번들 xai plugin은 공유 video_generate 도구를 통해 동영상 생성을 등록합니다.

• 기본 모델: xai/grok-imagine-video
• 추가 모델: xai/grok-imagine-video-1.5
• 클래식 모드: 텍스트-동영상, 이미지-동영상, 참조 이미지 생성, 원격 동영상 편집 및 원격 동영상 확장
• Video 1.5 모드: 정확히 하나의 첫 프레임 이미지를 사용하는 이미지-동영상만 지원
• 화면 비율: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3; 생략하면 클래식 및 Video 1.5 이미지-동영상은 소스 이미지 비율을 상속합니다.
• 해상도: 클래식 480P/720P; Video 1.5는 1080P도 지원하며, 모든 생성 모드의 기본값은 480P입니다.
• 길이: 생성/이미지-동영상은 1-15초, 클래식 reference_image 역할을 사용할 때는 1-10초, 클래식 확장은 2-10초
• 참조 이미지 생성: 제공하는 모든 이미지에 대해 imageRoles을 reference_image으로 설정하십시오. xAI는 이러한 이미지를 최대 7개까지 허용합니다.
• 동영상 편집/확장은 입력 동영상의 화면 비율과 해상도를 상속하며, 이러한 작업에는 기하 구조 재정의를 사용할 수 없습니다.
• 기본 작업 제한 시간: video_generate.timeoutMs 또는 agents.defaults.videoGenerationModel.timeoutMs이 설정되지 않은 경우 600초

Video 1.5는 xAI의 grok-imagine-video-1.5-preview 및 grok-imagine-video-1.5-2026-05-30 식별자도 인식합니다. OpenClaw는 선택한 식별자를 변경하지 않고 전달하지만 동일한 이미지 전용 검증을 적용합니다.

xAI를 기본 동영상 provider로 사용하려면 다음과 같이 설정하십시오.

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

번들 xai plugin은 공유 image_generate 도구를 통해 이미지 생성을 등록합니다.

• 기본 이미지 모델: xai/grok-imagine-image
• 추가 모델: xai/grok-imagine-image-quality
• 모드: 텍스트-이미지 생성 및 참조 이미지 편집
• 참조 입력: image 1개 또는 images 최대 3개
• 가로세로 비율: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20
• 해상도: 1K, 2K
• 개수: 최대 4개 이미지
• 기본 작업 제한 시간: image_generate.timeoutMs 또는 agents.defaults.imageGenerationModel.timeoutMs이 설정되지 않은 경우 600초

OpenClaw는 생성된 미디어를 일반 채널 첨부 파일 경로를 통해 저장하고 전달할 수 있도록 xAI에 b64_json 이미지 응답을 요청합니다. 로컬 참조 이미지는 데이터 URL로 변환되며, 원격 http(s) 참조는 변경 없이 전달됩니다.

xAI를 기본 이미지 제공자로 사용하려면 다음과 같이 설정하십시오.

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

번들로 제공되는 xai Plugin은 공유 tts 제공자 인터페이스를 통해 텍스트 음성 변환을 등록합니다.

• 음성: xAI에서 인증을 거쳐 가져오는 실시간 카탈로그이며, 다음 명령으로 나열할 수 있습니다. openclaw infer tts voices --provider xai
• 오프라인 대체 음성: ara, eve, leo, rex, sal
• 기본 음성: eve
• 계정의 사용자 지정 음성 ID는 기본 제공 카탈로그 응답에 없더라도 전달됩니다.
• 형식: mp3, wav, pcm, mulaw, alaw
• 언어: BCP-47 코드 또는 auto
• 속도: 제공자 네이티브 속도 재정의
• 네이티브 Opus 음성 메시지 형식은 지원되지 않습니다.

xAI를 기본 TTS 제공자로 사용하려면 다음과 같이 설정하십시오.

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

번들로 제공되는 xai Plugin은 OpenClaw의 미디어 이해 전사 인터페이스를 통해 배치 음성 텍스트 변환을 등록합니다.

• 엔드포인트: xAI REST /v1/stt
• 입력 경로: 멀티파트 오디오 파일 업로드
• 모델 선택: xAI가 내부적으로 전사 모델을 선택하며, 엔드포인트에는 모델 선택기가 없습니다.
• Discord 음성 채널 세그먼트와 채널 오디오 첨부 파일을 포함하여 수신 오디오 전사가 tools.media.audio을 읽는 모든 곳에서 사용됩니다.

수신 오디오 전사에 xAI를 강제로 사용하려면 다음과 같이 설정하십시오.

{  tools: {    media: {      audio: {        models: [          {            type: "provider",            provider: "xai",          },        ],      },    },  },}

언어는 공유 오디오 미디어 구성 또는 호출별 전사 요청을 통해 지정할 수 있습니다. 공유 OpenClaw 인터페이스는 프롬프트 힌트를 허용하지만, 현재 공개 xAI 엔드포인트에 매핑되는 항목은 파일과 언어뿐이므로 xAI REST STT 통합은 이 두 항목만 전달합니다.

번들로 제공되는 xai Plugin은 실시간 음성 통화 오디오를 위한 실시간 전사 제공자도 등록합니다.

• 엔드포인트: xAI WebSocket wss://api.x.ai/v1/stt
• 기본 인코딩: mulaw
• 기본 샘플 레이트: 8000
• 기본 발화 종료 감지: 800ms
• 중간 전사: 기본적으로 활성화됨

Voice Call의 Twilio 미디어 스트림은 G.711 mu-law 오디오 프레임을 전송하므로, xAI 제공자는 트랜스코딩 없이 해당 프레임을 직접 전달합니다.

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

제공자가 소유하는 구성은 plugins.entries.voice-call.config.streaming.providers.xai 아래에 있습니다. 지원되는 키는 apiKey, baseUrl, sampleRate, encoding (pcm, mulaw 또는 alaw), interimResults, endpointingMs 및 language입니다.

번들로 제공되는 xai Plugin은 공유 registerRealtimeVoiceProvider 계약을 통해 Talk 모드용 Grok Voice Agent 실시간 세션을 등록합니다.

• 엔드포인트: wss://api.x.ai/v1/realtime?model=<voice-model>
• 기본 모델: grok-voice-latest
• 기본 음성: eve
• 전송 방식: gateway-relay (iOS, Android 및 Control UI 릴레이 경로)
• 오디오: PCM16 24 kHz 또는 G.711 µ-law 8 kHz
• 끼어들기: xAI 서버 VAD가 응답을 중단하며, OpenClaw는 대기 중인 재생을 비우고 재생되지 않은 제공자 기록을 잘라냅니다.

Gateway에서 Talk를 구성하십시오.

{  talk: {    realtime: {      provider: "xai",      mode: "realtime",      transport: "gateway-relay",      brain: "agent-consult",      providers: {        xai: {          model: "grok-voice-latest",          voice: "eve",          // 제공자 측 세션 재생을 허용할 수 있는 경우에만 활성화하십시오.          sessionResumption: false,        },      },    },  },  env: { XAI_API_KEY: "xai-..." },}

Voice Call 또는 공유 실시간 선택기가 동일한 제공자 맵을 재사용하는 경우, 제공자가 소유하는 구성은 plugins.entries.voice-call.config.realtime.providers.xai에서도 확인됩니다. 지원되는 키는 apiKey, baseUrl, model, voice, vadThreshold, silenceDurationMs, prefixPaddingMs, reasoningEffort 및 sessionResumption입니다. reasoningEffort은 xAI Voice Agent API에 맞게 high 또는 none만 허용합니다.

xAI의 서버 VAD는 항상 응답을 생성하고 오디오 중단을 처리합니다. consultRouting: "provider-direct"을 사용하십시오. 강제 전사 라우팅 및 입력 오디오 중단 비활성화는 xAI Voice Agent 프로토콜에서 지원되지 않습니다.

번들로 제공되는 xAI Plugin은 Grok을 통해 X(이전의 Twitter) 콘텐츠를 검색하기 위한 OpenClaw 도구로 x_search을 노출합니다.

구성 경로: plugins.entries.xai.config.xSearch

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

번들로 제공되는 xAI Plugin은 xAI의 샌드박스 환경에서 원격 코드를 실행하기 위한 OpenClaw 도구로 code_execution을 노출합니다.

구성 경로: plugins.entries.xai.config.codeExecution

{  plugins: {    entries: {      xai: {        config: {          codeExecution: {            enabled: true,            model: "grok-4.3",          },        },      },    },  },}

• xAI 인증에는 API 키, 환경 변수, 플러그인 구성 폴백 또는 적격 xAI 계정의 OAuth를 사용할 수 있습니다. OAuth는 localhost 콜백 없이 기기 코드 검증을 사용합니다. OAuth API 토큰을 받을 수 있는 계정은 xAI가 결정하며, OpenClaw에는 Grok Build 앱이 필요하지 않더라도 동의 페이지에 Grok Build가 표시될 수 있습니다.
• OpenClaw는 현재 xAI 다중 에이전트 모델 제품군을 제공하지 않습니다. xAI는 Responses API를 통해 이러한 모델을 제공하지만, 해당 모델은 OpenClaw의 공유 에이전트 루프에서 사용하는 클라이언트 측 도구 또는 사용자 지정 도구를 허용하지 않습니다. xAI 다중 에이전트 제한 사항을 참조하십시오.
• 현재 xAI 실시간 음성은 게이트웨이 릴레이 Talk 전송만 제공합니다. 브라우저가 소유하는 제공자 WebSocket 세션은 아직 Control UI에 연결되지 않았습니다.
• xAI 이미지 quality, 이미지 mask 및 추가 네이티브 전용 종횡비는 공유 image_generate 도구에 상응하는 제공자 간 제어 기능이 마련될 때까지 제공되지 않습니다.

• OpenClaw는 공유 러너 경로에서 xAI 전용 도구 스키마 및 도구 호출 호환성 수정 사항을 자동으로 적용합니다.
• 네이티브 xAI 요청은 기본적으로 tool_stream: true합니다. 비활성화하려면 agents.defaults.models["xai/<model>"].params.tool_stream을 false(으)로 설정하십시오.
• 번들 xAI 래퍼는 네이티브 xAI 요청을 보내기 전에 지원되지 않는 contains-count 스키마 경계와 지원되지 않는 추론 노력 수준 페이로드 키를 제거합니다. Grok 4.5는 낮음, 중간, 높음 노력 수준을 지원합니다(기본값: 높음). Grok 4.3은 없음, 낮음, 중간, 높음 노력 수준을 지원합니다(기본값: 낮음). 추론을 지원하는 다른 xAI 모델은 구성 가능한 노력 수준 제어 기능을 제공하지 않지만, 후속 턴에서 이전에 암호화된 추론을 재생할 수 있도록 여전히 include: ["reasoning.encrypted_content"]을 요청합니다.
• web_search, x_search 및 code_execution은 OpenClaw 도구로 제공됩니다. OpenClaw는 모든 채팅 턴에 모든 네이티브 도구를 연결하는 대신, 각 도구에 필요한 특정 xAI 내장 기능만 해당 도구의 요청에 연결합니다.
• Grok web_search은 plugins.entries.xai.config.webSearch.baseUrl을 읽습니다. x_search은 plugins.entries.xai.config.xSearch.baseUrl을 읽은 다음, Grok 웹 검색 기본 URL로 폴백합니다.
• x_search 및 code_execution은 핵심 모델 런타임에 하드코딩되지 않고 번들 xAI 플러그인이 소유합니다.
• code_execution은 로컬 exec이 아니라 원격 xAI 샌드박스 실행입니다.