API Tìm kiếm Perplexity
OpenClaw hỗ trợ API Tìm kiếm Perplexity như một nhà cung cấpweb_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
- Tạo tài khoản Perplexity tại perplexity.ai/settings/api
- Tạo khóa API trong dashboard
- Lưu khóa vào cấu hình hoặc thiết lập
PERPLEXITY_API_KEYtrong 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.baseUrlplugins.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ạyopenclaw 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ợ
query và freshness.
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/modelrõ 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)