代码执行

code_execution 在 xAI 的 Responses API 上运行沙箱化的远程 Python 分析（https://api.x.ai/v1/responses，与 x_search 使用相同的端点）。它由捆绑的 xai 插件在 tools 契约下注册。

Warning

code_execution 在 xAI 的服务器上运行。xAI 按每 1,000 次工具调用 5 美元计费，外加模型的输入和输出 Token。

属性	值
工具名称	`code_execution`
提供商插件	`xai`（内置，`enabledByDefault: true`）
身份验证	xAI 身份验证配置、`XAI_API_KEY` 或 `plugins.entries.xai.config.webSearch.apiKey`
默认模型	`grok-4.7`
默认超时	30 秒
默认 `maxTurns`	未设置（xAI 会应用其自身的内部限制）

省略工具模型设置的现有安装也会使用 Grok 4.7。显式模型设置仍会被选中。

将其用于计算、制表、快速统计和图表式分析，包括 x_search 或 web_search 返回的数据。它无法访问本地文件、你的 shell、你的仓库或配对设备，并且不会在调用之间持久化状态，因此请将每次调用视为临时分析，而不是 notebook 会话。对于最新的 X 数据，请先运行 x_search 并将结果传入。

对于本地执行，请改用 exec。

设置¶

1. 提供 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-key
export XAI_API_KEY=xai-...

或通过配置：

{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...",
          },
        },
      },
    },
  },
}

以上三种方式中的任何一种也可为 x_search 和 Grok web_search 提供支持。

2. 启用并调整 code_execution

如果省略 enabled，则只有当活动模型的提供商为 xai 且 xAI 凭据可解析时，才会暴露 code_execution。对于具有已知非 xAI 提供商的活动模型，请将 plugins.entries.xai.config.codeExecution.enabled 设置为 true，以选择跨提供商使用。如果活动模型提供商缺失或无法解析，该工具将保持隐藏。将 enabled 设置为 false 可针对所有提供商禁用它。始终需要 xAI 凭据。

使用同一配置块来覆盖模型、轮次上限或超时：

{
  plugins: {
    entries: {
      xai: {
        config: {
          codeExecution: {
            enabled: true, // required for a known non-xAI model provider
            model: "grok-4.3", // override the default xAI code-execution model
            maxTurns: 2,            // optional cap on internal tool turns
            timeoutSeconds: 30,     // request timeout (default: 30)
          },
        },
      },
    },
  },
}

3. 验证工具可用性

在默认的混合重载模式下，插件配置更改会自动生效。如果 Gateway 处于离线状态，请在配置后启动它。参见配置热重载。

在目标对话中发送 /tools，并在上述提供商、启用状态和身份验证检查通过后检查 code_execution。如果你更改了 Gateway 服务的进程环境，请重启该服务以加载它。

如何使用¶

明确分析意图；该工具只接受一个 task 参数，因此请在一条提示中发送完整请求和任何内联数据：

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.

错误¶

在没有身份验证的情况下，该工具会返回结构化 JSON 错误（而不是抛出异常），因此代理可以自我纠正：

{
  "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"
}