Skip to main content

API Tìm kiếm Perplexity

OpenClaw hỗ trợ API Tìm kiếm Perplexity như một nhà cung cấp web_search. Nó trả về kết quả có cấu trúc với các trường title, url, và snippet. Để tương thích, OpenClaw cũng hỗ trợ các thiết lập Perplexity Sonar/OpenRouter cũ. Nếu sử dụng OPENROUTER_API_KEY, một khóa sk-or-... trong plugins.entries.perplexity.config.webSearch.apiKey, hoặc thiết lập plugins.entries.perplexity.config.webSearch.baseUrl / model, nhà cung cấp sẽ chuyển sang đường dẫn chat-completions và trả về câu trả lời tổng hợp AI kèm trích dẫn thay vì kết quả API Tìm kiếm có cấu trúc.

Lấy khóa API Perplexity

  1. Tạo tài khoản Perplexity tại perplexity.ai/settings/api
  2. Tạo khóa API trong dashboard
  3. Lưu khóa vào cấu hình hoặc thiết lập PERPLEXITY_API_KEY trong môi trường Gateway.

Khả năng tương thích OpenRouter

Nếu đã sử dụng OpenRouter cho Perplexity Sonar, giữ provider: "perplexity" và thiết lập OPENROUTER_API_KEY trong môi trường Gateway, hoặc lưu một khóa sk-or-... trong plugins.entries.perplexity.config.webSearch.apiKey. Các tùy chọn điều khiển tương thích tùy chọn:
  • plugins.entries.perplexity.config.webSearch.baseUrl
  • plugins.entries.perplexity.config.webSearch.model

Ví dụ cấu hình

API Tìm kiếm Perplexity gốc

Khả năng tương thích OpenRouter / Sonar

Nơi đặt khóa

Qua cấu hình: chạy openclaw configure --section web. Nó lưu khóa trong ~/.openclaw/openclaw.json dưới plugins.entries.perplexity.config.webSearch.apiKey. Trường này cũng chấp nhận các đối tượng SecretRef. Qua môi trường: thiết lập PERPLEXITY_API_KEY hoặc OPENROUTER_API_KEY trong môi trường quá trình Gateway. Đối với cài đặt gateway, đặt nó trong ~/.openclaw/.env (hoặc môi trường dịch vụ của bạn). Xem Env vars. Nếu provider: "perplexity" được cấu hình và SecretRef khóa Perplexity không được giải quyết mà không có dự phòng môi trường, khởi động/tải lại sẽ thất bại nhanh chóng.

Tham số công cụ

Các tham số này áp dụng cho đường dẫn API Tìm kiếm Perplexity gốc. Đối với đường dẫn tương thích Sonar/OpenRouter cũ, chỉ hỗ trợ queryfreshness. Các bộ lọc chỉ dành cho API Tìm kiếm như country, language, date_after, date_before, domain_filter, max_tokens, và max_tokens_per_page sẽ trả về lỗi rõ ràng. Ví dụ:

Quy tắc lọc tên miền

  • Tối đa 20 tên miền mỗi bộ lọc
  • Không thể kết hợp danh sách cho phép và danh sách chặn trong cùng một yêu cầu
  • Sử dụng tiền tố - cho các mục trong danh sách chặn (ví dụ: ["-reddit.com"])

Ghi chú

  • API Tìm kiếm Perplexity trả về kết quả tìm kiếm web có cấu trúc (title, url, snippet)
  • OpenRouter hoặc plugins.entries.perplexity.config.webSearch.baseUrl / model rõ ràng chuyển Perplexity trở lại hoàn thành chat Sonar để tương thích
  • Kết quả được lưu trong bộ nhớ cache trong 15 phút theo mặc định (có thể cấu hình qua cacheTtlMinutes)
Xem Công cụ web để biết cấu hình đầy đủ của web_search. Xem Tài liệu API Tìm kiếm Perplexity để biết thêm chi tiết.
Lần sửa đổi cuối 22 tháng 3, 2026