コード実行

code_execution は、xAI の Responses API 上でサンドボックス化されたリモート Python 分析を実行します。これはバンドルされた xai Plugin（tools contract の下）によって登録され、x_search が使用するものと同じ https://api.x.ai/v1/responses endpoint にディスパッチされます。

これはローカルの exec とは異なります。

• exec は、あなたのマシンまたはペアリングされたノードで shell commands を実行します。
• code_execution は、xAI のリモートサンドボックス内で Python を実行します。

code_execution は次の用途に使用します。

• 計算。
• 表作成。
• 簡単な統計。
• チャート形式の分析。
• x_search または web_search から返されたデータの分析。

ローカルファイル、shell、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 code-execution モデルを上書き
            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 パラメーターを受け取るため、エージェントは完全な分析リクエストと任意のインラインデータを 1 つのプロンプトで送信する必要があります。

# エラー

このツールが認証なしで実行されると、env var と config path を指す構造化された missing_xai_api_key エラーを返します。このエラーは JSON であり、throw された例外ではないため、エージェントは自己修正できます。

{
  "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 実行であり、ローカルプロセス実行ではありません。
• 結果は永続的なノートブックセッションではなく、一時的な分析として扱います。
• ローカルファイルや workspace へのアクセスを前提にしないでください。
• 新しい X データには、まず x_search を使用し、その結果を code_execution に渡します。

# 関連