Chuyển đến nội dung chính
Plugin Parallel cung cấp hai nhà cung cấp web_search của Parallel, cả hai đều trả về các đoạn trích được xếp hạng và tối ưu hóa cho LLM từ một chỉ mục web được xây dựng cho các tác tử AI: Đặt tools.web.search.provider thành parallel-free hoặc parallel để chọn rõ ràng một nhà cung cấp; không nhà cung cấp nào được tự động phát hiện.
Các mô hình OpenAI Responses trực tiếp (api: "openai-responses", nhà cung cấp openai, URL cơ sở API chính thức) tự động sử dụng tính năng tìm kiếm web gốc được OpenAI lưu trữ khi tools.web.search.provider chưa được đặt, để trống, là "auto" hoặc "openai" — vì vậy, theo mặc định chúng bỏ qua Parallel. Đặt tools.web.search.provider thành parallel-free hoặc parallel để thay vào đó định tuyến chúng qua Parallel. Xem Tổng quan về tìm kiếm web.

​
Cài đặt Plugin

​
Khóa API (nhà cung cấp trả phí)

parallel-free không cần khóa nhưng vẫn phải được chọn rõ ràng. Nhà cung cấp parallel trả phí cần khóa API:
1

Tạo tài khoản

Đăng ký tại platform.parallel.ai và tạo khóa API từ bảng điều khiển của bạn.
2

Lưu trữ khóa

Đặt PARALLEL_API_KEY trong môi trường Gateway hoặc cấu hình qua:

​
Cấu hình

Phương án thay thế bằng biến môi trường: đặt PARALLEL_API_KEY trong môi trường Gateway. Đối với bản cài đặt Gateway, hãy đặt biến này trong ~/.openclaw/.env.

​
Ghi đè URL cơ sở

Chỉ áp dụng cho nhà cung cấp parallel trả phí; parallel-free luôn sử dụng https://search.parallel.ai/mcp và bỏ qua cài đặt này. Đặt plugins.entries.parallel.config.webSearch.baseUrl để định tuyến các yêu cầu trả phí qua một proxy tương thích hoặc điểm cuối thay thế (ví dụ: Cloudflare AI Gateway). OpenClaw chuẩn hóa các máy chủ thuần bằng cách thêm https:// vào trước và nối thêm /v1/search trừ khi đường dẫn đã kết thúc bằng phần này. Điểm cuối đã phân giải là một phần của khóa bộ nhớ đệm tìm kiếm, vì vậy kết quả từ các điểm cuối khác nhau không bao giờ được dùng chung.

​
Tham số công cụ

Cả hai nhà cung cấp đều cung cấp cấu trúc tìm kiếm gốc của Parallel để mô hình điền một mục tiêu bằng ngôn ngữ tự nhiên cùng một vài truy vấn từ khóa ngắn — cách kết hợp mà Parallel khuyến nghị để đạt kết quả tốt nhất.
​
objective
string
bắt buộc
Mô tả bằng ngôn ngữ tự nhiên về câu hỏi hoặc mục tiêu cơ bản (tối đa 5000 ký tự). Nội dung phải tự đầy đủ.
​
search_queries
string[]
bắt buộc
Các truy vấn tìm kiếm bằng từ khóa ngắn gọn, mỗi truy vấn gồm 3-6 từ (1-5 mục, tối đa 200 ký tự mỗi mục). Cung cấp 2-3 truy vấn đa dạng để đạt kết quả tốt nhất.
​
count
number
Số kết quả cần trả về (1-40).
​
session_id
string
ID phiên Parallel không bắt buộc từ sessionId của kết quả trước đó. Truyền nó vào các lần tìm kiếm tiếp theo trong cùng một tác vụ để Parallel nhóm các lệnh gọi liên quan và cải thiện kết quả tiếp theo. Tối đa 1000 ký tự đối với parallel; Search MCP parallel-free miễn phí giới hạn ở 100. ID vượt quá giới hạn sẽ bị loại bỏ (trả phí) hoặc một ID mới sẽ được tạo (miễn phí).
​
client_model
string
Mã định danh không bắt buộc của mô hình thực hiện lệnh gọi (ví dụ: claude-opus-4-7, gpt-5.6-sol), tối đa 100 ký tự. Cho phép Parallel điều chỉnh các cài đặt mặc định theo khả năng của mô hình. Truyền chính xác slug của mô hình đang hoạt động; không rút gọn thành bí danh họ mô hình.

​
Ghi chú

  • Parallel xếp hạng và nén kết quả nhằm phục vụ khả năng suy luận của LLM, không phải lượt nhấp của con người; mỗi kết quả sẽ chứa các đoạn trích cô đọng thay vì nội dung toàn trang.
  • Các đoạn trích kết quả được trả về dưới dạng mảng excerpts và cũng được nối vào description để tương thích với hợp đồng web_search chung.
  • Cả hai nhà cung cấp đều trả về session_id; OpenClaw hiển thị giá trị này dưới dạng sessionId trong tải trọng công cụ để bên gọi có thể nhóm các lần tìm kiếm tiếp theo. ID phiên do Parallel tạo (không phải do bên gọi cung cấp) được loại khỏi mục bộ nhớ đệm, vì các tác vụ không liên quan có truy vấn giống nhau không nên kế thừa ID đó.
  • searchId, warnings và usage từ Parallel được chuyển tiếp khi có.
  • OpenClaw luôn chuyển tiếp số lượng kết quả đã phân giải đến Parallel dưới dạng advanced_settings.max_results (parallel) hoặc áp dụng count ở phía máy khách sau phản hồi có kích thước cố định của Parallel (parallel-free). Đối số count của bên gọi được ưu tiên, tiếp theo là tools.web.search.maxResults; nếu không có, OpenClaw sử dụng giá trị mặc định web_search chung (5) — API riêng của Parallel mặc định là 10.
  • Theo mặc định, kết quả được lưu vào bộ nhớ đệm trong 15 phút (cacheTtlMinutes).
  • parallel-free tạo một session_id mới cho mỗi lệnh gọi thông qua quy trình bắt tay MCP khi bên gọi không cung cấp; trong trường hợp đó, parallel để giá trị này chưa đặt.

​
Liên quan