Tools

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 đi kèm (theo hợp đồng tools) và chuyển tiếp đến cùng endpoint https://api.x.ai/v1/responses mà x_search sử dụng.

Thuộc tính	Giá trị
Tên công cụ	`code_execution`
Plugin nhà cung cấp	`xai` (đi kèm, `enabledByDefault: true`)
Xác thực	hồ sơ xác thực xAI, `XAI_API_KEY`, hoặc `plugins.entries.xai.config.webSearch.apiKey`
Mô hình mặc định	`grok-4-1-fast`
Thời gian chờ mặc định	30 giây
`maxTurns` mặc định	chưa đặt (xAI áp dụng giới hạn nội bộ riê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 nút được 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 của bạn, repo của bạn hoặc thiết bị được ghép nối. Hãy dùng exec cho việc đó.

Thiết lập

Cung cấp thông tin xác thực xAI

Đăng nhập bằng Grok OAuth với gói đăng ký SuperGrok hoặc X Premium đủ điều kiện, hoặc lưu trữ khóa API. xAI OAuth dùng xác minh bằng mã thiết bị, nên hoạt động từ máy chủ từ xa mà không cần callback localhost. OAuth hoạt động cho code_execution và x_search; XAI_API_KEY hoặc cấu hình web-search của plugin cũng có thể cấp quyền cho Grok web_search.

bash

openclaw models auth login --provider xai --method oauth

Trong lần cài đặt mới, các lựa chọn xác thực tương tự có sẵn trong quy trình onboarding:

bash

openclaw onboard --install-daemonopenclaw onboard --install-daemon --auth-choice xai-oauth

Hoặc dùng khóa API:

bash

openclaw models auth login --provider xai --method api-keyexport XAI_API_KEY=xai-...

Hoặc qua cấu hình:

json5

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

Bật và tinh chỉnh code_execution

code_execution khả dụng khi thông tin xác thực xAI khả dụng. Đặt plugins.entries.xai.config.codeExecution.enabled thành false để tắt, hoặc dùng cùng khối này để tinh chỉnh mô hình và thời gian chờ.

json5

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

Khởi động lại Gateway

bash

openclaw gateway restart

code_execution xuất hiện trong danh sách công cụ của agent sau khi plugin xAI đăng ký lại với enabled: true.

Cách sử dụng

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

text

Use code_execution to calculate the 7-day moving average for these numbers: ...

text

Use x_search to find posts mentioning OpenClaw this week, then use code_execution to count them by day.

text

Use web_search to gather the latest AI benchmark numbers, then use code_execution to compare percent changes.

Công cụ này nội bộ nhận một tham số task, nên agent nên gửi toàn bộ yêu cầu phân tích và mọi dữ liệu nội tuyến trong một prompt.

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 các tùy chọn hồ sơ xác thực, biến môi trường và cấu hình. Lỗi ở dạng JSON, không phải ngoại lệ được ném ra, nên agent có thể tự sửa:

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"}

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 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.
Với 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.