快速开始
代码执行
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。
设置
Provide xAI credentials
使用符合条件的 SuperGrok 或 X Premium 订阅通过 Grok OAuth 登录，
或存储一个 API key。xAI OAuth 使用设备码验证，因此它可以在没有
localhost 回调的远程主机上工作。OAuth 适用于
code_execution 和 x_search；XAI_API_KEY 或插件 Web 搜索配置
也可以驱动 Grok web_search。
openclaw models auth login --provider xai --method oauth在全新安装期间，相同的凭证选项也可在新手引导中使用：
openclaw onboard --install-daemonopenclaw onboard --install-daemon --auth-choice xai-oauth或使用 API key：
openclaw models auth login --provider xai --method api-keyexport XAI_API_KEY=xai-...或通过配置：
{ plugins: { entries: { xai: { config: { webSearch: { apiKey: "xai-...", }, }, }, }, },}Enable and tune code_execution
当 xAI 凭证可用时，code_execution 就可用。将
plugins.entries.xai.config.codeExecution.enabled 设置为 false 可禁用它，
或使用同一配置块调整模型和超时。
{ 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) }, }, }, }, },}Restart the Gateway
openclaw gateway restartxAI 插件以 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 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"}限制
- 这是远程 xAI 执行，不是本地进程执行。
- 将结果视为临时分析，而不是持久化的 notebook 会话。
- 不要假设可以访问本地文件或你的工作区。
- 对于新的 X 数据，请先使用
x_search，并将结果传入code_execution。
