​

वेब टूल्स

• web_search — Brave Search API (डिफ़ॉल्ट) या Perplexity Sonar (direct या OpenRouter के माध्यम से) के जरिए वेब खोज।
• web_fetch — HTTP फ़ेच + पठनीय निष्कर्षण (HTML → markdown/text)।

​

यह कैसे काम करता है

• web_search आपके कॉन्फ़िगर किए गए प्रदाता को कॉल करता है और परिणाम लौटाता है।
  • Brave (डिफ़ॉल्ट): संरचित परिणाम लौटाता है (शीर्षक, URL, स्निपेट)।
  • Perplexity: रियल-टाइम वेब खोज से उद्धरणों सहित AI-संश्लेषित उत्तर लौटाता है।
• परिणाम 15 मिनट के लिए क्वेरी के आधार पर कैश किए जाते हैं (कॉन्फ़िगर करने योग्य)।
• web_fetch does a plain HTTP GET and extracts readable content (HTML → markdown/text). It does not execute JavaScript.
• web_fetch डिफ़ॉल्ट रूप से सक्षम है (जब तक स्पष्ट रूप से अक्षम न किया जाए)।

​

खोज प्रदाता चुनना

{
  tools: {
    web: {
      search: {
        provider: "brave", // or "perplexity"
      },
    },
  },
}

{
  tools: {
    web: {
      search: {
        provider: "perplexity",
        perplexity: {
          apiKey: "pplx-...",
          baseUrl: "https://api.perplexity.ai",
          model: "perplexity/sonar-pro",
        },
      },
    },
  },
}

​

Brave API कुंजी प्राप्त करना

1. https://brave.com/search/api/ पर Brave Search API खाता बनाएँ
2. डैशबोर्ड में Data for Search प्लान चुनें (“Data for AI” नहीं) और एक API कुंजी जनरेट करें।
3. कुंजी को कॉन्फ़िग में संग्रहीत करने के लिए (अनुशंसित) openclaw configure --section web चलाएँ, या अपने पर्यावरण में BRAVE_API_KEY सेट करें।

​

कुंजी कहाँ सेट करें (अनुशंसित)

​

Perplexity का उपयोग (direct या OpenRouter के माध्यम से)

​

OpenRouter API कुंजी प्राप्त करना

1. https://openrouter.ai/ पर खाता बनाएँ
2. क्रेडिट जोड़ें (क्रिप्टो, प्रीपेड, या क्रेडिट कार्ड समर्थित)
3. अपने खाता सेटिंग्स में एक API कुंजी जनरेट करें

​

Perplexity खोज सेटअप करना

{
  tools: {
    web: {
      search: {
        enabled: true,
        provider: "perplexity",
        perplexity: {
          // API key (optional if OPENROUTER_API_KEY or PERPLEXITY_API_KEY is set)
          apiKey: "sk-or-v1-...",
          // Base URL (key-aware default if omitted)
          baseUrl: "https://openrouter.ai/api/v1",
          // Model (defaults to perplexity/sonar-pro)
          model: "perplexity/sonar-pro",
        },
      },
    },
  },
}

2. Environment विकल्प: Gateway environment में OPENROUTER_API_KEY या PERPLEXITY_API_KEY सेट करें। 3. Gateway इंस्टॉल के लिए, इसे ~/.openclaw/.env में रखें।

• PERPLEXITY_API_KEY या pplx-... → https://api.perplexity.ai
• OPENROUTER_API_KEY या sk-or-... → https://openrouter.ai/api/v1
• अज्ञात कुंजी फ़ॉर्मैट → OpenRouter (सुरक्षित फ़ॉलबैक)

​

उपलब्ध Perplexity मॉडल्स

​

web_search

​

आवश्यकताएँ

• tools.web.search.enabled false नहीं होना चाहिए (डिफ़ॉल्ट: सक्षम)
• आपके चुने हुए प्रदाता के लिए API कुंजी:
  • Brave: BRAVE_API_KEY या tools.web.search.apiKey
  • Perplexity: OPENROUTER_API_KEY, PERPLEXITY_API_KEY, या tools.web.search.perplexity.apiKey

​

कॉन्फ़िग

{
  tools: {
    web: {
      search: {
        enabled: true,
        apiKey: "BRAVE_API_KEY_HERE", // optional if BRAVE_API_KEY is set
        maxResults: 5,
        timeoutSeconds: 30,
        cacheTtlMinutes: 15,
      },
    },
  },
}

