Tools
Thực thi mã
code_execution chạy phân tích Python từ xa trong môi trường cách ly trên Responses API của xAI
(https://api.x.ai/v1/responses, cùng điểm cuối mà x_search sử dụng). Công cụ này được
Plugin xai đi kèm đăng ký theo hợp đồng tools.
| 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.3 |
| 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) |
Dùng công cụ này cho các phép tính, lập bảng, thống kê nhanh và phân tích
dạng biểu đồ, bao gồm dữ liệu do x_search hoặc web_search trả về. Công cụ
không thể truy cập tệp cục bộ, shell, kho mã nguồn hoặc thiết bị đã ghép nối
của bạn và không duy trì trạng thái giữa các lượt gọi, vì vậy hãy coi mỗi lượt
gọi là một phiên phân tích tạm thời, không phải phiên sổ tay. Để lấy dữ liệu X
mới nhất, trước tiên hãy chạy x_search rồi chuyển kết
quả vào.
Để thực thi cục bộ, hãy dùng exec thay thế.
Thiết lập
Cung cấp thông tin xác thực xAI
OAuth yêu cầu gói đăng ký SuperGrok hoặc X Premium đủ điều kiện (xác minh bằng mã thiết bị, vì vậy có thể hoạt động từ máy chủ từ xa mà không cần callback localhost):
openclaw models auth login --provider xai --method oauthTrong quá trình cài đặt mới, lựa chọn tương tự có sẵn ở bước hướng dẫn thiết lập:
openclaw onboard --install-daemon --auth-choice xai-oauthHoặc dùng khóa API:
openclaw models auth login --provider xai --method api-keyexport XAI_API_KEY=xai-...Hoặc qua cấu hình:
{ plugins: { entries: { xai: { config: { webSearch: { apiKey: "xai-...", }, }, }, }, },}Bất kỳ phương thức nào trong ba phương thức này cũng cung cấp quyền hoạt động cho x_search và web_search của Grok.
Bật và tinh chỉnh code_execution
Khi bỏ qua enabled, code_execution chỉ được cung cấp khi nhà cung cấp
của mô hình đang hoạt động là xai và thông tin xác thực xAI được phân
giải thành công. Đối với mô hình đang hoạt động có nhà cung cấp không phải
xAI đã biết, hãy đặt plugins.entries.xai.config.codeExecution.enabled
thành true để chủ động bật việc sử dụng giữa các nhà cung cấp. Nếu nhà
cung cấp của mô hình đang hoạt động bị thiếu hoặc không thể phân giải,
công cụ vẫn bị ẩn. Đặt enabled thành false để tắt công cụ cho mọi
nhà cung cấp. Thông tin xác thực xAI luôn là bắt buộc.
Dùng cùng khối cấu hình để ghi đè mô hình, giới hạn lượt hoặc thời gian chờ:
{ plugins: { entries: { xai: { config: { codeExecution: { enabled: true, // bắt buộc đối với nhà cung cấp mô hình không phải xAI đã biết model: "grok-4.3", // ghi đè mô hình thực thi mã xAI mặc định maxTurns: 2, // giới hạn tùy chọn cho các lượt công cụ nội bộ timeoutSeconds: 30, // thời gian chờ yêu cầu (mặc định: 30) }, }, }, }, },}Khởi động lại Gateway
openclaw gateway restartcode_execution xuất hiện trong danh sách công cụ của tác tử sau khi Plugin
xAI đăng ký lại và các bước kiểm tra nhà cung cấp, trạng thái bật và xác
thực ở trên đều đạt yêu cầu.
Cách sử dụng
Hãy nêu rõ mục đích phân tích; công cụ nhận một tham số task duy nhất,
vì vậy hãy gửi toàn bộ yêu cầu và mọi dữ liệu nội tuyến trong một lời nhắc:
Dùng code_execution để tính trung bình động 7 ngày cho các số sau: ...Dùng x_search để tìm các bài đăng đề cập đến OpenClaw trong tuần này, sau đó dùng code_execution để đếm chúng theo ngày.Dùng web_search để thu thập các số liệu chuẩn đánh giá AI mới nhất, sau đó dùng code_execution để so sánh mức thay đổi phần trăm.Lỗi
Khi không có thông tin xác thực, công cụ trả về lỗi JSON có cấu trúc (không ném ngoại lệ), vì vậy tác tử có thể tự sửa lỗi:
{ "error": "missing_xai_api_key", "message": "code_execution cần thông tin xác thực xAI. Chạy `openclaw onboard --auth-choice xai-oauth` để đăng nhập bằng Grok, chạy `openclaw onboard --auth-choice xai-api-key`, đặt `XAI_API_KEY` trong môi trường Gateway hoặc cấu hình `plugins.entries.xai.config.webSearch.apiKey`.", "docs": "https://docs.openclaw.ai/tools/code-execution"}