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 が表示されます。
使用方法
分析の意図を明示してください。このツールが受け取るパラメーターは task 1 つだけなので、完全なリクエストとインラインデータを 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"}