Integracja z WordPress REST API

Ten przewodnik pokazuje, jak używać OpenClaw Ultra do zarządzania Twoją witryną WordPress — publikowania postów, zarządzania produktami WooCommerce, wybierania kategorii i wypełniania hashtagów — wszystko przez WordPress REST API.

Czego potrzebujesz

• Samodzielnie hostowana witryna WordPress (wordpress.org, nie wordpress.com)
• Wtyczka Basic Auth zainstalowana na Twojej witrynie WordPress
• OpenClaw Ultra zainstalowany na Twoim pulpicie Windows

Krok 1: Zainstaluj wtyczkę Basic Auth

WordPress REST API wymaga uwierzytelnienia. Najłatwiejszym sposobem jest użycie wtyczki Basic Auth.

1. Pobierz wtyczkę z: https://github.com/WP-API/Basic-Auth
2. W panelu administracyjnym WordPress przejdź do Wtyczki → Dodaj nową → Wyślij wtyczkę
3. Wyślij pobrany plik Basic-Auth-master.zip
4. Kliknij Aktywuj

Alternatywne uwierzytelnianie

Jeśli Twój serwer obsługuje OAuth lub Hasła aplikacji (WordPress 5.6+), możesz ich użyć. Ten przewodnik używa Basic Auth dla prostoty.

Krok 2: Utwórz plik .env dla danych logowania

Utwórz plik .env w bezpiecznym miejscu na swoim komputerze, aby przechowywać dane logowania do witryny WordPress.

Utwórz plik o nazwie wordpress.env z następującą treścią:

WP_SITE_URL=https://yoursite.com
WP_USERNAME=your-admin-username
WP_APPLICATION_PASSWORD=your-password

Zabezpiecz swój plik .env

Nigdy nie dodawaj pliku .env do systemu kontroli wersji ani nie udostępniaj go publicznie. Dodaj *.env do swojego pliku .gitignore.

Krok 3: Skonfiguruj OpenClaw Ultra do odczytu pliku .env

W OpenClaw Ultra możesz użyć umiejętności File do odczytu pliku .env i załadowania danych logowania.

1. Otwórz OpenClaw Ultra
2. Na czacie wpisz:

Odczytaj plik z C:\ścieżka\do\wordpress.env i zapisz każdą linię jako zmienną.

3. OpenClaw Ultra przeanalizuje plik .env i udostępni wartości do kolejnych żądań.

Krok 4: Opublikuj post WordPress przez REST API

Teraz możesz używać OpenClaw Ultra do automatycznego tworzenia i publikowania postów WordPress.

Przykładowe polecenie:

Używając WordPress REST API pod adresem {WP_SITE_URL}/wp-json/wp/v2/posts,
utwórz nowy post z:
- Title: "My First Automated Post"
- Content: "This post was created by OpenClaw Ultra via the WordPress REST API."
- Status: publish
- Categories: Technology, AI
- Hashtags: #WordPress #Automation #OpenClaw

Użyj Basic Auth z nazwą użytkownika {WP_USERNAME} i hasłem {WP_APPLICATION_PASSWORD}.

OpenClaw Ultra wyśle żądanie POST do punktu końcowego WordPress REST API i opublikuje Twój post.

Odnośnik punktów końcowych API

Akcja	Endpoint	Method
Utwórz post	/wp-json/wp/v2/posts	POST
Zaktualizuj post	/wp-json/wp/v2/posts/{id}	PUT
Pobierz posty	/wp-json/wp/v2/posts	GET
Usuń post	/wp-json/wp/v2/posts/{id}	DELETE

Krok 5: Zarządzaj produktami WooCommerce

Jeśli masz zainstalowane WooCommerce, możesz również zarządzać produktami przez REST API WooCommerce.

Przykładowe polecenie:

Używając REST API WooCommerce pod adresem {WP_SITE_URL}/wp-json/wc/v3/products,
utwórz nowy produkt z:
- Name: "AI Automation Course"
- Type: simple
- Regular price: 49.99
- Description: "Learn how to automate your workflows with AI."
- Categories: Courses, Digital Products
- Stock: 100

