Ogólne

OpenClaw AGENTS.md: praktyczne instrukcje dla agentów AI

Najkrótsza odpowiedź: dobry AGENTS.md zamienia ogólnego agenta AI w przewidywalnego współpracownika. W OpenClaw warto traktować ten plik jak instrukcję operacyjną: ma mówić, co agent może robić sam, kiedy ma pytać i gdzie odkładać wiedzę, która ma przetrwać restart sesji.

Ten wpis pokazuje praktyczny układ instrukcji, który sprawdza się w codziennych automatyzacjach: od prostych cronów po dłuższe workflowy z pamięcią i skillami.

Dlaczego AGENTS.md ma znaczenie

Agent bez lokalnych zasad musi za każdym razem zgadywać kontekst projektu. Agent z dobrym AGENTS.md wie, jak pracować w danym katalogu, jakie są granice bezpieczeństwa i które pliki są źródłem prawdy.

Największa korzyść nie polega na dłuższych instrukcjach. Chodzi o zmniejszenie liczby niejawnych decyzji: gdzie zapisać notatkę, czy wolno wysłać wiadomość, jak formatować odpowiedzi i kiedy nie dotykać prywatnych danych.

Minimalny szablon dla OpenClaw

Dobry plik może być krótki. W praktyce wystarczy kilka sekcji, które agent rozumie bez dodatkowego tłumaczenia:

  • Rola: kim agent jest w tym workspace i jaki ma styl pracy.
  • Źródła kontekstu: które pliki czytać na starcie, a których nie używać publicznie.
  • Granice: co wolno robić samodzielnie, a co wymaga potwierdzenia.
  • Pamięć: gdzie zapisywać decyzje, wnioski i rzeczy do zapamiętania.
  • Komunikacja: kiedy odpowiadać, kiedy reagować krótko, a kiedy milczeć.
  • Narzędzia: lokalne nazwy urządzeń, usług, paneli i bezpieczne procedury.

Co zapisać konkretnie

Decyzje zamiast życzeń

Zamiast pisać: „bądź pomocny”, lepiej podać regułę: „gdy użytkownik prosi o publikację wpisu, najpierw utwórz draft, sprawdź format, dopiero potem publikuj”. Agent może wykonać taką instrukcję bez interpretowania intencji.

Granice publicznych działań

Każda akcja, która wychodzi poza komputer użytkownika, powinna mieć jasną zasadę. Publikacja wpisu, wysłanie maila, zmiana dostępu do strony albo post w Slacku to działania o innym ryzyku niż czytanie lokalnego pliku.

Ścieżki do pamięci

Jeżeli agent ma coś pamiętać, wskaż plik. Dobrym wzorcem jest połączenie dziennych notatek, na przykład memory/YYYY-MM-DD.md, z krótszą pamięcią długoterminową. Dzięki temu surowy log nie miesza się z wiedzą, która ma być trwała.

Przykład workflowu

Dla zadania publikacyjnego instrukcja może wyglądać tak:

  1. Sprawdź istniejące wpisy, żeby nie powielać tematu.
  2. Wybierz jeden praktyczny problem użytkownika OpenClaw.
  3. Napisz treść w HTML przyjaznym dla edytora.
  4. Utwórz draft i zweryfikuj go w panelu.
  5. Opublikuj dopiero po sprawdzeniu publicznego URL.
  6. Na końcu sprawdź kodowanie, linki wewnętrzne i renderowanie nagłówków.

Taki workflow jest prosty, ale zamyka najczęstsze błędy: duplikaty, źle zakodowane polskie znaki, escaped HTML i brak kontroli po publikacji.

Ograniczenia

  • AGENTS.md nie zastępuje testów, walidacji ani sprawdzania efektu końcowego.
  • Nie warto wkładać do niego haseł, tokenów ani prywatnych danych, które mogą trafić do publicznej odpowiedzi.
  • Zbyt długi plik obniża skuteczność, bo agent musi przetwarzać wiele zasad o niskiej wartości.
  • Instrukcje trzeba aktualizować, gdy zmienia się panel, proces publikacji albo struktura katalogów.

FAQ

Czy AGENTS.md zastępuje skille?

Nie. AGENTS.md opisuje lokalne zasady workspace, a skill opisuje powtarzalną procedurę lub integrację. Jeżeli ten sam proces ma być używany w wielu miejscach, lepiej przenieść go do skilla.

Czy można mieć wiele takich plików?

Tak. W praktyce warto mieć ogólne instrukcje dla workspace i bardziej szczegółowe zasady w katalogach projektów. Agent powinien korzystać z najbliższego kontekstu.

Jak często aktualizować instrukcje?

Po każdej istotnej zmianie procesu. Jeżeli agent raz popełnił błąd, a przyczyna wynikała z brakującej reguły, dopisz ją od razu.

Powiązane artykuły

Jeżeli wdrażasz OpenClaw w zespole, zacznij od krótkiego AGENTS.md dla jednego workflowu. Potem dopiero dodawaj pamięć, skille i automatyczne crony tam, gdzie naprawdę zmniejszają liczbę ręcznych decyzji.

← Wrocz do bloga