快速开始
代码执行
code_execution 通过 xAI 的 Responses API
（https://api.x.ai/v1/responses，与 x_search 使用相同端点）运行沙箱隔离的远程 Python 分析。它由内置的 xai 插件根据 tools 契约注册。
| 属性 | 值 |
|---|---|
| 工具名称 | code_execution |
| 提供商插件 | xai（内置，enabledByDefault: true） |
| 身份验证 | xAI 身份验证配置文件、XAI_API_KEY 或 plugins.entries.xai.config.webSearch.apiKey |
| 默认模型 | grok-4.3 |
| 默认超时时间 | 30 秒 |
默认 maxTurns |
未设置（xAI 应用其自身的内部限制） |
可将它用于计算、制表、快速统计和图表式分析，包括分析 x_search 或 web_search 返回的数据。它无法访问本地文件、你的 shell、你的仓库或已配对设备，并且不会在调用之间持久保存状态，因此应将每次调用视为临时分析，而不是笔记本会话。如需最新的 X 数据，请先运行 x_search，然后将结果传入。
如需本地执行，请改用 exec。
设置
Provide xAI credentials
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-keyexport XAI_API_KEY=xai-...或通过配置：
{ plugins: { entries: { xai: { config: { webSearch: { apiKey: "xai-...", }, }, }, }, },}以上三种方式中的任一种也可为 x_search 和 Grok web_search 提供支持。
Enable and tune 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) }, }, }, }, },}Restart the Gateway
openclaw gateway restartxAI 插件重新注册后，如果上述提供商、启用状态和身份验证检查均通过，code_execution 就会出现在智能体的工具列表中。
使用方法
请明确说明分析意图；该工具只接受一个 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"}