Szybka odpowiedź
Jak dodać API wyszukiwania webowego z treścią stron do OpenClaw?
Zapisz serwer MCP LLMWebSearch ze strony MCP, zarejestruj go za pomocą openclaw mcp add llmwebsearch --command … --arg … --env LLMWEBSEARCH_API_KEY=…, a następnie sprawdź za pomocą openclaw mcp doctor --probe. Agent zyskuje search_web, którego wyniki zawierają 3 najważniejsze strony jako Markdown, obok wbudowanego web_search OpenClaw. Wyszukiwanie kosztuje 1 kredyt, od 1,20 USD/1K wyszukiwań według stanu na październik 2026. Bez KYC.
Wyszukiwanie w OpenClaw, według dokumentacji z 22 października 2026
| Wbudowani dostawcy web_search | 16, w tym Brave Search, DeepSeek, DuckDuckGo, Exa, Firecrawl, Gemini, Parallel, Perplexity, SearXNG i Tavily |
|---|---|
| Automatyczny wybór | Pierwszy gotowy dostawca oparty na API, w stałej kolejności zaczynającej się od Brave |
| Dostawcy bez klucza | Nigdy nie wybierani automatycznie; wybierasz ich samodzielnie |
| Nasze narzędzia (MCP) | search_web i read_urls, z lokalnego serwera Python |
| Nasz koszt | Jeden kredyt opłaca jedno wyszukiwanie: do 20 wyników z rankingiem, przy czym strony z pierwszych 3 są odczytywane i zwracane jako Markdown. Odczyt od 4 do 10 stron to 2 kredyty. Wywołanie zakończone błędem nic nie kosztuje |
| Nasz czytnik stron | LLMWebSearch/1.0 (+https://llmwebsearch.com/bot/), z poszanowaniem robots.txt |
Po co dodawać nasze wyszukiwanie, skoro OpenClaw ma web_search?
Aby otrzymać tekst strony wraz z wynikami w jednym wywołaniu. Strona OpenClaw z narzędziami webowymi wymienia 16 wbudowanych dostawców dla web_search, wybieranych w stałej kolejności auto-wykrywania, gdy żaden nie jest ustawiony. Nasze narzędzie nie zastępuje tego wyboru; dodaje drugą opcję, którą model może wywołać celowo.
search_web zwraca ponumerowane źródła z pierwszymi stronami już przeczytanymi jako Markdown, więc agent może odpowiedzieć i zacytować bez osobnego pobierania każdego linku. read_urls czyta do 20 linków znalezionych przez agenta gdzie indziej, przez ten sam czytnik.
Jak zarejestrować serwer MCP?
Najpierw skonfiguruj serwer Python ze strony MCP: jeden plik plus pakiety mcp i httpx w środowisku wirtualnym. Następnie zapisz go w OpenClaw za pomocą openclaw mcp add. Dokumentacja rejestru OpenClaw opisuje flagi stdio --command, --arg, --env i --cwd oraz prosi o zatrzymanie lokalnego Gateway, gdy zapisane serwery się zmieniają.
Następnie uruchom openclaw mcp doctor --probe. Bez --probe doctor sprawdza tylko zapisane ustawienia; z nim dodatkowo dowodzi, że serwer się łączy.
openclaw mcp add llmwebsearch \
--command /home/you/llmwebsearch/.venv/bin/python \
--arg /home/you/llmwebsearch/llmwebsearch_mcp.py \
--env LLMWEBSEARCH_API_KEY=your-key
openclaw mcp doctor llmwebsearch --probeCzy agent zobaczy search_web?
W typowych profilach tak. Dokumentacja rejestru OpenClaw mówi, że skonfigurowane narzędzia MCP pojawiają się w profilach narzędzi coding i messaging. Profil minimal je ukrywa, a tools.deny: ["bundle-mcp"] je wyłącza, więc sprawdź te dwa ustawienia, jeśli narzędzia brakuje.
Docstring narzędzia mówi modelowi, co zwraca. Dodaj jedną linię do instrukcji agenta, jeśli chcesz, by było preferowane, na przykład „używaj search_web, gdy musisz zacytować stronę”.
Czy LLMWebSearch można wybrać jako provider web_search?
Nie dzisiaj. Dokumentacja OpenClaw mówi, że ustawienie provider akceptuje providerów zadeklarowanych w manifestach dołączonych i zainstalowanych pluginów. Nie publikujemy pluginu OpenClaw, więc nasze wyszukiwanie trafia jako narzędzia MCP z własnymi nazwami.
W praktyce niewiele to zmienia dla agenta: wywołuje search_web tak, jak wywołałby web_search. Dzięki temu oba łatwo odróżnić w logach OpenClaw i w Twojej historii użycia.
Jak nasz reader traktuje strony w wynikach?
Tak samo jak przy każdym wywołaniu. Nasz czytnik respektuje robots.txt: przedstawia się jako LLMWebSearch, przestrzega reguł, które witryna zapisuje dla niego lub dla wszystkich robotów, i pomija treść każdej strony, której nie wolno mu czytać. Witryna, która ustawia Content-Signal: ai-input=no w swoim robots.txt, trzyma treść swoich stron poza treścią Twoich wyników. Gdy witryna odrzuca nasz czytnik, wynik wraca bez treści i ze statusem witryny: nigdy nie rozwiązujemy CAPTCHA, nie logujemy się na konta ani nie obchodzimy blokady czy paywalla.
Strona za loginem wraca więc bez treści. Dla strony, na której jesteś zalogowany, właściwym wyborem jest własne narzędzie przeglądarki OpenClaw działające z Twoją sesją.
Ile będzie kosztować wyszukiwanie przez OpenClaw?
Jeden kredyt za wywołanie search_web, które czyta do 3 stron, nic za wywołania, które się nie udadzą. Odczyt stron, których adresy URL już masz, kosztuje 1 kredyt za każdą rozpoczętą grupę 3 stron zwróconych z treścią, do 20 adresów URL na wywołanie; adresy URL odrzucone lub nieudane nie są liczone. Asystent, który wyszukuje 25 razy dziennie w swoich kanałach czatu, zużywa około 750 kredytów miesięcznie, więc 5 000 wyszukiwań (9,25 USD) wystarcza na ponad sześć miesięcy. Kredyty na wyszukiwanie nie mają daty ważności: to, czego nie wykorzystasz w tym miesiącu, będzie tam jeszcze w przyszłym roku.
Daj OpenClaw własny klucz API, żeby jego użycie było widoczne osobno od Twoich innych projektów.
OpenClaw: najczęstsze pytania
Czy powinienem wyłączyć własne web_search w OpenClaw?
Nie ma potrzeby. Oba mogą pozostać włączone. Wyłącz wbudowane tylko wtedy, gdy chcesz, aby każde wyszukiwanie szło przez jednego providera — dla jednego rachunku i jednego logu.
Czy działa z OpenClaw w sandboxie?
Serwer MCP to lokalny proces, który wywołuje https://llmwebsearch.com/api/v1 przez HTTPS. Twój sandbox musi pozwolić mu się uruchomić i dotrzeć pod ten adres.
Czy mogę zarządzać serwerem z Control UI?
OpenClaw przechowuje zapisane serwery MCP w mcp.servers w swojej konfiguracji. Jego dokumentacja wskazuje Control UI dla obsługiwanych ustawień MCP na żywo i zauważa, że zmiana zapisanych serwerów z wiersza poleceń wymaga zatrzymania lokalnego Gateway.
Źródła (2)
- Narzędzia web — OpenClaw docs (read 2026-10-22)
- Zarządzanie zapisanymi serwerami MCP — OpenClaw docs (read 2026-10-22)