Użyj Basic Auth z nazwą użytkownika {WP_USERNAME} i hasłem {WP_APPLICATION_PASSWORD}.

Punkty końcowe API WooCommerce

Akcja	Endpoint	Method
Utwórz produkt	/wp-json/wc/v3/products	POST
Pobierz produkty	/wp-json/wc/v3/products	GET
Zaktualizuj produkt	/wp-json/wc/v3/products/{id}	PUT
Usuń produkt	/wp-json/wc/v3/products/{id}	DELETE
Pobierz zamówienia	/wp-json/wc/v3/orders	GET
Utwórz kategorię	/wp-json/wc/v3/products/categories	POST

Krok 6: Wybierz kategorie

Przed przypisaniem kategorii do postów może być konieczne znalezienie istniejących ID kategorii.

Polecenie do pobrania kategorii:

Używając WordPress REST API pod adresem {WP_SITE_URL}/wp-json/wp/v2/categories,
wypisz wszystkie kategorie na stronie.

Użyj Basic Auth z nazwą użytkownika {WP_USERNAME} i hasłem {WP_APPLICATION_PASSWORD}.

Aby utworzyć nową kategorię:

Utwórz nową kategorię o nazwie "AI Tutorials" poprzez:
POST {WP_SITE_URL}/wp-json/wp/v2/categories
z nazwą "AI Tutorials" i aliasem "ai-tutorials".

Użyj Basic Auth z nazwą użytkownika {WP_USERNAME} i hasłem {WP_APPLICATION_PASSWORD}.

Krok 7: Automatyczne wypełnianie hashtagów

Możesz poprosić OpenClaw Ultra o wygenerowanie i dodanie odpowiednich hashtagów do Twoich postów.

Przykładowe polecenie:

Dla posta zatytułowanego "My First Automated Post" na {WP_SITE_URL},
wygeneruj 5 odpowiednich hashtagów na podstawie jego treści i dodaj je do posta.

Użyj WordPress REST API do zaktualizowania tagów lub pól niestandardowych posta.
Użyj Basic Auth z nazwą użytkownika {WP_USERNAME} i hasłem {WP_APPLICATION_PASSWORD}.

Rozwiązywanie problemów

Błąd 401 Nieautoryzowany

• Upewnij się, że wtyczka Basic Auth jest aktywowana
• Sprawdź, czy nazwa użytkownika i hasło są poprawne
• Sprawdź, czy Twoja witryna WordPress używa HTTPS

404 Nie znaleziono punktu końcowego

• Upewnij się, że przyjazne linki stałe są włączone w Ustawienia → Linki stałe
• Sprawdź, czy REST API jest dostępne: {WP_SITE_URL}/wp-json/

403 Zabronione / Zablokowane przez Cloudflare

Jeśli otrzymujesz błąd 403, Cloudflare może blokować żądanie API. Dzieje się tak, ponieważ żądania WordPress REST API z narzędzi zautomatyzowanych mogą być oznaczane jako podejrzane.

Rozwiązanie — Ustaw niestandardowy nagłówek User-Agent:

Podczas wysyłania żądań przez OpenClaw Ultra, jawnie ustaw popularny ciąg User-Agent, aby Cloudflare traktował żądanie jako pochodzące z prawdziwej przeglądarki. Na przykład:

User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36

W swoim poleceniu OpenClaw Ultra dołącz nagłówek User-Agent w ten sposób:

POST {WP_SITE_URL}/wp-json/wp/v2/posts
Headers:
  User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36
  Authorization: Basic {base64-encoded-credentials}

Body:
  title: "My Post"
  content: "Post content"
  status: publish

Punkt końcowy WooCommerce niedostępny

• Upewnij się, że wtyczka WooCommerce jest zainstalowana i aktywowana
• API WooCommerce wymaga WooCommerce 3.0+

Następne kroki

• Poznaj inne punkty końcowe WordPress REST API
• Automatyzuj harmonogramy publikacji treści
• Zbuduj kompletny przepływ pracy z treścią za pomocą OpenClaw Ultra

Kontynuuj z innymi przewodnikami integracji, aby rozszerzyć swoje możliwości automatyzacji.