---
read_when:
- code_execution を有効化または設定しようとしています
- ローカルシェルへのアクセスなしでリモート分析を行いたい場合
- x_search または web_search をリモート Python 分析と組み合わせたい場合
summary: 'code_execution: xAIを使用してサンドボックス化されたリモートPython分析を実行する'
title: コード実行
x-i18n:
generated_at: "2026-07-11T22:46:20Z"
model: gpt-5.6
postprocess_version: locale-links-v1
provider: openai
source_hash: 1ab391daed9154f113535e6d241c45d5c08c22abdc012148a9f0f2ae5ec548b3
source_path: tools/code-execution.md
workflow: 16
---
`code_execution` は xAI の Responses API
（`https://api.x.ai/v1/responses`、`x_search` が使用するものと同じエンドポイント）上で、サンドボックス化されたリモート Python 分析を実行します。これは、バンドルされている `xai` Plugin によって `tools` コントラクト配下に登録されます。
`code_execution` は xAI のサーバー上で実行されます。xAI の料金はツール呼び出し 1,000 回あたり 5 ドルで、これにモデルの入力トークンと出力トークンの料金が加算されます。
| プロパティ | 値 |
| ------------------ | --------------------------------------------------------------------------------- |
| ツール名 | `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`](/ja-JP/tools/web#x_search) を実行し、その結果を渡してください。
ローカルで実行する場合は、代わりに [`exec`](/ja-JP/tools/exec) を使用してください。
## セットアップ
OAuth には、対象となる SuperGrok または X Premium サブスクリプションが必要です（デバイスコード検証を使用するため、localhost コールバックなしでリモートホストから利用できます）。
```bash
openclaw models auth login --provider xai --method oauth
```
新規インストール時は、オンボーディングでも同じ選択肢を利用できます。
```bash
openclaw onboard --install-daemon --auth-choice xai-oauth
```
または API キーを使用します。
```bash
openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...
```
または設定で指定します。
```json5
{
plugins: {
entries: {
xai: {
config: {
webSearch: {
apiKey: "xai-...",
},
},
},
},
},
}
```
これら 3 つの方法はいずれも、`x_search` と Grok の `web_search` にも使用されます。
`enabled` を省略した場合、`code_execution` が公開されるのは、アクティブなモデルのプロバイダーが `xai` で、かつ xAI 認証情報を解決できる場合のみです。アクティブなモデルのプロバイダーが xAI 以外であることが判明している場合、プロバイダーをまたいで使用するには `plugins.entries.xai.config.codeExecution.enabled` を `true` に設定して明示的に有効化します。アクティブなモデルのプロバイダーが指定されていないか解決できない場合、ツールは非表示のままです。すべてのプロバイダーで無効化するには、`enabled` を `false` に設定します。xAI 認証情報は常に必要です。
同じブロックを使用して、モデル、ターン上限、タイムアウトを上書きできます。
```json5
{
plugins: {
entries: {
xai: {
config: {
codeExecution: {
enabled: true, // xAI 以外の既知のモデルプロバイダーでは必須
model: "grok-4.3", // デフォルトの xAI コード実行モデルを上書き
maxTurns: 2, // 内部ツールターン数の任意の上限
timeoutSeconds: 30, // リクエストタイムアウト（デフォルト: 30）
},
},
},
},
},
}
```
```bash
openclaw gateway restart
```
xAI Plugin が再登録され、上記のプロバイダー、有効化、認証の各チェックに合格すると、`code_execution` がエージェントのツール一覧に表示されます。
## 使用方法
分析の意図を明示してください。このツールが受け取るパラメーターは 1 つの `task` のみなので、リクエスト全体とインラインデータを 1 つのプロンプトで送信します。
```text
code_execution を使用して、次の数値の 7 日移動平均を計算してください: ...
```
```text
x_search を使用して今週 OpenClaw に言及した投稿を検索し、次に code_execution を使用して日別に集計してください。
```
```text
web_search を使用して最新の AI ベンチマーク数値を収集し、次に code_execution を使用して変化率を比較してください。
```
## エラー
認証がない場合、ツールはスローされた例外ではなく構造化された JSON エラーを返すため、エージェントは自己修正できます。
```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"
}
```
## 関連項目
自分のマシンまたはペアリング済み Node 上でのローカルシェル実行。
シェル実行を許可または拒否するポリシー。
`web_search`、`x_search`、`web_fetch`。
Grok モデル、Web/X 検索、コード実行の設定。