Tools
코드 실행
code_execution은 xAI의 Responses API에서 샌드박스 처리된 원격 Python 분석을 실행합니다
(https://api.x.ai/v1/responses, x_search가 사용하는 것과 동일한 엔드포인트). 번들로 제공되는 xai Plugin이
tools 계약에 따라 등록합니다.
| 속성 | 값 |
|---|---|
| 도구 이름 | code_execution |
| 제공자 Plugin | xai(번들 제공, enabledByDefault: true) |
| 인증 | xAI 인증 프로필, XAI_API_KEY 또는 plugins.entries.xai.config.webSearch.apiKey |
| 기본 모델 | grok-4.3 |
| 기본 제한 시간 | 30초 |
기본 maxTurns |
설정되지 않음(xAI가 자체 내부 제한 적용) |
계산, 표 작성, 간단한 통계 및 차트 형태의 분석에 사용하세요.
여기에는 x_search 또는 web_search가 반환한 데이터의 분석도 포함됩니다. 로컬 파일,
셸, 저장소 또는 페어링된 기기에 접근할 수 없으며 호출 간에 상태를 유지하지 않으므로,
각 호출을 노트북 세션이 아닌 일시적인 분석으로 취급하세요. 최신 X 데이터를 사용하려면
먼저 x_search를 실행하고 그 결과를 전달하세요.
로컬에서 실행하려면 대신 exec를 사용하세요.
설정
xAI 자격 증명 제공
OAuth를 사용하려면 자격 요건을 충족하는 SuperGrok 또는 X Premium 구독이 필요합니다 (기기 코드 인증을 사용하므로 localhost 콜백 없이 원격 호스트에서도 작동합니다).
openclaw models auth login --provider xai --method oauth새로 설치하는 동안 온보딩에서도 동일한 옵션을 선택할 수 있습니다.
openclaw onboard --install-daemon --auth-choice xai-oauth또는 API 키를 사용할 수 있습니다.
openclaw models auth login --provider xai --method api-keyexport XAI_API_KEY=xai-...또는 구성을 통해 설정할 수 있습니다.
{ plugins: { entries: { xai: { config: { webSearch: { apiKey: "xai-...", }, }, }, }, },}이 세 가지 방법은 모두 x_search와 Grok web_search에도 인증을 제공합니다.
code_execution 활성화 및 조정
enabled를 생략하면 활성 모델의 제공자가 xai이고 xAI 자격 증명을 확인할 수 있을 때만
code_execution이 노출됩니다. 제공자가 xAI가 아닌 것으로 확인된 활성 모델에서 제공자 간
사용을 선택하려면 plugins.entries.xai.config.codeExecution.enabled를 true로 설정하세요.
활성 모델 제공자가 없거나 확인되지 않으면 도구는 계속 숨겨집니다. 모든 제공자에서 비활성화하려면
enabled를 false로 설정하세요. xAI 자격 증명은 항상 필요합니다.
동일한 블록을 사용하여 모델, 실행 횟수 상한 또는 제한 시간을 재정의할 수 있습니다.
{ plugins: { entries: { xai: { config: { codeExecution: { enabled: true, // xAI가 아닌 것으로 확인된 모델 제공자에는 필수 model: "grok-4.3", // 기본 xAI 코드 실행 모델 재정의 maxTurns: 2, // 내부 도구 실행 횟수의 선택적 상한 timeoutSeconds: 30, // 요청 제한 시간(기본값: 30) }, }, }, }, },}Gateway 다시 시작
openclaw gateway restartxAI Plugin이 다시 등록되고 위의 제공자, 활성화 및 인증 검사를 통과하면
에이전트의 도구 목록에 code_execution이 표시됩니다.
사용 방법
분석 의도를 명확히 밝히세요. 이 도구는 단일 task 매개변수를 받으므로
전체 요청과 인라인 데이터를 하나의 프롬프트로 보내세요.
code_execution을 사용하여 다음 숫자의 7일 이동 평균을 계산하세요: ...x_search를 사용하여 이번 주에 OpenClaw를 언급한 게시물을 찾은 다음, code_execution을 사용하여 날짜별로 집계하세요.web_search를 사용하여 최신 AI 벤치마크 수치를 수집한 다음, code_execution을 사용하여 백분율 변화를 비교하세요.오류
인증이 없으면 도구는 예외를 발생시키는 대신 구조화된 JSON 오류를 반환하므로 에이전트가 스스로 수정할 수 있습니다.
{ "error": "missing_xai_api_key", "message": "code_execution needs xAI credentials. Run `openclaw onboard --auth-choice xai-oauth` to sign in with Grok, run `openclaw onboard --auth-choice xai-api-key`, set `XAI_API_KEY` in the Gateway environment, or configure `plugins.entries.xai.config.webSearch.apiKey`.", "docs": "https://docs.openclaw.ai/tools/code-execution"}