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.

​

Perplexity Search API

​

Lấy khóa Perplexity API

1. Tạo tài khoản Perplexity tại perplexity.ai/settings/api
2. Tạo khóa API trong bảng điều khiển
3. Lưu khóa trong cấu hình hoặc đặt PERPLEXITY_API_KEY trong môi trường Gateway.

​

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

• plugins.entries.perplexity.config.webSearch.baseUrl
• plugins.entries.perplexity.config.webSearch.model

​

Ví dụ cấu hình

​

Perplexity Search API gốc

{
  plugins: {
    entries: {
      perplexity: {
        config: {
          webSearch: {
            apiKey: "pplx-...",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "perplexity",
      },
    },
  },
}

​

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

{
  plugins: {
    entries: {
      perplexity: {
        config: {
          webSearch: {
            apiKey: "<openrouter-api-key>",
            baseUrl: "https://openrouter.ai/api/v1",
            model: "perplexity/sonar-pro",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "perplexity",
      },
    },
  },
}

​

Nơi đặt khóa

​

Tham số công cụ

• query, count và freshness được chấp nhận
• count chỉ dành cho khả năng tương thích ở đó; phản hồi vẫn là một câu trả lời được tổng hợp kèm trích dẫn thay vì danh sách N kết quả
• Các bộ lọc chỉ dành cho Search API như country, language, date_after, date_before, domain_filter, max_tokens và max_tokens_per_page trả về lỗi rõ ràng

// Country and language-specific search
await web_search({
  query: "renewable energy",
  country: "DE",
  language: "de",
});

// Recent results (past week)
await web_search({
  query: "AI news",
  freshness: "week",
});

// Date range search
await web_search({
  query: "AI developments",
  date_after: "2024-01-01",
  date_before: "2024-06-30",
});

// Domain filtering (allowlist)
await web_search({
  query: "climate research",
  domain_filter: ["nature.com", "science.org", ".edu"],
});

// Domain filtering (denylist - prefix with -)
await web_search({
  query: "product reviews",
  domain_filter: ["-reddit.com", "-pinterest.com"],
});

// More content extraction
await web_search({
  query: "detailed AI research",
  max_tokens: 50000,
  max_tokens_per_page: 4096,
});

​

Quy tắc bộ lọc miền

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

​

Ghi chú

• Perplexity Search API 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 sẽ chuyển Perplexity trở lại chat completions Sonar để tương thích
• Khả năng tương thích Sonar/OpenRouter trả về một câu trả lời được tổng hợp kèm trích dẫn, không phải các hàng kết quả có cấu trúc
• Kết quả được lưu trong bộ nhớ đệm trong 15 phút theo mặc định (có thể cấu hình qua cacheTtlMinutes)

​

Liên quan

• Tổng quan Web Search — tất cả nhà cung cấp và tự động phát hiện
• Tài liệu Perplexity Search API — tài liệu chính thức của Perplexity
• Brave Search — kết quả có cấu trúc với bộ lọc quốc gia/ngôn ngữ
• Exa Search — tìm kiếm neural có trích xuất nội dung