코드 실행

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가 반환한 데이터 분석.

로컬 파일, 셸, repo 또는 페어링된 기기가 필요할 때는 사용하지 마세요. 그런 경우에는 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", // 기본 xAI 코드 실행 모델 재정의
            maxTurns: 2,            // 내부 도구 턴에 대한 선택적 상한
            timeoutSeconds: 30,     // 요청 제한 시간(기본값: 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 매개변수를 받으므로, agent는 전체 분석 요청과 모든 인라인 데이터를 하나의 프롬프트로 보내야 합니다.

# 오류

도구가 인증 없이 실행되면 env var와 config 경로를 가리키는 구조화된 missing_xai_api_key 오류를 반환합니다. 이 오류는 발생한 예외가 아니라 JSON이므로 agent가 스스로 수정할 수 있습니다.

{
  "error": "missing_xai_api_key",
  "message": "code_execution needs an 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 실행입니다.
• 결과를 지속적인 notebook 세션이 아닌 일시적인 분석으로 취급하세요.
• 로컬 파일이나 workspace에 접근할 수 있다고 가정하지 마세요.
• 최신 X 데이터의 경우 먼저 x_search를 사용하고 결과를 code_execution으로 전달하세요.

# 관련 항목