메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

code_execution은 xAI의 Responses API에서 샌드박스된 원격 Python 분석을 실행합니다. 번들 xai Plugin(tools 계약 아래)에 의해 등록되며, x_search가 사용하는 동일한 https://api.x.ai/v1/responses 엔드포인트로 디스패치됩니다.
속성값
도구 이름code_execution
Provider Pluginxai(번들, enabledByDefault: true)
인증xAI 인증 프로필, XAI_API_KEY 또는 plugins.entries.xai.config.webSearch.apiKey
기본 모델grok-4-1-fast
기본 타임아웃30초
기본 maxTurns설정되지 않음(xAI가 자체 내부 한도를 적용)
이는 로컬 exec와 다릅니다.
  • exec는 사용자의 머신 또는 페어링된 Node에서 셸 명령을 실행합니다.
  • code_execution은 xAI의 원격 샌드박스에서 Python을 실행합니다.
다음 용도로 code_execution을 사용하세요.
  • 계산.
  • 표 작성.
  • 빠른 통계.
  • 차트식 분석.
  • x_search 또는 web_search가 반환한 데이터 분석.
로컬 파일, 셸, 저장소 또는 페어링된 기기가 필요할 때는 사용하지 마세요. 그런 경우에는 exec를 사용하세요.

​
설정

1

xAI API 키 제공

code_execution 및 x_search에 대해 openclaw onboard --auth-choice xai-api-key를 실행하거나, Grok 웹 검색도 동일한 자격 증명을 사용하게 하려면 XAI_API_KEY를 설정하거나 xAI Plugin 아래에 키를 구성하세요.
export XAI_API_KEY=xai-...
또는 설정을 통해 구성합니다.
{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...",
          },
        },
      },
    },
  },
}
2

code_execution 활성화 및 조정

이 도구는 plugins.entries.xai.config.codeExecution.enabled로 게이트됩니다. 기본값은 꺼짐입니다.
{
  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)
          },
        },
      },
    },
  },
}
3

Gateway 재시작

openclaw gateway restart
xAI Plugin이 enabled: true로 다시 등록되면 code_execution이 에이전트의 도구 목록에 표시됩니다.

​
사용 방법

자연스럽게 요청하되 분석 의도를 명확히 밝히세요. 
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으로 전달하세요.

​
관련 항목

Exec 도구

사용자의 머신 또는 페어링된 Node에서 로컬 셸 실행.

Exec 승인

셸 실행에 대한 허용/거부 정책.

Web 도구

web_search, x_search, web_fetch.

xAI Provider

Grok 모델, 웹/X 검색, 코드 실행 설정.