---
read_when:
    - شما جستجوی وبِ پشتیبانی‌شده توسط Tavily را می‌خواهید
    - به یک کلید API Tavily نیاز دارید
    - می‌خواهید Tavily را به‌عنوان ارائه‌دهندهٔ web_search داشته باشید
    - می‌خواهید محتوا از URLها استخراج شود
summary: ابزارهای جست‌وجو و استخراج Tavily
title: Tavily
x-i18n:
    generated_at: "2026-04-29T23:46:27Z"
    model: gpt-5.5
    provider: openai
    source_hash: 9af858cd8507e3ebe6614f0695f568ce589798c816c8475685526422a048ef1a
    source_path: tools/tavily.md
    workflow: 16
---

OpenClaw می‌تواند از **Tavily** به دو روش استفاده کند:

- به‌عنوان ارائه‌دهنده‌ی `web_search`
- به‌عنوان ابزارهای صریح Plugin:‏ `tavily_search` و `tavily_extract`

Tavily یک API جست‌وجو است که برای برنامه‌های AI طراحی شده و نتایج ساخت‌یافته‌ای را برمی‌گرداند
که برای مصرف LLM بهینه شده‌اند. این سرویس از عمق جست‌وجوی قابل پیکربندی، فیلترکردن موضوع،
فیلترهای دامنه، خلاصه‌های پاسخ تولیدشده با AI، و استخراج محتوا
از URLها (از جمله صفحه‌های رندرشده با JavaScript) پشتیبانی می‌کند.

## دریافت کلید API

1. در [tavily.com](https://tavily.com/) یک حساب Tavily بسازید.
2. در داشبورد یک کلید API تولید کنید.
3. آن را در پیکربندی ذخیره کنید یا `TAVILY_API_KEY` را در محیط Gateway تنظیم کنید.

## پیکربندی جست‌وجوی Tavily

```json5
{
  plugins: {
    entries: {
      tavily: {
        enabled: true,
        config: {
          webSearch: {
            apiKey: "tvly-...", // optional if TAVILY_API_KEY is set
            baseUrl: "https://api.tavily.com",
          },
        },
      },
    },
  },
  tools: {
    web: {
      search: {
        provider: "tavily",
      },
    },
  },
}
```

نکته‌ها:

- انتخاب Tavily در راه‌اندازی اولیه یا `openclaw configure --section web`،
  Plugin همراه Tavily را به‌صورت خودکار فعال می‌کند.
- پیکربندی Tavily را زیر `plugins.entries.tavily.config.webSearch.*` ذخیره کنید.
- `web_search` با Tavily از `query` و `count` (تا 20 نتیجه) پشتیبانی می‌کند.
- برای کنترل‌های اختصاصی Tavily مانند `search_depth`،‏ `topic`،‏ `include_answer`،
  یا فیلترهای دامنه، از `tavily_search` استفاده کنید.

## ابزارهای Plugin در Tavily

### `tavily_search`

وقتی به‌جای `web_search` عمومی، کنترل‌های جست‌وجوی اختصاصی Tavily را می‌خواهید
از این استفاده کنید.

| پارامتر           | توضیح                                                                  |
| ----------------- | --------------------------------------------------------------------- |
| `query`           | رشته‌ی پرس‌وجوی جست‌وجو (کمتر از 400 نویسه نگه دارید)                 |
| `search_depth`    | `basic` (پیش‌فرض، متعادل) یا `advanced` (بیشترین ارتباط، کندتر)       |
| `topic`           | `general` (پیش‌فرض)، `news` (به‌روزرسانی‌های بی‌درنگ)، یا `finance`   |
| `max_results`     | تعداد نتایج، 1-20 (پیش‌فرض: 5)                                        |
| `include_answer`  | شامل‌کردن خلاصه‌ی پاسخ تولیدشده با AI (پیش‌فرض: false)                |
| `time_range`      | فیلتر بر اساس تازگی: `day`،‏ `week`،‏ `month`، یا `year`              |
| `include_domains` | آرایه‌ای از دامنه‌ها برای محدودکردن نتایج به آن‌ها                    |
| `exclude_domains` | آرایه‌ای از دامنه‌ها برای حذف از نتایج                                |

**عمق جست‌وجو:**

| عمق        | سرعت   | ارتباط       | بهترین کاربرد                         |
| ---------- | ------ | ------------ | ------------------------------------- |
| `basic`    | سریع‌تر | زیاد         | پرس‌وجوهای عمومی (پیش‌فرض)           |
| `advanced` | کندتر  | بیشترین      | دقت، واقعیت‌های مشخص، پژوهش          |

### `tavily_extract`

از این ابزار برای استخراج محتوای تمیز از یک یا چند URL استفاده کنید. صفحه‌های
رندرشده با JavaScript را مدیریت می‌کند و برای استخراج هدفمند، از قطعه‌بندی متمرکز بر پرس‌وجو
پشتیبانی می‌کند.

| پارامتر             | توضیح                                                          |
| ------------------- | -------------------------------------------------------------- |
| `urls`              | آرایه‌ای از URLها برای استخراج (1-20 مورد در هر درخواست)       |
| `query`             | رتبه‌بندی دوباره‌ی قطعه‌های استخراج‌شده بر اساس ارتباط با این پرس‌وجو |
| `extract_depth`     | `basic` (پیش‌فرض، سریع) یا `advanced` (برای صفحه‌های سنگین از نظر JS) |
| `chunks_per_source` | قطعه‌ها به‌ازای هر URL، 1-5 (به `query` نیاز دارد)             |
| `include_images`    | شامل‌کردن URLهای تصویر در نتایج (پیش‌فرض: false)               |

**عمق استخراج:**

| عمق        | زمان استفاده                              |
| ---------- | ------------------------------------------ |
| `basic`    | صفحه‌های ساده - ابتدا این را امتحان کنید  |
| `advanced` | SPAهای رندرشده با JS، محتوای پویا، جدول‌ها |

نکته‌ها:

- حداکثر 20 URL در هر درخواست. فهرست‌های بزرگ‌تر را در چند فراخوانی دسته‌بندی کنید.
- از `query` + `chunks_per_source` استفاده کنید تا به‌جای صفحه‌های کامل، فقط محتوای مرتبط را دریافت کنید.
- ابتدا `basic` را امتحان کنید؛ اگر محتوا وجود نداشت یا ناقص بود، به `advanced` برگردید.

## انتخاب ابزار مناسب

| نیاز                                      | ابزار             |
| ----------------------------------------- | ---------------- |
| جست‌وجوی سریع وب، بدون گزینه‌های ویژه     | `web_search`     |
| جست‌وجو با عمق، موضوع، پاسخ‌های AI        | `tavily_search`  |
| استخراج محتوا از URLهای مشخص              | `tavily_extract` |

## مرتبط

- [نمای کلی جست‌وجوی وب](/fa/tools/web) -- همه‌ی ارائه‌دهنده‌ها و تشخیص خودکار
- [Firecrawl](/fa/tools/firecrawl) -- جست‌وجو + خزش با استخراج محتوا
- [Exa Search](/fa/tools/exa-search) -- جست‌وجوی عصبی با استخراج محتوا
