OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Tools

Tìm kiếm song song

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:

Nhà cung cấp id Xác thực
Parallel Search (Miễn phí) parallel-free Không cần -- Search MCP miễn phí của Parallel
Parallel Search parallel PARALLEL_API_KEY -- Search API trả phí, có giới hạn tốc độ cao hơn và khả năng tinh chỉnh mục tiêu

Đặ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ài đặt Plugin

bash
openclaw plugins install @openclaw/parallel-pluginopenclaw gateway restart

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:

  • 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.

  • Lưu trữ khóa

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

    bash
    openclaw configure --section web

    • Cấu hình

    json5
    {  plugins: {    entries: {      parallel: {        config: {          webSearch: {            apiKey: "par-...", // không bắt buộc nếu đã đặt PARALLEL_API_KEY            baseUrl: "https://api.parallel.ai", // không bắt buộc; OpenClaw nối thêm /v1/search          },        },      },    },  },  tools: {    web: {      search: {        // "parallel-free" cho Search MCP miễn phí, hoặc "parallel" cho nhà cung cấp        // dựa trên API trả phí được trình bày ở đây.        provider: "parallel",      },    },  },}

    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.

    objectivestringrequired

    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_queriesstring[]required

    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.

    countnumber

    Số kết quả cần trả về (1-40).

    session_idstring

    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_modelstring

    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

    Was this useful?
    On this page

    On this page