Overview

Przegląd

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.

Jeśli chcesz...	Najpierw użyj	Następnie przeczytaj
Umożliwić agentowi działanie przy użyciu istniejących możliwości	Wbudowane narzędzia	Kategorie narzędzi
Kontrolować, co agent może wywoływać	Zasady narzędzi	Narzędzia i niestandardowi dostawcy
Nauczyć agenta przepływu pracy	Skills	Skills, Tworzenie Skills i Warsztat Skills
Dodać nową integrację lub powierzchnię środowiska uruchomieniowego	Pluginy	Pluginy i Tworzenie pluginów
Uruchomić zadanie później lub w tle	Automatyzacja	Przegląd automatyzacji
Koordynować wielu agentów lub środowiska wykonawcze	Agenci podrzędni	Agenci ACP i Wysyłanie przez agenta
Przeszukać duży katalog narzędzi OpenClaw	Wyszukiwanie narzędzi	Wyszukiwanie narzędzi

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

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.

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

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.

Kategoria	Użyj, gdy agent musi...	Reprezentatywne narzędzia	Następnie przeczytaj
Środowisko uruchomieniowe	Uruchamiać polecenia, zarządzać procesami lub używać analizy Python obsługiwanej przez dostawcę	`exec`, `process`, `code_execution`	Exec, Wykonywanie kodu
Pliki	Odczytywać i zmieniać pliki przestrzeni roboczej	`read`, `write`, `edit`, `apply_patch`	Stosowanie poprawki
Internet	Przeszukiwać internet i wpisy w serwisie X lub pobierać czytelną treść stron	`web_search`, `x_search`, `web_fetch`	Narzędzia internetowe, Pobieranie treści z internetu
Przeglądarka	Obsługiwać sesję przeglądarki	`browser`	Przeglądarka
Wiadomości i kanały	Wysyłać odpowiedzi lub wykonywać działania w kanałach	`message`	Wysyłanie przez agenta
Sesje i agenci	Sprawdzać sesje, delegować pracę, sterować innym uruchomieniem lub raportować stan	`sessions_*`, `subagents`, `agents_list`, `session_status`, `get_goal`, `create_goal`, `update_goal`	Cel, Agenci podrzędni, Narzędzie sesji
Automatyzacja	Planować zadania lub reagować na zdarzenia w tle	`cron`, `heartbeat_respond`	Automatyzacja
Gateway i węzły	Sprawdzać stan Gateway lub sparowane urządzenia docelowe	`gateway`, `nodes`	Konfiguracja Gateway, Węzły
Multimedia	Analizować, generować lub odtwarzać głosowo multimedia	`image`, `image_generate`, `music_generate`, `video_generate`, `tts`	Przegląd multimediów
Duże katalogi OpenClaw	Wyszukiwać i wywoływać wiele kwalifikujących się narzędzi bez przesyłania każdego schematu do modelu	`tool_search_code`, `tool_search`, `tool_describe`	Wyszukiwanie narzędzi

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.

Narzędzia i niestandardowi dostawcy opisują profile narzędzi, listy zezwoleń i blokad, ograniczenia specyficzne dla dostawców, wykrywanie pętli oraz ustawienia narzędzi obsługiwanych przez dostawców.
Zatwierdzanie Exec opisuje zasady zatwierdzania poleceń hosta.
Exec z podwyższonymi uprawnieniami opisuje kontrolowane wykonywanie poza piaskownicą.
Piaskownica a zasady narzędzi a podwyższone uprawnienia wyjaśnia, która warstwa kontroluje dostęp do plików i procesów.
Ograniczenia piaskownicy i narzędzi dla poszczególnych agentów opisują ograniczenia dotyczące agentów w delegowanych uruchomieniach.

Rozszerzanie możliwości

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

Zainstaluj istniejący plugin lub zarządzaj nim za pomocą sekcji Pluginy.
Utwórz nową integrację, dostawcę, kanał, narzędzie lub hook, korzystając z sekcji Tworzenie pluginów.
Dodaj lub dostosuj instrukcje agenta wielokrotnego użytku za pomocą sekcji Skills i Tworzenie Skills.
Użyj SDK pluginów i Manifestu pluginu, gdy potrzebujesz kontraktów implementacyjnych.

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:

Sprawdź aktywny profil, tools.allow i tools.deny w sekcji Narzędzia i niestandardowi dostawcy.
Sprawdź ograniczenia specyficzne dla dostawcy w sekcji Narzędzia i niestandardowi dostawcy i potwierdź, że wybrany dostawca modelu obsługuje daną postać narzędzia.
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.
Sprawdź w sekcji Pluginy, czy plugin będący właścicielem narzędzia jest zainstalowany i włączony.
W przypadku delegowanych uruchomień sprawdź ograniczenia poszczególnych agentów w sekcji Ograniczenia piaskownicy i narzędzi dla poszczególnych agentów.
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

Was this useful?