코드 실행

code_execution은 xAI의 Responses API에서 샌드박스된 원격 Python 분석을 실행합니다. 번들 xai Plugin(tools 계약 아래)에 의해 등록되며, x_search가 사용하는 동일한 https://api.x.ai/v1/responses 엔드포인트로 디스패치됩니다.

이는 로컬 exec와 다릅니다.

• exec는 사용자의 머신 또는 페어링된 Node에서 셸 명령을 실행합니다.
• code_execution은 xAI의 원격 샌드박스에서 Python을 실행합니다.

다음 용도로 code_execution을 사용하세요.

• 계산.
• 표 작성.
• 빠른 통계.
• 차트식 분석.
• x_search 또는 web_search가 반환한 데이터 분석.

로컬 파일, 셸, 저장소 또는 페어링된 기기가 필요할 때는 사용하지 마세요. 그런 경우에는 exec를 사용하세요.

설정

export XAI_API_KEY=xai-...

{  plugins: {    entries: {      xai: {        config: {          webSearch: {            apiKey: "xai-...",          },        },      },    },  },}

{  plugins: {    entries: {      xai: {        config: {          codeExecution: {            enabled: true,            model: "grok-4-1-fast", // override the default xAI code-execution model            maxTurns: 2,            // optional cap on internal tool turns            timeoutSeconds: 30,     // request timeout (default: 30)          },        },      },    },  },}

openclaw gateway restart

사용 방법

자연스럽게 요청하되 분석 의도를 명확히 밝히세요.

Use code_execution to calculate the 7-day moving average for these numbers: ...

Use x_search to find posts mentioning OpenClaw this week, then use code_execution to count them by day.

Use web_search to gather the latest AI benchmark numbers, then use code_execution to compare percent changes.

이 도구는 내부적으로 단일 task 매개변수를 받으므로, 에이전트는 전체 분석 요청과 모든 인라인 데이터를 하나의 프롬프트로 보내야 합니다.

오류

도구가 인증 없이 실행되면 인증 프로필, 환경 변수, 설정 옵션을 가리키는 구조화된 missing_xai_api_key 오류를 반환합니다. 이 오류는 throw된 예외가 아니라 JSON이므로, 에이전트가 스스로 수정할 수 있습니다.

{  "error": "missing_xai_api_key",  "message": "code_execution needs an xAI API key. 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"}

제한

• 이는 로컬 프로세스 실행이 아니라 원격 xAI 실행입니다.
• 결과를 영구적인 노트북 세션이 아니라 일시적인 분석으로 취급하세요.
• 로컬 파일이나 작업 공간에 접근할 수 있다고 가정하지 마세요.
• 최신 X 데이터의 경우 먼저 x_search를 사용한 뒤 결과를 code_execution으로 전달하세요.

관련 항목