Chuyển đến nội dung chính

Perplexity (Nhà cung cấp tìm kiếm web)

Plugin Perplexity cung cấp khả năng tìm kiếm web thông qua Perplexity Search API hoặc Perplexity Sonar qua OpenRouter.
Trang này hướng dẫn thiết lập nhà cung cấp Perplexity. Để biết cách sử dụng công cụ Perplexity (cách agent sử dụng), xem công cụ Perplexity.
  • Loại: nhà cung cấp tìm kiếm web (không phải nhà cung cấp mô hình)
  • Xác thực: PERPLEXITY_API_KEY (trực tiếp) hoặc OPENROUTER_API_KEY (qua OpenRouter)
  • Đường dẫn cấu hình: plugins.entries.perplexity.config.webSearch.apiKey

Bắt đầu nhanh

  1. Thiết lập API key:
openclaw configure --section web
Hoặc thiết lập trực tiếp:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
  1. Agent sẽ tự động sử dụng Perplexity cho tìm kiếm web khi đã cấu hình.

Chế độ tìm kiếm

Plugin tự động chọn phương thức dựa trên tiền tố của API key:
Tiền tố keyPhương thứcTính năng
pplx-Native Perplexity Search APIKết quả có cấu trúc, bộ lọc miền/ngôn ngữ/ngày
sk-or-OpenRouter (Sonar)Câu trả lời tổng hợp AI kèm trích dẫn

Lọc API gốc

Khi sử dụng API gốc của Perplexity (key pplx-), tìm kiếm hỗ trợ:
  • Quốc gia: mã quốc gia 2 chữ cái
  • Ngôn ngữ: mã ngôn ngữ ISO 639-1
  • Khoảng thời gian: ngày, tuần, tháng, năm
  • Bộ lọc miền: danh sách cho phép/chặn (tối đa 20 miền)
  • Ngân sách nội dung: max_tokens, max_tokens_per_page

Lưu ý về môi trường

Nếu Gateway chạy dưới dạng daemon (launchd/systemd), đảm bảo PERPLEXITY_API_KEY có sẵn cho tiến trình đó (ví dụ, trong ~/.openclaw/.env hoặc qua env.shellEnv).
Last modified on March 22, 2026