Tools
コード実行
code_execution は xAI の Responses API
（https://api.x.ai/v1/responses、x_search が使用するものと同じエンドポイント）上で、サンドボックス化されたリモート Python 分析を実行します。これは、バンドルされている xai Plugin によって tools コントラクト配下に登録されます。
| プロパティ | 値 |
|---|---|
| ツール名 | code_execution |
| プロバイダー Plugin | xai（バンドル済み、enabledByDefault: true） |
| 認証 | xAI 認証プロファイル、XAI_API_KEY、または plugins.entries.xai.config.webSearch.apiKey |
| デフォルトモデル | grok-4.3 |
| デフォルトタイムアウト | 30 秒 |
デフォルトの maxTurns |
未設定（xAI 独自の内部上限が適用されます） |
計算、表作成、簡単な統計、グラフ形式の分析に使用できます。これには、x_search または web_search が返したデータの分析も含まれます。ローカルファイル、シェル、リポジトリ、ペアリング済みデバイスにはアクセスできず、呼び出し間で状態も保持されません。そのため、各呼び出しはノートブックセッションではなく、一時的な分析として扱ってください。最新の X データを使用する場合は、まず x_search を実行し、その結果を渡してください。
ローカルで実行する場合は、代わりに exec を使用してください。
セットアップ
xAI 認証情報を指定する
OAuth には、対象となる SuperGrok または X Premium サブスクリプションが必要です（デバイスコード検証を使用するため、localhost コールバックなしでリモートホストから利用できます）。
openclaw models auth login --provider xai --method oauth新規インストール時は、オンボーディングでも同じ選択肢を利用できます。
openclaw onboard --install-daemon --auth-choice xai-oauthまたは API キーを使用します。
openclaw models auth login --provider xai --method api-keyexport XAI_API_KEY=xai-...または設定で指定します。
{ plugins: { entries: { xai: { config: { webSearch: { apiKey: "xai-...", }, }, }, }, },}これら 3 つの方法はいずれも、x_search と Grok の web_search にも使用されます。
code_execution を有効化して調整する
enabled を省略した場合、code_execution が公開されるのは、アクティブなモデルのプロバイダーが xai で、かつ xAI 認証情報を解決できる場合のみです。アクティブなモデルのプロバイダーが xAI 以外であることが判明している場合、プロバイダーをまたいで使用するには plugins.entries.xai.config.codeExecution.enabled を true に設定して明示的に有効化します。アクティブなモデルのプロバイダーが指定されていないか解決できない場合、ツールは非表示のままです。すべてのプロバイダーで無効化するには、enabled を false に設定します。xAI 認証情報は常に必要です。
同じブロックを使用して、モデル、ターン上限、タイムアウトを上書きできます。
{ plugins: { entries: { xai: { config: { codeExecution: { enabled: true, // xAI 以外の既知のモデルプロバイダーでは必須 model: "grok-4.3", // デフォルトの xAI コード実行モデルを上書き maxTurns: 2, // 内部ツールターン数の任意の上限 timeoutSeconds: 30, // リクエストタイムアウト（デフォルト: 30） }, }, }, }, },}Gateway を再起動する
openclaw gateway restartxAI Plugin が再登録され、上記のプロバイダー、有効化、認証の各チェックに合格すると、code_execution がエージェントのツール一覧に表示されます。
使用方法
分析の意図を明示してください。このツールが受け取るパラメーターは 1 つの task のみなので、リクエスト全体とインラインデータを 1 つのプロンプトで送信します。
code_execution を使用して、次の数値の 7 日移動平均を計算してください: ...x_search を使用して今週 OpenClaw に言及した投稿を検索し、次に code_execution を使用して日別に集計してください。web_search を使用して最新の AI ベンチマーク数値を収集し、次に code_execution を使用して変化率を比較してください。エラー
認証がない場合、ツールはスローされた例外ではなく構造化された JSON エラーを返すため、エージェントは自己修正できます。
{ "error": "missing_xai_api_key", "message": "code_execution には xAI 認証情報が必要です。Grok でサインインするには `openclaw onboard --auth-choice xai-oauth` を実行し、`openclaw onboard --auth-choice xai-api-key` を実行するか、Gateway 環境に `XAI_API_KEY` を設定するか、`plugins.entries.xai.config.webSearch.apiKey` を構成してください。", "docs": "https://docs.openclaw.ai/tools/code-execution"}