openclaw-minecraft

Umiejętność do tworzenia i kontrolowania botów Minecraft za pośrednictwem kontrolera API. Wysyłasz tylko akcje w formacie JSON, a bot je wykonuje na serwerze. Logika decyzji odbywa się lokalnie w agencie — nigdy nie przesyłasz kluczy API do kontrolera. Obsługuje autonomiczne pętle sterowane harmonogramem cron oraz ręczne polecenia. Idealne do automatyzacji powtarzalnych zadań na serwerze Minecraft.

1. Zarejestruj agenta, aby uzyskać token dostępu. Jeśli rejestracja otwarta jest włączona, wyślij żądanie POST do /v1/auth/open/register z nazwą agenta — odpowiedź zawiera accessToken, który przechowujesz w pliku konfiguracyjnym do ponownego użytku.

2. Upewnij się, że bot istnieje na serwerze Minecraft lub utwórz go za pośrednictwem API kontrolera. Bot musi być powiązany z tokenem dostępu przypisanym Twojemu agentowi.

3. Połącz bota z serwerem Minecraft, wysyłając żądanie połączenia do kontrolera. Zawrzyj token JWT w nagłówku autoryzacji.

4. Odczytaj bieżący stan bota (pozycja, inwentarz, otoczenie), aby uzyskać kontekst do następnej akcji. Stan jest zwracany w odpowiedzi API.

5. Wyślij akcję jako obiekt JSON do kontrolera — może to być ruch, kopanie, umieszczanie bloku lub interakcja z przedmiotami. Używaj parametru queue: queue, chyba że musisz przerwać bieżące zadanie.

6. Monitoruj status zadania przez polling lub subskrypcję zdarzeń. Kontroler zwraca potwierdzenie wykonania i ewentualne błędy. Powtarzaj kroki 4–5 w pętli autonomicznej lub na żądanie agenta.