메인 콘텐츠로 건너뛰기

코드 실행

code_execution은 xAI의 Responses API에서 샌드박스된 원격 Python 분석을 실행합니다. 이는 로컬 exec와는 다릅니다.
  • exec는 자신의 머신이나 노드에서 셸 명령을 실행합니다
  • code_execution은 xAI의 원격 샌드박스에서 Python을 실행합니다
code_execution은 다음 용도로 사용하세요.
  • 계산
  • 표 작성
  • 빠른 통계
  • 차트 스타일 분석
  • x_search 또는 web_search가 반환한 데이터 분석
로컬 파일, 자신의 셸, 자신의 리포지토리 또는 페어링된 기기가 필요할 때는 사용하지 마세요. 그럴 때는 exec를 사용하세요.

설정

xAI API 키가 필요합니다. 다음 중 아무 것이나 사용할 수 있습니다.
  • XAI_API_KEY
  • plugins.entries.xai.config.webSearch.apiKey
예시:
{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...",
          },
          codeExecution: {
            enabled: true,
            model: "grok-4-1-fast",
            maxTurns: 2,
            timeoutSeconds: 30,
          },
        },
      },
    },
  },
}

사용 방법

자연스럽게 요청하되 분석 의도를 명확히 표현하세요.
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 매개변수를 사용하므로, 에이전트는 전체 분석 요청과 모든 인라인 데이터를 하나의 프롬프트로 보내야 합니다.

제한 사항

  • 이것은 로컬 프로세스 실행이 아니라 원격 xAI 실행입니다.
  • 지속적인 노트북이 아니라 일시적인 분석으로 취급해야 합니다.
  • 로컬 파일이나 자신의 워크스페이스에 접근할 수 있다고 가정하지 마세요.
  • 최신 X 데이터를 사용하려면 먼저 x_search를 사용하세요.

함께 보기