xAI

번들 grok web-search provider는 xAI OAuth를 선호한 다음, XAI_API_KEY 또는 plugin web-search 키로 fallback합니다.

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

번들 xai Plugin은 공유 video_generate tool을 통해 video generation을 등록합니다.

• 기본 video 모델: xai/grok-imagine-video
• 모드: text-to-video, image-to-video, reference-image generation, 원격 video edit, 원격 video extension
• Aspect ratio: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3
• Resolution: 480P, 720P
• Duration: generation/image-to-video의 경우 1-15초, reference_image role을 사용할 때는 1-10초, extension의 경우 2-10초
• Reference-image generation: 제공된 모든 image에 대해 imageRoles를 reference_image로 설정하세요. xAI는 이러한 image를 최대 7개까지 허용합니다.
• 기본 operation timeout: video_generate.timeoutMs 또는 agents.defaults.videoGenerationModel.timeoutMs가 설정되지 않은 경우 600초

xAI를 기본 video provider로 사용하려면:

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

번들 xai Plugin은 공유 image_generate tool을 통해 image generation을 등록합니다.

• 기본 image 모델: xai/grok-imagine-image
• 추가 모델: xai/grok-imagine-image-quality
• 모드: text-to-image 및 reference-image edit
• Reference input: 하나의 image 또는 최대 다섯 개의 images
• Aspect ratio: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Resolution: 1K, 2K
• Count: 최대 4개 image
• 기본 operation timeout: image_generate.timeoutMs 또는 agents.defaults.imageGenerationModel.timeoutMs가 설정되지 않은 경우 600초

OpenClaw는 생성된 media가 일반 channel attachment 경로를 통해 저장되고 전달될 수 있도록 xAI에 b64_json image response를 요청합니다. 로컬 reference image는 data URL로 변환되며, 원격 http(s) reference는 그대로 전달됩니다.

xAI를 기본 image provider로 사용하려면:

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

번들된 xai Plugin은 공유 tts 제공자 표면을 통해 텍스트 음성 변환을 등록합니다.

• 음성: eve, ara, rex, sal, leo, una
• 기본 음성: eve
• 형식: mp3, wav, pcm, mulaw, alaw
• 언어: BCP-47 코드 또는 auto
• 속도: 제공자 네이티브 속도 재정의
• 네이티브 Opus 음성 메모 형식은 지원되지 않음

xAI를 기본 TTS 제공자로 사용하려면:

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

번들된 xai Plugin은 OpenClaw의 미디어 이해 전사 표면을 통해 배치 음성 텍스트 변환을 등록합니다.

• 기본 모델: grok-stt
• 엔드포인트: xAI REST /v1/stt
• 입력 경로: multipart 오디오 파일 업로드
• tools.media.audio를 사용하는 인바운드 오디오 전사 어디에서나 OpenClaw가 지원하며, Discord 음성 채널 세그먼트와 채널 오디오 첨부 파일을 포함합니다.

인바운드 오디오 전사에 xAI를 강제로 사용하려면:

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

언어는 공유 오디오 미디어 구성 또는 호출별 전사 요청을 통해 제공할 수 있습니다. 프롬프트 힌트는 공유 OpenClaw 표면에서 허용되지만, xAI REST STT 통합은 현재 공개 xAI 엔드포인트에 깔끔하게 매핑되는 파일, 모델, 언어만 전달합니다.

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

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

Voice Call의 Twilio 미디어 스트림은 G.711 µ-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은 Grok을 통해 X(이전 Twitter) 콘텐츠를 검색하기 위한 OpenClaw 도구로 x_search를 노출합니다.

구성 경로: 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,          },        },      },    },  },}

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

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

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

• xAI 인증은 API 키, 환경 변수, Plugin 구성 폴백 또는 적격 xAI 계정의 OAuth를 사용할 수 있습니다. OAuth는 localhost 콜백 없이 디바이스 코드 검증을 사용합니다. 어떤 계정이 OAuth API 토큰을 받을 수 있는지는 xAI가 결정하며, OpenClaw가 Grok Build 앱을 필요로 하지 않더라도 동의 페이지에 Grok Build가 표시될 수 있습니다.
• OpenClaw는 현재 xAI 멀티 에이전트 모델 제품군을 노출하지 않습니다. xAI는 Responses API를 통해 이러한 모델을 제공하지만, OpenClaw의 공유 에이전트 루프가 사용하는 클라이언트 측 도구나 사용자 지정 도구를 허용하지 않습니다. 자세한 내용은 xAI 멀티 에이전트 제한을 참조하세요.
• xAI Realtime 음성은 아직 OpenClaw 제공자로 등록되지 않았습니다. 배치 STT 또는 스트리밍 전사와는 다른 양방향 음성 세션 계약이 필요합니다.
• xAI 이미지 quality, 이미지 mask, 추가 네이티브 전용 종횡비는 공유 image_generate 도구에 해당 교차 제공자 제어가 생길 때까지 노출되지 않습니다.

• OpenClaw는 공유 러너 경로에서 xAI 전용 도구 스키마 및 도구 호출 호환성 수정을 자동으로 적용합니다.
• 네이티브 xAI 요청은 기본적으로 tool_stream: true입니다. 비활성화하려면 agents.defaults.models["xai/<model>"].params.tool_stream을 false로 설정하세요.
• 번들된 xAI 래퍼는 네이티브 xAI 요청을 보내기 전에 지원되지 않는 엄격한 도구 스키마 플래그와 reasoning effort 페이로드 키를 제거합니다. grok-4.3 / grok-4.3-*만 구성 가능한 reasoning effort를 명시합니다. 다른 모든 추론 가능 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 Plugin이 소유합니다.
• code_execution은 원격 xAI 샌드박스 실행이며, 로컬 exec가 아닙니다.