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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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 là phần 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 nó), xem công cụ Perplexity.
Thuộc tínhGiá trị
LoạiNhà cung cấp tìm kiếm web (không phải nhà cung cấp mô hình)
Xác thựcPERPLEXITY_API_KEY (trực tiếp) hoặc OPENROUTER_API_KEY (qua OpenRouter)
Đường dẫn cấu hìnhplugins.entries.perplexity.config.webSearch.apiKey

Bắt đầu

1

Đặt khóa API

Chạy luồng cấu hình tìm kiếm web tương tác:
openclaw configure --section web
Hoặc đặt khóa trực tiếp:
openclaw config set plugins.entries.perplexity.config.webSearch.apiKey "pplx-xxxxxxxxxxxx"
2

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

Tác nhân sẽ tự động sử dụng Perplexity cho các lượt tìm kiếm web sau khi khóa được cấu hình. Không cần thêm bước nào.

Chế độ tìm kiếm

Plugin tự động chọn phương thức truyền tải dựa trên tiền tố khóa API:
Khi khóa của bạn bắt đầu bằng pplx-, OpenClaw sử dụng Perplexity Search API gốc. Phương thức truyền tải này trả về kết quả có cấu trúc và hỗ trợ bộ lọc tên miền, ngôn ngữ và ngày (xem các tùy chọn lọc bên dưới).
Tiền tố khóaPhương thức truyền tảiTính năng
pplx-Perplexity Search API gốcKết quả có cấu trúc, bộ lọc tên miền/ngôn ngữ/ngày
sk-or-OpenRouter (Sonar)Câu trả lời do AI tổng hợp kèm trích dẫn

Lọc API gốc

Các tùy chọn lọc chỉ khả dụng khi dùng Perplexity API gốc (khóa pplx-). Tìm kiếm qua OpenRouter/Sonar không hỗ trợ các tham số này.
Khi dùng Perplexity API gốc, lượt tìm kiếm hỗ trợ các bộ lọc sau:
Bộ lọcMô tảVí dụ
Quốc giaMã quốc gia gồm 2 chữ cáius, de, jp
Ngôn ngữMã ngôn ngữ ISO 639-1en, fr, zh
Khoảng ngàyKhoảng thời gian gần đâyday, week, month, year
Bộ lọc tên miềnDanh sách cho phép hoặc danh sách chặn (tối đa 20 tên miền)example.com
Ngân sách nội dungGiới hạn token cho mỗi phản hồi / mỗi trangmax_tokens, max_tokens_per_page

Cấu hình nâng cao

Nếu OpenClaw Gateway chạy như một daemon (launchd/systemd), hãy đảm bảo PERPLEXITY_API_KEY có sẵn cho tiến trình đó.
Khóa chỉ được đặt trong ~/.profile sẽ không hiển thị với daemon 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 để đảm bảo tiến trình Gateway có thể đọc khóa.
Nếu bạn muốn định tuyến tìm kiếm Perplexity qua OpenRouter, hãy đặt OPENROUTER_API_KEY (tiền tố sk-or-) thay vì khóa Perplexity gốc. OpenClaw sẽ phát hiện tiền tố và tự động chuyển sang phương thức truyền tải Sonar.
Phương thức truyền tải OpenRouter hữu ích nếu bạn đã có tài khoản OpenRouter và muốn hợp nhất thanh toán trên nhiều nhà cung cấp.

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 nhập Plugin.