xAI

번들 grok 웹 검색 제공자는 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를 기본 동영상 제공자로 사용하려면 다음과 같이 설정합니다.

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

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

• 기본 이미지 모델: xai/grok-imagine-image
• 추가 모델: xai/grok-imagine-image-quality
• 모드: 텍스트-이미지 생성 및 참조 이미지 편집
• 참조 입력: image 하나 또는 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 뮤로 오디오 프레임을 전송하므로, 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.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 키, 환경 변수, 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, 네이티브 auto 종횡비는 공유 image_generate 도구에 해당하는 제공자 간 공통 제어 항목이 추가될 때까지 노출되지 않습니다.

• OpenClaw는 공유 실행기 경로에서 xAI 전용 도구 스키마 및 도구 호출 호환성 수정을 자동으로 적용합니다.
• 네이티브 xAI 요청의 기본값은 tool_stream: true입니다. 비활성화하려면 agents.defaults.models["xai/<model>"].params.tool_stream을 false로 설정하세요.
• 번들 xAI 래퍼는 네이티브 xAI 요청을 보내기 전에 지원되지 않는 포함 개수 스키마 범위와 지원되지 않는 추론 노력 수준 페이로드 키를 제거합니다. 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 Plugin이 소유합니다.
• code_execution은 로컬 exec가 아니라 원격 xAI 샌드박스 실행입니다.