Integrazione con WordPress REST API

Questa guida mostra come usare OpenClaw Ultra per gestire il tuo sito WordPress — pubblicare articoli, gestire prodotti WooCommerce, selezionare categorie e inserire hashtag — tutto tramite l'API REST di WordPress.

Cosa ti serve

• Un sito WordPress self-hosted (wordpress.org, non wordpress.com)
• Il plugin Basic Auth installato sul tuo sito WordPress
• OpenClaw Ultra installato sul tuo desktop Windows

Passo 1: Installare il plugin Basic Auth

L'API REST di WordPress richiede autenticazione. Il modo più semplice è usare il plugin Basic Auth.

1. Scarica il plugin da: https://github.com/WP-API/Basic-Auth
2. Nel pannello di amministrazione WordPress, vai su Plugin → Aggiungi nuovo → Carica plugin
3. Carica il file Basic-Auth-master.zip scaricato
4. Clicca su Attiva

Autenticazione alternativa

Se il tuo server supporta OAuth o le Password dell'applicazione (WordPress 5.6+), puoi usarli. Questa guida usa Basic Auth per semplicità.

Passo 2: Creare un file .env per le credenziali

Crea un file .env in una posizione sicura del tuo computer per memorizzare le credenziali del tuo sito WordPress.

Crea un file chiamato wordpress.env con il seguente contenuto:

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

Proteggi il tuo file .env

Non inviare mai il tuo file .env nel version control né condividerlo pubblicamente. Aggiungi *.env al tuo file .gitignore.

Passo 3: Configurare OpenClaw Ultra per leggere il file .env

In OpenClaw Ultra, puoi usare la skill File per leggere il tuo file .env e caricare le credenziali.

1. Apri OpenClaw Ultra
2. Nella chat, digita:

Leggi il file in C:\percorso\verso\wordpress.env e memorizza ogni riga come variabile.

3. OpenClaw Ultra analizzerà il file .env e renderà i valori disponibili per le richieste successive.

Passo 4: Pubblicare un articolo WordPress tramite API REST

Ora puoi usare OpenClaw Ultra per creare e pubblicare articoli WordPress automaticamente.

Esempio di prompt:

Usando l'API REST di WordPress su {WP_SITE_URL}/wp-json/wp/v2/posts,
crea un nuovo articolo con:
- 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

Usa Basic Auth con utente {WP_USERNAME} e password {WP_APPLICATION_PASSWORD}.

OpenClaw Ultra invierà una richiesta POST all'endpoint dell'API REST di WordPress e pubblicherà il tuo articolo.

Riferimento endpoint API

Azione	Endpoint	Method
Creare articolo	/wp-json/wp/v2/posts	POST
Aggiornare articolo	/wp-json/wp/v2/posts/{id}	PUT
Ottenere articoli	/wp-json/wp/v2/posts	GET
Eliminare articolo	/wp-json/wp/v2/posts/{id}	DELETE

Passo 5: Gestire prodotti WooCommerce

Se WooCommerce è installato, puoi anche gestire i prodotti tramite l'API REST di WooCommerce.

Esempio di prompt:

Usando l'API REST di WooCommerce su {WP_SITE_URL}/wp-json/wc/v3/products,
crea un nuovo prodotto con:
- 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

Usa Basic Auth con utente {WP_USERNAME} e password {WP_APPLICATION_PASSWORD}.

Endpoint API WooCommerce

Azione	Endpoint	Method
Creare prodotto	/wp-json/wc/v3/products	POST
Ottenere prodotti	/wp-json/wc/v3/products	GET
Aggiornare prodotto	/wp-json/wc/v3/products/{id}	PUT
Eliminare prodotto	/wp-json/wc/v3/products/{id}	DELETE
Ottenere ordini	/wp-json/wc/v3/orders	GET
Creare categoria	/wp-json/wc/v3/products/categories	POST

Passo 6: Selezionare categorie

Prima di assegnare categorie ai tuoi articoli, potresti aver bisogno di trovare gli ID delle categorie esistenti.

Prompt per ottenere le categorie:

Usando l'API REST di WordPress su {WP_SITE_URL}/wp-json/wp/v2/categories,
elenca tutte le categorie del sito.

Usa Basic Auth con utente {WP_USERNAME} e password {WP_APPLICATION_PASSWORD}.

Per creare una nuova categoria:

Crea una nuova categoria chiamata "AI Tutorials" tramite:
POST {WP_SITE_URL}/wp-json/wp/v2/categories
con nome "AI Tutorials" e slug "ai-tutorials".

Usa Basic Auth con utente {WP_USERNAME} e password {WP_APPLICATION_PASSWORD}.

Passo 7: Inserire hashtag automaticamente

Puoi chiedere a OpenClaw Ultra di generare e aggiungere hashtag pertinenti ai tuoi articoli.

Esempio di prompt:

Per l'articolo intitolato "My First Automated Post" su {WP_SITE_URL},
genera 5 hashtag pertinenti basati sul suo contenuto e aggiungili all'articolo.

Usa l'API REST di WordPress per aggiornare i tag o i campi personalizzati dell'articolo.
Usa Basic Auth con utente {WP_USERNAME} e password {WP_APPLICATION_PASSWORD}.

Risoluzione dei problemi

Errore 401 Non autorizzato

• Assicurati che il plugin Basic Auth sia attivato
• Verifica che il tuo nome utente e password siano corretti
• Controlla che il tuo sito WordPress usi HTTPS

404 Endpoint non trovato

• Assicurati che i permalink parlanti siano attivati in Impostazioni → Permalink
• Verifica che l'API REST sia accessibile: {WP_SITE_URL}/wp-json/

403 Vietato / Bloccato da Cloudflare

Se ricevi un errore 403, Cloudflare potrebbe bloccare la richiesta API. Questo accade perché le richieste all'API REST di WordPress da strumenti automatizzati possono essere segnalate come sospette.

Soluzione — Impostare un header User-Agent personalizzato:

Quando fai richieste tramite OpenClaw Ultra, imposta esplicitamente una stringa User-Agent comune in modo che Cloudflare tratti la richiesta come proveniente da un browser reale. Ad esempio:

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

Nel tuo prompt di OpenClaw Ultra, includi l'header User-Agent in questo modo:

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

Endpoint WooCommerce non disponibile

• Assicurati che il plugin WooCommerce sia installato e attivato
• L'API WooCommerce richiede WooCommerce 3.0+

Passi successivi

• Esplora altri endpoint dell'API REST di WordPress
• Automatizza i programmi di pubblicazione dei contenuti
• Crea un flusso di lavoro completo per i contenuti con OpenClaw Ultra

Continua con altre guide di integrazione per espandere le tue capacità di automazione.