docs/docs/vi/perplexity.md

read_when	summary	title	x-i18n
Bạn muốn sử dụng Perplexity Search để tìm kiếm trên web Bạn cần thiết lập PERPLEXITY_API_KEY hoặc OPENROUTER_API_KEY	Perplexity Search API và khả năng tương thích Sonar/OpenRouter cho web_search	Tìm kiếm Perplexity (đường dẫn cũ)	generated_at model provider source_hash source_path workflow 2026-04-29T22:55:16Z gpt-5.5 openai 87a7b6e14f636cfe6b7c5833af1b0aecb334a39babbb779c32f29bbbb5c9e14a perplexity.md 16

Perplexity Search API

OpenClaw hỗ trợ Perplexity Search API làm nhà cung cấp web_search. API này 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 bạn dùng OPENROUTER_API_KEY, một khóa sk-or-... trong plugins.entries.perplexity.config.webSearch.apiKey, hoặc đặt plugins.entries.perplexity.config.webSearch.baseUrl / model, nhà cung cấp sẽ chuyển sang đường dẫn chat-completions và trả về các câu trả lời do AI tổng hợp kèm trích dẫn thay vì kết quả Search API 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 trong cấu hình hoặc đặt PERPLEXITY_API_KEY trong môi trường Gateway.

Tương thích OpenRouter

Nếu bạn đã dùng OpenRouter cho Perplexity Sonar, hãy giữ provider: "perplexity" và đặt 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 đ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

Perplexity Search API gốc

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

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

Qua cấu hình: chạy openclaw configure --section web. Lệnh này lưu khóa trong ~/.openclaw/openclaw.json dưới plugins.entries.perplexity.config.webSearch.apiKey. Trường đó cũng chấp nhận đối tượng SecretRef.

Qua môi trường: đặt PERPLEXITY_API_KEY hoặc OPENROUTER_API_KEY trong môi trường tiến trình Gateway. Với bản cài đặt gateway, hãy đặt trong ~/.openclaw/.env (hoặc môi trường dịch vụ của bạn). Xem Biến môi trường.

Nếu provider: "perplexity" được cấu hình và SecretRef khóa Perplexity không được phân giải mà không có env dự phòng, startup/reload sẽ thất bại nhanh.

Tham số công cụ

Các tham số này áp dụng cho đường dẫn Perplexity Search API gốc.

Tham số	Mô tả
query	Truy vấn tìm kiếm (bắt buộc)
count	Số kết quả cần trả về (1-10, mặc định: 5)
country	Mã quốc gia ISO gồm 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ỉ các kết quả được xuất bản sau ngày này (YYYY-MM-DD)
date_before	Chỉ các kết quả được xuất bản trước ngày này (YYYY-MM-DD)
domain_filter	Mảng allowlist/denylist miền (tối đa 20)
max_tokens	Tổng ngân sách nội dung (mặc định: 25000, tối đa: 1000000)
max_tokens_per_page	Giới hạn token trên mỗi trang (mặc định: 2048)

Đối với đường dẫn tương thích Sonar/OpenRouter cũ:

• query, count và freshness được chấp nhận
• count ở đó chỉ để 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

Ví dụ:

// 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 allowlist và denylist trong cùng một yêu cầu
• Dùng tiền tố - cho các mục denylist (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
• 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 vào bộ nhớ đệm 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 web_search đầy đủ. Xem tài liệu Perplexity Search API để biết thêm chi tiết.

Liên quan

• Tìm kiếm Perplexity
• Tìm kiếm web