​

xAI

​

설정

1. xAI 콘솔에서 API 키를 만듭니다.
2. XAI_API_KEY를 설정하거나 다음을 실행합니다:

openclaw onboard --auth-choice xai-api-key

3. 다음과 같은 모델을 선택합니다:

{
  agents: { defaults: { model: { primary: "xai/grok-4" } } },
}

​

현재 번들 모델 카탈로그

• grok-4, grok-4-0709
• grok-4-fast-reasoning, grok-4-fast-non-reasoning
• grok-4-1-fast-reasoning, grok-4-1-fast-non-reasoning
• grok-4.20-reasoning, grok-4.20-non-reasoning
• grok-code-fast-1

​

웹 검색

openclaw config set tools.web.search.provider grok

​

알려진 제한

• 현재 인증은 API 키만 지원합니다. OpenClaw에는 xAI OAuth/device-code 흐름이 아직 없습니다.
• grok-4.20-multi-agent-experimental-beta-0304는 일반 xAI provider 경로에서 지원되지 않습니다. 표준 OpenClaw xAI 전송과 다른 upstream API를 요구하기 때문입니다.
• x_search, code_execution 같은 xAI 네이티브 server-side tool은 번들 플러그인에서 아직 1급 모델 provider 기능이 아닙니다.

​

참고

• OpenClaw는 공용 runner 경로에서 xAI 전용 tool-schema 및 tool-call 호환성 수정을 자동 적용합니다.
• provider 전체 개요는 Model providers를 참조하세요.