Szybka odpowiedź
Jak dodać API czytnika stron internetowych do OpenClaw?
Zapisz serwer MCP WebReaderAPI, następnie zarejestruj go za pomocą openclaw mcp add webreaderapi --command … --arg … --env WEBREADER_API_KEY=… i sprawdź za pomocą openclaw mcp doctor --probe. Agent otrzymuje narzędzie read_url obok wbudowanego web_fetch, zdolne renderować JavaScript i czytać PDF-y. Strony kosztują 1 kredyt, od 0,07 USD/1K stron według stanu na październik 2026. Bez KYC; płatność kryptowalutą.
web_fetch i read_url w OpenClaw obok siebie
| web_fetch (wbudowany) | Działa lokalnie, wyodrębnia główną treść przez Readability, zwraca Markdown lub tekst |
|---|---|
| limity web_fetch | Brak wykonywania JavaScript; domyślnie maxChars i limit 20 000 znaków (dokumentacja OpenClaw) |
| read_url (nasze narzędzie MCP) | Renderowanie JavaScript w razie potrzeby, PDF-y do 100 stron, do 500 000 znaków |
| koszt read_url | 1 kredyt = 1 odczytana strona bez przeglądarki; 2 kredyty, gdy strona wymaga przeglądarki do wyrenderowania JavaScript. Zapytanie, które się nie powiedzie lub które zostanie odrzucone przez robots.txt witryny, nie jest obciążane opłatą |
| Nasz crawler | WebReaderAPI/1.0 (+https://webreaderapi.com/bot/), robots.txt respektowany |
| Profile narzędzi | Narzędzia MCP pojawiają się w profilach coding i messaging, a nie w minimal |
Po co dodawać reader, skoro OpenClaw ma web_fetch?
Bo obejmują różne strony. Dokumentacja OpenClaw mówi, że web_fetch zawsze działa lokalnie, używa Readability do wyodrębniania głównej treści i nie wykonuje JavaScriptu; w przypadku stron mocno opartych na JavaScripcie lub chronionych logowaniem wskazuje na swoje narzędzie Web Browser. Jego ustawienie maxChars domyślnie wynosi 20 000 znaków i jest do tej wartości ograniczone.
Zostaw web_fetch do szybkich, lekkich stron. Dodaj read_url do stron, które budują treść JavaScriptem, do PDF-ów i do długich dokumentów, w których chcesz więcej niż 20 000 znaków. Dokumentacja OpenClaw zauważa też, że oficjalna wtyczka Firecrawl jest dziś jedynym dołączonym providerem, do którego web_fetch może się wycofać.
Jak zarejestrować serwer MCP w OpenClaw?
Najpierw skonfiguruj serwer Python ze strony MCP: jeden plik plus pakiety mcp i httpx. Następnie zapisz go w OpenClaw poleceniem openclaw mcp add. Dokumentacja rejestru OpenClaw opisuje flagi stdio --command, --arg, --env i --cwd oraz przechowuje zapisane definicje w mcp.servers w swojej konfiguracji.
Uruchom potem openclaw mcp doctor --probe. Bez --probe doctor sprawdza tylko zapisaną konfigurację; z nim potwierdza także, że włączone serwery się łączą.
openclaw mcp add webreaderapi \
--command /home/you/webreader/.venv/bin/python \
--arg /home/you/webreader/webreader_mcp.py \
--env WEBREADER_API_KEY=your-key
openclaw mcp doctor webreaderapi --probeCzy agent zobaczy read_url?
W typowych profilach tak. Dokumentacja rejestru OpenClaw mówi, że osadzony OpenClaw udostępnia skonfigurowane narzędzia MCP w profilach coding i messaging. Profil minimal je ukrywa, a tools.deny: ["bundle-mcp"] je wyłącza, więc sprawdź te dwa ustawienia, jeśli narzędzie się nie pojawia.
Opis narzędzia mówi modelowi, kiedy ma je preferować: strony wymagające JavaScriptu, PDF-y i długie odczyty. Model nadal może używać web_fetch do wszystkiego innego.
Jak read_url traktuje strony, które czyta?
Tak samo jak każde wywołanie naszego API. Respektujemy robots.txt: nasz crawler identyfikuje się jako WebReaderAPI, przestrzega reguł napisanych dla niego lub dla wszystkich robotów i nie czyta strony, której witryna zabrania. Odrzucone strony nie są obciążane opłatą. Jeśli witryna zadeklaruje Content-Signal: ai-input=no w swoim robots.txt, nie czytamy jej stron dla Ciebie. Jeśli witryna odrzuci nasze zapytanie, zwracamy jej odpowiedź: nigdy nie rozwiązujemy CAPTCHA, nie logujemy się do kont ani nie próbujemy obejść blokady lub paywalla.
Strony za logowaniem są więc poza zakresem read_url. Do strony, na której jesteś zalogowany, właściwym narzędziem jest własne narzędzie przeglądarki OpenClaw działające z Twoją sesją.
Ile będzie kosztować czytanie stron przez OpenClaw?
Jeden kredyt za stronę, która wraca z treścią, dwa, gdy potrzebna jest przeglądarka, nic za odmowy i błędy. Asystent, który czyta 30 stron dziennie w swoich kanałach czatu, zużywa około 900 kredytów miesięcznie: 10 000 stron (3,75 USD) wystarcza blisko na rok. Przedpłacone kredyty nigdy nie wygasają: niewykorzystane strony pozostają na Twoim koncie, dopóki ich nie wykorzystasz.
Daj OpenClaw osobny klucz API, żeby jego użycie było widoczne osobno od Twoich innych projektów.
OpenClaw: najczęstsze pytania
Czy WebReaderAPI to wbudowany provider OpenClaw?
Nie. Łączy się jako serwer MCP, który OpenClaw obsługuje bez żadnego kodu wtyczki. Serwer MCP to krótki plik Python z naszej strony MCP.
Czy powinienem wyłączyć web_fetch?
Nie ma potrzeby. Oba narzędzia mogą zostać włączone; opisy mówią modelowi, które pasuje. Wyłącz web_fetch tylko wtedy, gdy chcesz, żeby każdy odczyt przechodził przez jedno miejsce do logowania.
Czy mogę zarządzać serwerem z interfejsu web OpenClaw?
Dokumentacja OpenClaw opisuje ustawienia MCP w jego Control UI, które edytują te same zapisane definicje co wiersz poleceń. Używaj tego, co wolisz.
Czy działa w środowisku OpenClaw w sandboxie?
Serwer MCP to lokalny proces, który potrzebuje dostępu do internetu, żeby dotrzeć do https://webreaderapi.com/api/v1/read. Sprawdź, czy Twój sandbox pozwala procesowi wystartować i wykonać to wywołanie HTTPS.
Źródła (4)
- Narzędzia webowe — OpenClaw docs (read 2026-10-22)
- Web Fetch — OpenClaw docs (read 2026-10-22)
- Zarządzaj zapisanymi serwerami MCP — OpenClaw docs (read 2026-10-22)
- MCP w Control UI — OpenClaw docs (read 2026-10-22)