Skip to main content
Użyj tej strony, aby wybrać odpowiednią powierzchnię możliwości. Narzędzia udostępniają działania, które można wywoływać, Skills uczą agentów sposobu pracy, a pluginy dodają możliwości środowiska uruchomieniowego, takie jak narzędzia, dostawcy, kanały, hooki i pakiety Skills. Ta strona zawiera przegląd i wskazuje właściwe sekcje dokumentacji. Pełne informacje o zasadach narzędzi, wartościach domyślnych, przynależności do grup, ograniczeniach dostawców i polach konfiguracji znajdziesz w sekcji Narzędzia i niestandardowi dostawcy.

​
Zacznij tutaj

W przypadku większości agentów zacznij od wbudowanych kategorii narzędzi, a następnie dostosuj zasady tylko wtedy, gdy agent powinien widzieć mniej narzędzi lub potrzebuje jawnego dostępu do hosta.

​
Wybór narzędzi, Skills lub pluginów

1

Użyj narzędzia, gdy agent musi wykonać działanie

Narzędzie jest funkcją z określonym typem, którą agent może wywołać, na przykład exec, browser, web_search, message lub image_generate. Używaj narzędzi, gdy agent musi odczytać dane, zmienić pliki, wysłać wiadomości, wywołać dostawcę lub obsługiwać inny system. Widoczne narzędzia są przekazywane do modelu jako ustrukturyzowane definicje funkcji.Model widzi tylko narzędzia, które pozostają dostępne po zastosowaniu aktywnego profilu, zasad zezwalania i blokowania, ograniczeń dostawcy, stanu piaskownicy, uprawnień kanału oraz dostępności pluginów.
2

Użyj Skills, gdy agent potrzebuje instrukcji

Skills to pakiet instrukcji SKILL.md ładowany do promptu agenta. Używaj Skills, gdy agent ma już potrzebne narzędzia, ale wymaga powtarzalnego przepływu pracy, kryteriów przeglądu, sekwencji poleceń lub ograniczeń operacyjnych.Skills mogą znajdować się w przestrzeni roboczej, współdzielonym katalogu Skills, zarządzanym katalogu głównym Skills OpenClaw lub pakiecie pluginu.Skills | Warsztat Skills | Tworzenie Skills | Konfiguracja Skills
3

Użyj pluginu, gdy OpenClaw potrzebuje nowej możliwości

Plugin może dodawać narzędzia, Skills, kanały, dostawców modeli, mowę, głos w czasie rzeczywistym, generowanie multimediów, wyszukiwanie w internecie, pobieranie treści z internetu, hooki i inne możliwości środowiska uruchomieniowego. Użyj pluginu, gdy dana możliwość wymaga kodu, danych uwierzytelniających, hooków cyklu życia, metadanych manifestu lub pakietu możliwego do zainstalowania. Istniejące pluginy można instalować z ClawHub, npm, git, katalogów lokalnych lub archiwów.Instalowanie i konfigurowanie pluginów | Tworzenie pluginów | SDK pluginów

​
Kategorie wbudowanych narzędzi

Tabela zawiera reprezentatywne narzędzia, aby ułatwić rozpoznanie powierzchni. Nie stanowi pełnego źródła informacji o zasadach. Dokładne informacje o grupach, wartościach domyślnych oraz semantyce zezwoleń i blokad znajdziesz w sekcji Narzędzia i niestandardowi dostawcy.
Wyszukiwanie narzędzi jest eksperymentalną powierzchnią agenta OpenClaw. Uruchomienia w środowisku Codex używają natywnego dla Codex trybu kodu, natywnego wyszukiwania narzędzi, odroczonych narzędzi dynamicznych oraz zagnieżdżonych wywołań narzędzi zamiast tools.toolSearch.

​
Narzędzia udostępniane przez pluginy

Pluginy mogą rejestrować dodatkowe narzędzia. Autorzy pluginów podłączają je za pomocą api.registerTool(...) i właściwości contracts.tools manifestu; szczegóły kontraktu znajdziesz w sekcjach SDK pluginów oraz Manifest pluginu. Typowe narzędzia udostępniane przez pluginy obejmują:
  • Różnice do renderowania różnic w plikach i Markdown
  • Wyświetlanie widżetu do samodzielnych, osadzonych elementów SVG i HTML w czacie internetowym
  • Zadanie LLM do kroków przepływu pracy zwracających wyłącznie JSON
  • Lobster do przepływów pracy z określonymi typami i wznawialnymi zatwierdzeniami
  • Tokenjuice do kompresowania nadmiarowych danych wyjściowych narzędzi exec i bash
  • Wyszukiwanie narzędzi do odkrywania i wywoływania dużych katalogów narzędzi bez umieszczania każdego schematu w prompcie
  • Canvas do sterowania Canvas węzła i renderowania A2UI

​
Konfigurowanie dostępu i zatwierdzeń

Zasady narzędzi są egzekwowane przed wywołaniem modelu. Jeśli zasady usuną narzędzie, model nie otrzyma jego schematu w danej turze. Uruchomienie może utracić narzędzia z powodu konfiguracji globalnej, konfiguracji danego agenta, zasad kanału, ograniczeń dostawcy, reguł piaskownicy, zasad kanału lub środowiska uruchomieniowego albo dostępności pluginów.

​
Rozszerzanie możliwości

Wybierz sposób rozszerzenia odpowiednio do zadania, które ma wykonywać OpenClaw:

​
Rozwiązywanie problemów z brakującymi narzędziami

Jeśli model nie widzi narzędzia lub nie może go wywołać, zacznij od sprawdzenia zasad obowiązujących w bieżącej turze:
  1. Sprawdź aktywny profil, tools.allow i tools.deny w sekcji Narzędzia i niestandardowi dostawcy.
  2. Sprawdź ograniczenia specyficzne dla dostawcy w sekcji Narzędzia i niestandardowi dostawcy i potwierdź, że wybrany dostawca modelu obsługuje daną postać narzędzia.
  3. Sprawdź uprawnienia kanału, stan piaskownicy i dostęp z podwyższonymi uprawnieniami w sekcjach Piaskownica a zasady narzędzi a podwyższone uprawnienia oraz Exec z podwyższonymi uprawnieniami.
  4. Sprawdź w sekcji Pluginy, czy plugin będący właścicielem narzędzia jest zainstalowany i włączony.
  5. W przypadku delegowanych uruchomień sprawdź ograniczenia poszczególnych agentów w sekcji Ograniczenia piaskownicy i narzędzi dla poszczególnych agentów.
  6. W przypadku dużych katalogów OpenClaw sprawdź, czy uruchomienie korzysta z bezpośredniego udostępniania narzędzi, czy z Wyszukiwania narzędzi.

​
Powiązane

  • Automatyzacja — Cron, zadania, Heartbeat, zobowiązania, hooki, stałe polecenia i TaskFlow
  • Agenci — model agenta, sesje, pamięć i koordynacja wielu agentów
  • Narzędzia i niestandardowi dostawcy — kanoniczna dokumentacja zasad dotyczących narzędzi
  • Pluginy — instalowanie Pluginów i zarządzanie nimi
  • SDK Pluginów — dokumentacja dla autorów Pluginów
  • Skills — kolejność ładowania, warunki aktywacji i konfiguracja Skills
  • Warsztat Skills — tworzenie generowanych i weryfikowanych Skills
  • Wyszukiwanie narzędzi — przeszukiwanie kompaktowego katalogu narzędzi OpenClaw