Code Execution 工具（远程沙箱 Python 执行）

概述

code_execution 工具通过 xAI 的 Responses API 在远程沙箱中运行 Python 分析任务。由内置 xai 插件注册，与 x_search 共用同一 API 端点。与本地 exec 工具不同，它在 xAI 的远程沙箱中执行，无法访问本地文件或 Shell。

适用场景：计算、制表、统计分析、图表分析、分析 x_search/web_search 返回的数据。

不适用场景：需要本地文件、Shell、代码仓库或配对设备时，应使用 exec。

核心功能

属性	值
工具名	code_execution
提供插件	xai（内置，默认启用）
认证	xAI auth profile / XAI_API_KEY / 插件配置
默认模型	grok-4-1-fast
默认超时	30 秒

• 单参数接口：工具接受单个 task 参数，Agent 将完整分析请求和内联数据一次性发送
• 结构化错误：缺少 API key 时返回 JSON 格式的 missing_xai_api_key 错误，Agent 可自我纠正
• 结果为临时性：不是持久化 notebook 会话，每次调用独立

配置/权限

启用步骤：

export XAI_API_KEY=xai-...
openclaw gateway restart

配置示例：

{
  plugins: {
    entries: {
      xai: {
        config: {
          codeExecution: {
            enabled: true,
            model: "grok-4-1-fast",
            maxTurns: 2,
            timeoutSeconds: 30
          }
        }
      }
    }
  }
}

默认关闭（plugins.entries.xai.config.codeExecution.enabled 默认为 false），需显式启用。

相关页面

• tool-exec — 本地 Shell 执行工具
• tool-exec-approvals — exec 审批策略