Perplexity Sonar in OpenClaw einrichten

Kennst du das? Du baust eine Anwendung und die KI liefert veraltete Daten, weil sie keinen Zugriff auf aktuelle Web-Inhalte hat. Die Suche manuell einzubinden ist oft zeitaufwendig und das Management verschiedener API Keys nervt im Entwickler-Alltag.

Wenn du eine Lösung suchst, die schnell aktuelle Informationen liefert, ist Perplexity Sonar eine gute Wahl. Es lässt sich unkompliziert in OpenClaw integrieren, damit dein Agent direkt auf das Web zugreifen kann.

Voraussetzungen

• Perplexity API Key (PERPLEXITY_API_KEY)
• OpenRouter API Key (OPENROUTER_API_KEY) als alternative Option

Schnellstart

OpenClaw nutzt Perplexity Sonar für das web_search Tool. Du kannst dich entweder direkt mit der Perplexity API verbinden oder den Umweg über OpenRouter gehen.

Konfigurationsbeispiel

Hier ist ein Beispiel für deine Konfiguration:

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

Modell-Optionen

Du kannst zwischen verschiedenen Modellen wählen, je nachdem wie komplex die Suche sein soll:

• perplexity/sonar: Schnelle Q&A mit Web-Suche.
• perplexity/sonar-pro: Das Standard-Modell mit mehrstufigem Reasoning und Web-Suche.
• perplexity/sonar-reasoning-pro: Für tiefgehende Recherche-Aufgaben.
• perplexity/sonar-small: (Hinweis: Nutze die in der Dokumentation genannten Versionen für beste Ergebnisse).

Von Brave wechseln

Falls du vorher Brave genutzt hast, musst du nur den Provider und die entsprechenden API-Daten anpassen:

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

Fehlerbehebung

Wenn du sowohl PERPLEXITY_API_KEY als auch OPENROUTER_API_KEY in deinen Umgebungsvariablen gesetzt hast, musst du OpenClaw helfen, die richtige Wahl zu treffen. Nutze tools.web.search.perplexity.baseUrl oder tools.web.search.perplexity.apiKey, um den Provider eindeutig festzulegen.

Falls keine baseUrl definiert ist, entscheidet OpenClaw anhand des API Key Formats:

• Keys mit pplx-... oder die Variable PERPLEXITY_API_KEY führen zur direkten Perplexity API (https://api.perplexity.ai).
• Keys mit sk-or-... oder die Variable OPENROUTER_API_KEY führen zu OpenRouter (https://openrouter.ai/api/v1).
• Unbekannte Formate werden automatisch über OpenRouter geleitet.

AI Setup Assistant

Nächste Schritte

• Web tools