​

Webbverktyg

• web_search — Sök på webben via Brave Search API (standard) eller Perplexity Sonar (direkt eller via OpenRouter).
• web_fetch — HTTP-hämtning + extrahering av läsbart innehåll (HTML → markdown/text).

​

Hur det fungerar

• web_search anropar din konfigurerade leverantör och returnerar resultat.
  • Brave (standard): returnerar strukturerade resultat (titel, URL, utdrag).
  • Perplexity: returnerar AI-syntetiserade svar med citeringar från webbsökning i realtid.
• Resultat cachas per fråga i 15 minuter (konfigurerbart).
• web_fetch gör en vanlig HTTP GET och extraherar läsbart innehåll (HTML → markdown/text). Det utför inte JavaScript.
• web_fetch är aktiverat som standard (om det inte uttryckligen inaktiveras).

​

Välja sökleverantör

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

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

​

Skaffa en Brave API-nyckel

1. Skapa ett Brave Search API-konto på https://brave.com/search/api/
2. Välj planen Data for Search i kontrollpanelen (inte ”Data for AI”) och generera en API-nyckel.
3. Kör openclaw configure --section web för att lagra nyckeln i konfig (rekommenderas), eller sätt BRAVE_API_KEY i din miljö.

​

Var du sätter nyckeln (rekommenderat)

​

Använda Perplexity (direkt eller via OpenRouter)

​

Skaffa en OpenRouter API-nyckel

1. Skapa ett konto på https://openrouter.ai/
2. Lägg till saldo (stödjer krypto, förbetalt eller kreditkort)
3. Generera en API-nyckel i kontoinställningarna

​

Konfigurera Perplexity-sökning

{
  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",
        },
      },
    },
  },
}

• PERPLEXITY_API_KEY eller pplx-... → https://api.perplexity.ai
• OPENROUTER_API_KEY eller sk-or-... → https://openrouter.ai/api/v1
• Okända nyckelformat → OpenRouter (säker fallback)

​

Tillgängliga Perplexity-modeller

​

web_search

​

Krav

• tools.web.search.enabled får inte vara false (standard: aktiverad)
• API-nyckel för vald leverantör:
  • Brave: BRAVE_API_KEY eller tools.web.search.apiKey
  • Perplexity: OPENROUTER_API_KEY, PERPLEXITY_API_KEY eller tools.web.search.perplexity.apiKey

​

Konfig

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

​

Verktygsparametrar

• query (obligatorisk)
• count (1–10; standard från konfig)
• country (valfritt): 2 bokstäver landskod för regionspecifika resultat (t.ex., “DE”, “US”, “ALL”). Om den utelämnas väljer modig sin standardregion.
• search_lang (valfritt): ISO språkkod för sökresultat (t.ex., “de”, “en”, “fr”)
• ui_lang (valfri): ISO-språkkod för UI-element
• freshness (valfri, endast Brave): filtrera efter upptäcktstid (pd, pw, pm, py eller YYYY-MM-DDtoYYYY-MM-DD)
  • Brave: pd, pw, pm, py eller 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

​

Krav för web_fetch

• tools.web.fetch.enabled får inte vara false (standard: aktiverad)
• Valfri Firecrawl-fallback: sätt tools.web.fetch.firecrawl.apiKey eller FIRECRAWL_API_KEY.

​

web_fetch-konfig

{
  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,
        },
      },
    },
  },
}

​

Parametrar för web_fetch-verktyget

• url (obligatorisk, endast http/https)
• extractMode (markdown | text)
• maxChars (korta ned långa sidor)

• web_fetch använder läsbarhet (huvudinnehållsextraktion) först och sedan Firecrawl (om konfigurerad). Om båda misslyckas, returnerar verktyget ett fel.
• Firecrawl-anrop använder bot-kringgående läge och cachar resultat som standard.
• web_fetch skickar en Chrome-liknande User-Agent och Accept-Language som standard; åsidosätt userAgent vid behov.
• web_fetch blockerar privata/interna värdnamn och kontrollerar omdirigeringar igen (begränsa med maxRedirects).
• maxChars begränsas till tools.web.fetch.maxCharsCap.
• web_fetch är bästa möjliga extrahering; vissa webbplatser kräver browser tool.
• Se Firecrawl för nyckelkonfigurering och tjänstedetaljer.
• Svar cachas (standard 15 minuter) för att minska upprepade hämtningar.
• Om du använder verktygsprofiler/tillåtelselistor, lägg till web_search/web_fetch eller group:web.
• Om Brave-nyckeln saknas returnerar web_search en kort installationshint med en dokumentationslänk.