Tools
การเรียกใช้โค้ด
code_execution เรียกใช้การวิเคราะห์ด้วย Python แบบระยะไกลในแซนด์บ็อกซ์ผ่าน Responses API ของ xAI
(https://api.x.ai/v1/responses ซึ่งเป็นปลายทางเดียวกับที่ x_search ใช้) เครื่องมือนี้
ลงทะเบียนโดย Plugin xai ที่รวมมาให้ภายใต้สัญญา tools
| คุณสมบัติ | ค่า |
|---|---|
| ชื่อเครื่องมือ | code_execution |
| Plugin ผู้ให้บริการ | xai (รวมมาให้, enabledByDefault: true) |
| การยืนยันตัวตน | โปรไฟล์การยืนยันตัวตน xAI, XAI_API_KEY หรือ plugins.entries.xai.config.webSearch.apiKey |
| โมเดลเริ่มต้น | grok-4.3 |
| ระยะหมดเวลาเริ่มต้น | 30 วินาที |
maxTurns เริ่มต้น |
ไม่ได้กำหนด (xAI ใช้ขีดจำกัดภายในของตนเอง) |
ใช้เครื่องมือนี้สำหรับการคำนวณ การจัดข้อมูลเป็นตาราง สถิติอย่างรวดเร็ว และการวิเคราะห์
ในรูปแบบแผนภูมิ รวมถึงข้อมูลที่ส่งคืนโดย x_search หรือ web_search เครื่องมือนี้ไม่สามารถ
เข้าถึงไฟล์ในเครื่อง เชลล์ของคุณ ที่เก็บโค้ดของคุณ หรืออุปกรณ์ที่จับคู่ไว้ และจะไม่
เก็บสถานะระหว่างการเรียกใช้ ดังนั้นให้ถือว่าการเรียกใช้แต่ละครั้งเป็นการวิเคราะห์ชั่วคราว ไม่ใช่
เซสชันสมุดบันทึก สำหรับข้อมูล 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 และ web_search ของ Grok ได้ด้วย
Enable and tune 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) }, }, }, }, },}Restart the Gateway
openclaw gateway restartcode_execution จะปรากฏในรายการเครื่องมือของเอเจนต์เมื่อ Plugin xAI
ลงทะเบียนใหม่ และผ่านการตรวจสอบผู้ให้บริการ การเปิดใช้งาน และการยืนยันตัวตนข้างต้น
วิธีใช้งาน
ระบุเจตนาของการวิเคราะห์ให้ชัดเจน เครื่องมือรับพารามิเตอร์ 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"}