Tools
程式碼執行
code_execution 會在 xAI 的 Responses API 上執行沙箱化的遠端 Python 分析
（https://api.x.ai/v1/responses，與 x_search 使用相同端點）。它由內建的 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。
設定
提供 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-keyexport XAI_API_KEY=xai-...或透過設定：
{ plugins: { entries: { xai: { config: { webSearch: { apiKey: "xai-...", }, }, }, }, },}這三種方式都能同時支援 x_search 和 Grok web_search。
啟用並調整 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, // 已知的非 xAI 模型提供者必須設定此項 model: "grok-4.3", // 覆寫預設的 xAI 程式碼執行模型 maxTurns: 2, // 選用的內部工具回合上限 timeoutSeconds: 30, // 要求逾時（預設：30） }, }, }, }, },}重新啟動閘道
openclaw gateway restart當 xAI 外掛重新註冊，且上述提供者、啟用狀態與驗證檢查均通過後，
code_execution 就會出現在代理程式的工具清單中。
使用方式
請明確說明分析意圖；此工具只接受單一 task 參數，
因此請在同一個提示中送出完整要求及所有行內資料：
使用 code_execution 計算這些數字的 7 日移動平均值：...使用 x_search 尋找本週提及 OpenClaw 的貼文，然後使用 code_execution 按日期統計數量。使用 web_search 收集最新的 AI 基準測試數據，然後使用 code_execution 比較百分比變化。錯誤
缺少驗證時，此工具會傳回結構化 JSON 錯誤（而非擲回例外）， 讓代理程式能自行修正：
{ "error": "missing_xai_api_key", "message": "code_execution 需要 xAI 憑證。請執行 `openclaw onboard --auth-choice xai-oauth` 以使用 Grok 登入、執行 `openclaw onboard --auth-choice xai-api-key`、在閘道環境中設定 `XAI_API_KEY`，或設定 `plugins.entries.xai.config.webSearch.apiKey`。", "docs": "https://docs.openclaw.ai/tools/code-execution"}