> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# 代码执行
`code_execution` 在 xAI 的 Responses API 上运行沙箱隔离的远程 Python 分析
（`https://api.x.ai/v1/responses`，与 `x_search` 使用相同端点）。它由内置 `xai` 插件在 `tools` 合约下注册。
| 属性 | 值 |
| ------------- | ------------------------------------------------------------------------ |
| 工具名称 | `code_execution` |
| 提供商插件 | `xai`（内置，`enabledByDefault: true`） |
| 凭证 | xAI 凭证配置文件、`XAI_API_KEY` 或 `plugins.entries.xai.config.webSearch.apiKey` |
| 默认模型 | `grok-4-1-fast` |
| 默认超时 | 30 秒 |
| 默认 `maxTurns` | 未设置（xAI 会应用自己的内部限制） |
可将它用于计算、制表、快速统计和图表式分析，包括分析 `x_search` 或 `web_search` 返回的数据。它无法访问本地文件、你的 shell、你的仓库或已配对设备，也不会在调用之间持久化状态，因此应将每次调用视为临时分析，而不是 notebook 会话。对于新的 X 数据，请先运行 [`x_search`](/zh-CN/tools/web#x_search)，再将结果传入。
本地执行请改用 [`exec`](/zh-CN/tools/exec)。
## 设置
OAuth 需要符合条件的 SuperGrok 或 X Premium 订阅
（设备代码验证，因此可在没有 localhost 回调的远程主机上使用）：
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models auth login --provider xai --method oauth
```
全新安装期间，新手引导中也提供相同选项：
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --install-daemon --auth-choice xai-oauth
```
或使用 API key：
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models auth login --provider xai --method api-key
export XAI_API_KEY=xai-...
```
或通过配置：
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
plugins: {
entries: {
xai: {
config: {
webSearch: {
apiKey: "xai-...",
},
},
},
},
},
}
```
这三种方式也都可驱动 `x_search` 和 Grok `web_search`。
只要 xAI 凭证可解析，`code_execution` 就可用。将
`plugins.entries.xai.config.codeExecution.enabled` 设为 `false` 可禁用它，或使用同一个块覆盖模型、轮次上限或超时：
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
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)
},
},
},
},
},
}
```
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw gateway restart
```
xAI 插件以 `enabled: true` 重新注册后，`code_execution` 会出现在智能体的工具列表中。
## 使用方式
明确说明分析意图；该工具接受单个 `task` 参数，因此请在一个提示中发送完整请求和任何内联数据：
```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
Use code_execution to calculate the 7-day moving average for these numbers: ...
```
```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
Use x_search to find posts mentioning OpenClaw this week, then use code_execution to count them by day.
```
```text theme={"theme":{"light":"min-light","dark":"min-dark"}}
Use web_search to gather the latest AI benchmark numbers, then use code_execution to compare percent changes.
```
## 错误
没有凭证时，该工具会返回结构化 JSON 错误（而不是抛出异常），因此智能体可以自行纠正：
```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
"error": "missing_xai_api_key",
"message": "code_execution needs xAI credentials. Run `openclaw onboard --auth-choice xai-oauth` to sign in with Grok, 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"
}
```
## 相关
在你的机器或已配对节点上执行本地 shell。
shell 执行的允许/拒绝策略。
`web_search`、`x_search` 和 `web_fetch`。
Grok 模型、web/x 搜索和代码执行配置。