Perplexity

Plugin Perplexity đăng ký một nhà cung cấp web_search với hai phương thức truyền tải: API Tìm kiếm Perplexity gốc (kết quả có cấu trúc kèm bộ lọc) và tính năng hoàn tất trò chuyện Perplexity Sonar, trực tiếp hoặc qua OpenRouter (câu trả lời do AI tổng hợp kèm trích dẫn).

Trang này trình bày cách thiết lập nhà cung cấp Perplexity. Đối với công cụ Perplexity (cách tác nhân sử dụng công cụ này), hãy xem Tìm kiếm Perplexity.

Thuộc tính	Giá trị
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 (gốc) hoặc OPENROUTER_API_KEY (qua OpenRouter)
Đường dẫn cấu hình	plugins.entries.perplexity.config.webSearch.apiKey
Ghi đè	plugins.entries.perplexity.config.webSearch.baseUrl / .model
Lấy khóa	perplexity.ai/settings/api

​

Cài đặt Plugin

openclaw plugins install @openclaw/perplexity-plugin
openclaw gateway restart

​

Bắt đầu

1. Đặt khóa API

   openclaw configure --section web
   

   Hoặc đặt khóa trực tiếp:

   openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
   

   Khóa được xuất dưới dạng PERPLEXITY_API_KEY hoặc OPENROUTER_API_KEY trong môi trường Gateway cũng hoạt động.

2. Bắt đầu tìm kiếm

   web_search tự động phát hiện Perplexity khi khóa của dịch vụ này là thông tin xác thực tìm kiếm khả dụng; không cần thiết lập thêm. Để chỉ định rõ nhà cung cấp:

   openclaw config set tools.web.search.provider perplexity
   

​

Chế độ tìm kiếm

Plugin xác định phương thức truyền tải theo thứ tự sau:

1. Đã đặt webSearch.baseUrl hoặc webSearch.model: luôn định tuyến qua tính năng hoàn tất trò chuyện Sonar đến điểm cuối đó, bất kể loại khóa.
2. Nếu không, nguồn khóa quyết định điểm cuối: tiền tố của khóa đã cấu hình chọn phương thức truyền tải (cấu hình được ưu tiên hơn biến môi trường); khóa môi trường sử dụng trực tiếp điểm cuối tương ứng.

Tiền tố khóa	Phương thức truyền tải	Tính năng
pplx-	API Tìm kiếm Perplexity gốc (https://api.perplexity.ai)	Kết quả có cấu trúc, bộ lọc miền/ngôn ngữ/ngày
sk-or-	OpenRouter (https://openrouter.ai/api/v1), mô hình Sonar	Câu trả lời do AI tổng hợp kèm trích dẫn

Khóa đã cấu hình có bất kỳ tiền tố nào khác cũng sử dụng API Tìm kiếm gốc. Đường dẫn hoàn tất trò chuyện mặc định sử dụng mô hình perplexity/sonar-pro; ghi đè bằng plugins.entries.perplexity.config.webSearch.model.

​

Lọc bằng API gốc

Bộ lọc	Mô tả	Phương thức truyền tải
count	Số kết quả mỗi lần tìm kiếm, 1–10 (mặc định là 5)	Chỉ API gốc
freshness	Khoảng thời gian gần đây: day, week, month, year	Cả hai
country	Mã quốc gia gồm 2 chữ cái (us, de, jp)	Chỉ API gốc
language	Mã ngôn ngữ ISO 639-1 (en, fr, zh)	Chỉ API gốc
date_after / date_before	Khoảng ngày xuất bản theo định dạng YYYY-MM-DD	Chỉ API gốc
domain_filter	Tối đa 20 miền; danh sách cho phép hoặc danh sách từ chối có tiền tố -, không bao giờ kết hợp	Chỉ API gốc
max_tokens / max_tokens_per_page	Ngân sách nội dung cho tất cả kết quả / mỗi trang	Chỉ API gốc

Các bộ lọc chỉ dành cho API gốc trả về lỗi mô tả rõ ràng trên đường dẫn hoàn tất trò chuyện. Không thể kết hợp freshness với date_after/date_before.

​

Cấu hình nâng cao

Biến môi trường cho tiến trình daemon

Khóa chỉ được xuất trong shell tương tác sẽ không hiển thị với daemon Gateway của launchd/systemd, trừ khi môi trường đó được nhập rõ ràng. Đặt khóa trong ~/.openclaw/.env hoặc qua env.shellEnv để tiến trình Gateway có thể đọc khóa. Xem Biến môi trường để biết đầy đủ thứ tự ưu tiên.

Thiết lập proxy OpenRouter

Để định tuyến các lượt tìm kiếm Perplexity qua OpenRouter, hãy đặt OPENROUTER_API_KEY (tiền tố sk-or-) thay cho khóa Perplexity gốc. OpenClaw phát hiện khóa và tự động chuyển sang phương thức truyền tải Sonar. Cách này hữu ích nếu bạn đã thiết lập thanh toán OpenRouter và muốn hợp nhất các nhà cung cấp tại đó.

​

Liên quan

Công cụ tìm kiếm Perplexity

Cách tác nhân gọi tìm kiếm Perplexity và diễn giải kết quả.

Tham chiếu cấu hình

Tham chiếu cấu hình đầy đủ, bao gồm các mục Plugin.