Documentation Index
Fetch the complete documentation index at: https://openclawhub.vn/llms.txt
Use this file to discover all available pages before exploring further.
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.| Tham số | Mô tả |
|---|---|
query | Truy vấn tìm kiếm (bắt buộc) |
count | Số lượng kết quả trả về (1-10, mặc định: 5) |
country | Mã quốc gia ISO 2 chữ cái (ví dụ: “US”, “DE”) |
language | Mã ngôn ngữ ISO 639-1 (ví dụ: “en”, “de”, “fr”) |
freshness | Bộ lọc thời gian: day (24h), week, month, hoặc year |
date_after | Chỉ kết quả xuất bản sau ngày này (YYYY-MM-DD) |
date_before | Chỉ kết quả xuất bản trước ngày này (YYYY-MM-DD) |
domain_filter | Mảng danh sách cho phép/chặn tên miền (tối đa 20) |
max_tokens | Ngân sách nội dung tổng (mặc định: 25000, tối đa: 1000000) |
max_tokens_per_page | Giới hạn token mỗi trang (mặc định: 2048) |
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)