跳转至

代码执行

code_execution 在 xAI 的 Responses API(https://api.x.ai/v1/responses,与 x_search 使用同一端点)上运行沙箱化的远程 Python 分析。它由内置的 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、您的仓库或配对设备,并且在调用之间不会持久化状态,因此请将每次调用视为临时分析,而非笔记本会话。要获取最新的 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 时,code_execution 仅在活动模型的提供商为 xai 且 xAI 凭据可解析时暴露。对于提供商为已知非 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"
}

Exec 工具

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

Exec 审批

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

Web 工具

web_search、x_search 和 web_fetch。

xAI 提供商

Grok 模型、web/x 搜索和代码执行配置。

代码模式

一个独立的功能面:在 OpenClaw 自己的 worker 中使用 JavaScript 编排已启用的工具,而非这个远程 Python 工具。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw