Skip to main content

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 分析。它由内置的 xai 插件注册（位于 tools 合约下），并分派到 x_search 使用的同一个 https://api.x.ai/v1/responses 端点。
属性值
工具名称code_execution
提供商插件xai（内置，enabledByDefault: true）
凭证xAI 凭证配置文件、XAI_API_KEY，或 plugins.entries.xai.config.webSearch.apiKey
默认模型grok-4-1-fast
默认超时30 秒
默认 maxTurns未设置（xAI 会应用自己的内部限制）
这不同于本地 exec：
  • exec 会在你的机器或已配对节点上运行 shell 命令。
  • code_execution 会在 xAI 的远程沙箱中运行 Python。
将 code_execution 用于：
  • 计算。
  • 制表。
  • 快速统计。
  • 图表式分析。
  • 分析 x_search 或 web_search 返回的数据。
当你需要本地文件、你的 shell、你的仓库或已配对设备时，不要使用它。请为此使用 exec。

​
设置

1

提供 xAI API key

为 code_execution 和 x_search 运行 openclaw onboard --auth-choice xai-api-key， 或设置 XAI_API_KEY / 在 xAI 插件下配置密钥， 当你也想让 Grok Web 搜索使用同一个凭据时：
export XAI_API_KEY=xai-...
或通过配置：
{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...",
          },
        },
      },
    },
  },
}
2

启用并调优 code_execution

该工具受 plugins.entries.xai.config.codeExecution.enabled 控制。默认关闭。
{
  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)
          },
        },
      },
    },
  },
}
3

重启 Gateway 网关

openclaw gateway restart
一旦 xAI 插件使用 enabled: true 重新注册，code_execution 就会显示在智能体的工具列表中。

​
如何使用

自然地提问，并明确分析意图： 
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.
该工具在内部接受单个 task 参数，因此智能体应在一个提示中发送完整的分析请求和任何内联数据。

​
错误

当工具在没有凭证的情况下运行时，它会返回一个结构化的 missing_xai_api_key 错误，指向凭证配置文件、环境变量和配置选项。该错误是 JSON，而不是抛出的异常，因此智能体可以自行纠正： 
{
  "error": "missing_xai_api_key",
  "message": "code_execution needs an xAI API key. 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"
}

​
限制

  • 这是远程 xAI 执行，不是本地进程执行。
  • 将结果视为临时分析，而不是持久化的 notebook 会话。
  • 不要假定它可以访问本地文件或你的工作区。
  • 对于新的 X 数据，请先使用 x_search，再将结果传入 code_execution。

​
相关

Exec 工具

在你的机器或已配对节点上执行本地 shell。

Exec 审批

shell 执行的允许/拒绝策略。

Web 工具

web_search、x_search 和 web_fetch。

xAI 提供商

Grok 模型、Web/X 搜索和代码执行配置。