Thực thi mã

code_execution chạy phân tích Python từ xa trong sandbox trên Responses API của xAI. Công cụ này được đăng ký bởi Plugin xai được đóng gói kèm (theo hợp đồng tools) và gửi đến cùng endpoint https://api.x.ai/v1/responses mà x_search sử dụng.

Công cụ này khác với exec cục bộ:

• exec chạy lệnh shell trên máy của bạn hoặc node đã ghép nối.
• code_execution chạy Python trong sandbox từ xa của xAI.

Dùng code_execution cho:

• Tính toán.
• Lập bảng.
• Thống kê nhanh.
• Phân tích kiểu biểu đồ.
• Phân tích dữ liệu do x_search hoặc web_search trả về.

Không dùng công cụ này khi bạn cần tệp cục bộ, shell, repo hoặc thiết bị đã ghép nối. Hãy dùng exec cho việc đó.

# Thiết lập

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

# Cách sử dụng

Hãy hỏi tự nhiên và nêu rõ mục đích phân tích:

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.

Công cụ này nhận nội bộ một tham số task, vì vậy tác nhân nên gửi đầy đủ yêu cầu phân tích và mọi dữ liệu nội tuyến trong một lời nhắc.

# Lỗi

Khi công cụ chạy mà không có xác thực, nó trả về lỗi có cấu trúc missing_xai_api_key trỏ đến biến môi trường và đường dẫn cấu hình. Lỗi là JSON, không phải ngoại lệ được ném ra, nên tác nhân có thể tự sửa:

{
  "error": "missing_xai_api_key",
  "message": "code_execution needs an 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"
}

# Giới hạn

• Đây là thực thi từ xa của xAI, không phải thực thi tiến trình cục bộ.
• Xem kết quả là phân tích tạm thời, không phải một phiên notebook liên tục.
• Đừng giả định có quyền truy cập vào tệp cục bộ hoặc workspace của bạn.
• Để có dữ liệu X mới, trước tiên hãy dùng x_search rồi chuyển kết quả vào code_execution.

# Liên quan