​

टूल पैरामीटर्स

• query (आवश्यक)
• count (1–10; डिफ़ॉल्ट कॉन्फ़िग से)
• 4. country (वैकल्पिक): क्षेत्र-विशिष्ट परिणामों के लिए 2-अक्षरों का देश कोड (जैसे, “DE”, “US”, “ALL”)। 5. यदि छोड़ा गया, तो Brave अपना डिफ़ॉल्ट क्षेत्र चुनता है।
• search_lang (वैकल्पिक): खोज परिणामों के लिए ISO भाषा कोड (जैसे, “de”, “en”, “fr”)
• ui_lang (वैकल्पिक): UI तत्वों के लिए ISO भाषा कोड
• freshness (वैकल्पिक, केवल Brave): खोज समय के आधार पर फ़िल्टर (pd, pw, pm, py, या YYYY-MM-DDtoYYYY-MM-DD)
  • Brave: pd, pw, pm, py, or YYYY-MM-DDtoYYYY-MM-DD
  • Perplexity: pd, pw, pm, py

// German-specific search
await web_search({
  query: "TV online schauen",
  count: 10,
  country: "DE",
  search_lang: "de",
});

// French search with French UI
await web_search({
  query: "actualités",
  country: "FR",
  search_lang: "fr",
  ui_lang: "fr",
});

// Recent results (past week)
await web_search({
  query: "TMBG interview",
  freshness: "pw",
});

​

web_fetch

​

web_fetch आवश्यकताएँ

• tools.web.fetch.enabled false नहीं होना चाहिए (डिफ़ॉल्ट: सक्षम)
• वैकल्पिक Firecrawl फ़ॉलबैक: tools.web.fetch.firecrawl.apiKey या FIRECRAWL_API_KEY सेट करें।

​

web_fetch कॉन्फ़िग

{
  tools: {
    web: {
      fetch: {
        enabled: true,
        maxChars: 50000,
        maxCharsCap: 50000,
        timeoutSeconds: 30,
        cacheTtlMinutes: 15,
        maxRedirects: 3,
        userAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_7_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36",
        readability: true,
        firecrawl: {
          enabled: true,
          apiKey: "FIRECRAWL_API_KEY_HERE", // optional if FIRECRAWL_API_KEY is set
          baseUrl: "https://api.firecrawl.dev",
          onlyMainContent: true,
          maxAgeMs: 86400000, // ms (1 day)
          timeoutSeconds: 60,
        },
      },
    },
  },
}

​

web_fetch टूल पैरामीटर्स

• url (आवश्यक, केवल http/https)
• extractMode (markdown | text)
• maxChars (लंबे पृष्ठों को ट्रंकेट करें)

• 6. web_fetch पहले Readability (मुख्य-सामग्री निष्कर्षण) का उपयोग करता है, फिर Firecrawl (यदि कॉन्फ़िगर किया गया हो)। 7. यदि दोनों विफल हों, तो टूल एक त्रुटि लौटाता है।
• Firecrawl अनुरोध bot-circumvention मोड का उपयोग करते हैं और डिफ़ॉल्ट रूप से परिणाम कैश करते हैं।
• web_fetch डिफ़ॉल्ट रूप से Chrome-जैसा User-Agent और Accept-Language भेजता है; आवश्यकता होने पर userAgent को ओवरराइड करें।
• web_fetch निजी/आंतरिक होस्टनेम्स को ब्लॉक करता है और रीडायरेक्ट्स को पुनः जाँचता है (सीमा maxRedirects के साथ)।
• maxChars को tools.web.fetch.maxCharsCap तक क्लैम्प किया जाता है।
• web_fetch सर्वोत्तम-प्रयास निष्कर्षण है; कुछ साइटों के लिए ब्राउज़र टूल की आवश्यकता होगी।
• कुंजी सेटअप और सेवा विवरणों के लिए Firecrawl देखें।
• दोहराए गए फ़ेच को कम करने के लिए प्रतिक्रियाएँ कैश की जाती हैं (डिफ़ॉल्ट 15 मिनट)।
• यदि आप टूल प्रोफ़ाइल/allowlists का उपयोग करते हैं, तो web_search/web_fetch या group:web जोड़ें।
• यदि Brave कुंजी अनुपलब्ध है, तो web_search दस्तावेज़ लिंक के साथ एक संक्षिप्त सेटअप संकेत लौटाता है।