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 albo potrzebuje jawnego dostępu do hosta.| Jeśli chcesz… | Najpierw użyj | Następnie przeczytaj |
|---|---|---|
| Pozwolić agentowi działać z istniejącymi możliwościami | 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 obszar runtime | Pluginy | Pluginy i Budowanie pluginów |
| Uruchomić pracę później albo w tle | Automatyzacja | Przegląd automatyzacji |
| Koordynować wielu agentów lub harnessy | Podagenci | Agenci ACP i Wysyłanie do agenta |
| Przeszukać duży katalog narzędzi OpenClaw | Wyszukiwanie narzędzi | Wyszukiwanie narzędzi |
Wybierz narzędzia, Skills albo pluginy
Use a tool when the agent needs to act
Narzędzie to typowana funkcja, którą agent może wywołać, taka jak
exec, browser,
web_search, message albo image_generate. Używaj narzędzi, gdy agent
musi odczytać dane, zmienić pliki, wysłać wiadomości, wywołać dostawcę albo obsłużyć
inny system. Widoczne narzędzia są wysyłane do modelu jako strukturalne definicje
funkcji.Model widzi tylko narzędzia, które przejdą przez aktywny profil, zasady allow/deny,
ograniczenia dostawcy, stan sandboxa, uprawnienia kanału i dostępność
pluginów.Use a skill when the agent needs instructions
Skill to pakiet instrukcji
SKILL.md ładowany do promptu agenta. Używaj
Skill, gdy agent ma już potrzebne narzędzia, ale potrzebuje powtarzalnego
przepływu pracy, rubryki recenzji, sekwencji poleceń albo ograniczenia operacyjnego.Skills mogą znajdować się w workspace, współdzielonym katalogu Skills, zarządzanym przez OpenClaw
katalogu głównym Skills albo w pakiecie pluginu.Skills | Warsztat Skills | Tworzenie Skills | Konfiguracja SkillsUse a plugin when OpenClaw needs a new capability
Plugin może dodać narzędzia, Skills, kanały, dostawców modeli, mowę, głos w czasie rzeczywistym,
generowanie mediów, wyszukiwanie w sieci, pobieranie stron, haki i inne możliwości
runtime. Używaj pluginu, gdy dana możliwość obejmuje kod, dane uwierzytelniające,
haki cyklu życia, metadane manifestu albo instalowalne pakietowanie. Istniejące
pluginy można instalować z ClawHub, npm, git, lokalnych katalogów albo
archiwów.Instalowanie i konfigurowanie pluginów | Budowanie pluginów | Plugin SDK
Wbudowane kategorie narzędzi
Tabela pokazuje reprezentatywne narzędzia, aby ułatwić rozpoznanie obszaru. Nie jest to pełne odniesienie do zasad. Dokładne grupy, wartości domyślne oraz semantykę allow/deny znajdziesz w Narzędzia i niestandardowi dostawcy.| Kategoria | Użyj, gdy agent musi… | Reprezentatywne narzędzia | Następnie przeczytaj |
|---|---|---|---|
| Runtime | Uruchamiać polecenia, zarządzać procesami albo używać analizy Python wspieranej przez dostawcę | exec, process, code_execution | Exec, Wykonywanie kodu |
| Pliki | Odczytywać i zmieniać pliki workspace | read, write, edit, apply_patch | Apply patch |
| Sieć | Przeszukiwać sieć, przeszukiwać posty X albo pobierać czytelną treść strony | web_search, x_search, web_fetch | Narzędzia webowe, Pobieranie stron |
| Przeglądarka | Obsługiwać sesję przeglądarki | browser | Przeglądarka |
| Wiadomości i kanały | Wysyłać odpowiedzi albo akcje kanału | message | Wysyłanie do agenta |
| Sesje i agenci | Sprawdzać sesje, delegować pracę, kierować innym uruchomieniem albo raportować status | sessions_*, subagents, agents_list, session_status, goal | Cel, Podagenci, Narzędzie sesji |
| Automatyzacja | Planować pracę albo reagować na zdarzenia w tle | cron, heartbeat_respond | Automatyzacja |
| Gateway i węzły | Sprawdzać stan Gateway albo sparowane urządzenia docelowe | gateway, nodes | Konfiguracja Gateway, Węzły |
| Media | Analizować, generować albo wypowiadać media | image, image_generate, music_generate, video_generate, tts | Przegląd mediów |
| Duże katalogi OpenClaw | Wyszukiwać i wywoływać wiele kwalifikujących się narzędzi bez wysyłania każdego schematu do modelu | tool_search_code, tool_search, tool_describe | Wyszukiwanie narzędzi |
Wyszukiwanie narzędzi to eksperymentalny obszar agenta OpenClaw. Uruchomienia harnessa Codex używają
natywnego dla Codex trybu kodu, natywnego wyszukiwania narzędzi, odroczonych narzędzi dynamicznych i zagnieżdżonych
wywołań narzędzi zamiast
tools.toolSearch.Narzędzia dostarczane przez pluginy
Pluginy mogą rejestrować dodatkowe narzędzia. Autorzy pluginów podłączają narzędzia przezapi.registerTool(...) i contracts.tools manifestu; szczegóły kontraktu znajdziesz w
Plugin SDK i Manifeście pluginu.
Typowe narzędzia dostarczane przez pluginy obejmują:
- Różnice do renderowania różnic plików i markdown
- Zadanie LLM do kroków przepływu pracy wyłącznie w JSON
- Lobster do typowanych przepływów pracy z wznawialnymi zatwierdzeniami
- Tokenjuice do kompaktowania zaszumionego wyjścia narzędzi
execibash - 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 Node 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 schematu tego narzędzia w danej turze. Uruchomienie może utracić narzędzia z powodu konfiguracji globalnej, konfiguracji per agent, zasad kanału, ograniczeń dostawcy, reguł sandboxa, zasad kanału/runtime albo dostępności pluginów.- Narzędzia i niestandardowi dostawcy dokumentują profile narzędzi, listy allow/deny, ograniczenia specyficzne dla dostawcy, wykrywanie pętli i ustawienia narzędzi wspieranych przez dostawcę.
- Zatwierdzenia Exec dokumentują zasady zatwierdzania poleceń hosta.
- Podwyższone exec dokumentuje kontrolowane wykonywanie poza sandboxem.
- Sandbox kontra zasady narzędzi kontra podwyższone uprawnienia wyjaśnia, która warstwa kontroluje dostęp do plików i procesów.
- Sandbox i ograniczenia narzędzi per agent dokumentuje ograniczenia specyficzne dla agenta w delegowanych uruchomieniach.
Rozszerzanie możliwości
Wybierz ścieżkę rozszerzenia według zadania, które OpenClaw ma wykonać:- Zainstaluj istniejący plugin albo zarządzaj nim za pomocą Pluginy.
- Zbuduj nową integrację, dostawcę, kanał, narzędzie albo hak za pomocą Budowanie pluginów.
- Dodaj albo dostrój instrukcje agenta wielokrotnego użytku za pomocą Skills i Tworzenie Skills.
- Użyj Plugin SDK i Manifestu pluginu, gdy potrzebujesz kontraktów implementacyjnych.
Rozwiązywanie problemów z brakującymi narzędziami
Jeśli model nie widzi albo nie może wywołać narzędzia, zacznij od efektywnych zasad dla bieżącej tury:- Sprawdź aktywny profil,
tools.allowitools.denyw Narzędzia i niestandardowi dostawcy. - Sprawdź ograniczenia specyficzne dla dostawcy w Narzędzia i niestandardowi dostawcy i potwierdź, że wybrany dostawca modelu obsługuje kształt narzędzia.
- Sprawdź uprawnienia kanału, stan sandboxa i dostęp podwyższony za pomocą Sandbox kontra zasady narzędzi kontra podwyższone uprawnienia i Podwyższone exec.
- Sprawdź, czy właścicielski plugin jest zainstalowany i włączony w Pluginy.
- Dla delegowanych uruchomień sprawdź ograniczenia per agent w Sandbox i ograniczenia narzędzi per agent.
- Dla dużych katalogów OpenClaw potwierdź, czy uruchomienie używa bezpośredniego udostępniania narzędzi, czy Wyszukiwania narzędzi.
Powiązane
- Automatyzacja dla cron, zadań, heartbeat, zobowiązań, haków, stałych poleceń i przepływu zadań
- Agenci dla modelu agenta, sesji, pamięci i koordynacji wielu agentów
- Narzędzia i niestandardowi dostawcy jako kanoniczne odniesienie do zasad narzędzi
- Pluginy do instalowania pluginów i zarządzania nimi
- Plugin SDK jako odniesienie dla autorów pluginów
- Skills dla kolejności ładowania, bramkowania i konfiguracji Skills
- Warsztat Skills do generowanego i recenzowanego tworzenia Skills
- Wyszukiwanie narzędzi do kompaktowego odkrywania katalogu narzędzi OpenClaw