การเรียกใช้โค้ด

code_execution รันการวิเคราะห์ Python ระยะไกลแบบ sandboxed บน Responses API ของ xAI โดยลงทะเบียนผ่าน Plugin xai ที่รวมมาให้ (ภายใต้สัญญา tools) และส่งต่อไปยัง endpoint https://api.x.ai/v1/responses เดียวกับที่ x_search ใช้

สิ่งนี้แตกต่างจาก exec แบบ local:

• exec รันคำสั่ง shell บนเครื่องของคุณหรือ node ที่จับคู่ไว้
• code_execution รัน Python ใน sandbox ระยะไกลของ xAI

ใช้ code_execution สำหรับ:

• การคำนวณ
• การจัดทำตาราง
• สถิติอย่างรวดเร็ว
• การวิเคราะห์รูปแบบแผนภูมิ
• การวิเคราะห์ข้อมูลที่ส่งกลับมาจาก x_search หรือ web_search

อย่า ใช้เมื่อคุณต้องการไฟล์ local, shell ของคุณ, repo ของคุณ หรืออุปกรณ์ที่จับคู่ไว้ ให้ใช้ exec สำหรับกรณีนั้น

การตั้งค่า

export XAI_API_KEY=xai-...

{  plugins: {    entries: {      xai: {        config: {          webSearch: {            apiKey: "xai-...",          },        },      },    },  },}

{  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)          },        },      },    },  },}

openclaw gateway restart

วิธีใช้งาน

ถามอย่างเป็นธรรมชาติและระบุเจตนาการวิเคราะห์ให้ชัดเจน:

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 เพียงตัวเดียวภายใน ดังนั้น agent ควรส่งคำขอวิเคราะห์แบบเต็มและข้อมูล inline ใด ๆ ใน prompt เดียว

ข้อผิดพลาด

เมื่อเครื่องมือรันโดยไม่มี auth เครื่องมือจะส่งคืนข้อผิดพลาด missing_xai_api_key แบบมีโครงสร้าง ซึ่งชี้ไปยังตัวเลือก auth-profile, env var และ config ข้อผิดพลาดเป็น JSON ไม่ใช่ exception ที่ถูก throw ดังนั้น agent จึงสามารถแก้ไขเองได้:

{  "error": "missing_xai_api_key",  "message": "code_execution needs an xAI API key. 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 ไม่ใช่การประมวลผล process แบบ local
• ถือว่าผลลัพธ์เป็นการวิเคราะห์ชั่วคราว ไม่ใช่ session notebook ถาวร
• อย่าสันนิษฐานว่ามีสิทธิ์เข้าถึงไฟล์ local หรือ workspace ของคุณ
• สำหรับข้อมูล X ใหม่ ให้ใช้ x_search ก่อน แล้วส่งผลลัพธ์เข้าไปยัง code_execution

ที่เกี่ยวข้อง