Intégration WordPress REST API

Ce guide montre comment utiliser OpenClaw Ultra pour gérer votre site WordPress — publier des articles, gérer des produits WooCommerce, sélectionner des catégories et ajouter des hashtags — le tout via l'API REST WordPress.

Prérequis

• Un site WordPress auto-hébergé (wordpress.org, pas wordpress.com)
• Le plugin Basic Auth installé sur votre site WordPress
• OpenClaw Ultra installé sur votre bureau Windows

Étape 1 : Installer le plugin Basic Auth

L'API REST WordPress nécessite une authentification. La façon la plus simple est d'utiliser le plugin Basic Auth.

1. Téléchargez le plugin depuis : https://github.com/WP-API/Basic-Auth
2. Dans le panneau d'administration WordPress, allez dans Extensions → Ajouter → Téléverser une extension
3. Téléversez le fichier Basic-Auth-master.zip téléchargé
4. Cliquez sur Activer

Authentification alternative

Si votre serveur prend en charge OAuth ou les mots de passe d'application (WordPress 5.6+), vous pouvez les utiliser. Ce guide utilise Basic Auth par simplicité.

Étape 2 : Créer un fichier .env pour les identifiants

Créez un fichier .env dans un endroit sécurisé de votre ordinateur pour stocker les identifiants de votre site WordPress.

Créez un fichier nommé wordpress.env avec le contenu suivant :

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

Protégez votre fichier .env

Ne committez jamais votre fichier .env dans le contrôle de version et ne le partagez pas publiquement. Ajoutez *.env à votre fichier .gitignore.

Étape 3 : Configurer OpenClaw Ultra pour lire le fichier .env

Dans OpenClaw Ultra, vous pouvez utiliser la compétence File pour lire votre fichier .env et charger les identifiants.

1. Ouvrir OpenClaw Ultra
2. Dans le chat, tapez :

Lisez le fichier situé à C:\chemin\vers\wordpress.env et stockez chaque ligne comme une variable.

3. OpenClaw Ultra analysera le fichier .env et rendra les valeurs disponibles pour les requêtes suivantes.

Étape 4 : Publier un article WordPress via l'API REST

Vous pouvez maintenant utiliser OpenClaw Ultra pour créer et publier des articles WordPress automatiquement.

Exemple d'instruction :

En utilisant l'API REST WordPress sur {WP_SITE_URL}/wp-json/wp/v2/posts,
créez un nouvel article avec :
- 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

Utilisez Basic Auth avec l'utilisateur {WP_USERNAME} et le mot de passe {WP_APPLICATION_PASSWORD}.

OpenClaw Ultra enverra une requête POST à l'endpoint de l'API REST WordPress et publiera votre article.

Référence des endpoints API

Action	Endpoint	Method
Créer un article	/wp-json/wp/v2/posts	POST
Mettre à jour un article	/wp-json/wp/v2/posts/{id}	PUT
Obtenir les articles	/wp-json/wp/v2/posts	GET
Supprimer un article	/wp-json/wp/v2/posts/{id}	DELETE

Étape 5 : Gérer les produits WooCommerce

Si WooCommerce est installé, vous pouvez également gérer les produits via l'API REST WooCommerce.

Exemple d'instruction :

En utilisant l'API REST WooCommerce sur {WP_SITE_URL}/wp-json/wc/v3/products,
créez un nouveau produit avec :
- 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

Utilisez Basic Auth avec l'utilisateur {WP_USERNAME} et le mot de passe {WP_APPLICATION_PASSWORD}.

Endpoints de l'API WooCommerce

Action	Endpoint	Method
Créer un produit	/wp-json/wc/v3/products	POST
Obtenir les produits	/wp-json/wc/v3/products	GET
Mettre à jour un produit	/wp-json/wc/v3/products/{id}	PUT
Supprimer un produit	/wp-json/wc/v3/products/{id}	DELETE
Obtenir les commandes	/wp-json/wc/v3/orders	GET
Créer une catégorie	/wp-json/wc/v3/products/categories	POST

Étape 6 : Sélectionner les catégories

Avant d'attribuer des catégories à vos articles, vous devrez peut-être trouver les IDs des catégories existantes.

Instruction pour obtenir les catégories :

En utilisant l'API REST WordPress sur {WP_SITE_URL}/wp-json/wp/v2/categories,
listez toutes les catégories du site.

Utilisez Basic Auth avec l'utilisateur {WP_USERNAME} et le mot de passe {WP_APPLICATION_PASSWORD}.

Pour créer une nouvelle catégorie :

Créez une nouvelle catégorie appelée "AI Tutorials" via :
POST {WP_SITE_URL}/wp-json/wp/v2/categories
avec le nom "AI Tutorials" et le slug "ai-tutorials".

Utilisez Basic Auth avec l'utilisateur {WP_USERNAME} et le mot de passe {WP_APPLICATION_PASSWORD}.

Étape 7 : Remplir les hashtags automatiquement

Vous pouvez demander à OpenClaw Ultra de générer et d'ajouter des hashtags pertinents à vos articles.

Exemple d'instruction :

Pour l'article intitulé "My First Automated Post" sur {WP_SITE_URL},
générez 5 hashtags pertinents basés sur son contenu et ajoutez-les à l'article.

Utilisez l'API REST WordPress pour mettre à jour les étiquettes ou les champs personnalisés de l'article.
Utilisez Basic Auth avec l'utilisateur {WP_USERNAME} et le mot de passe {WP_APPLICATION_PASSWORD}.

Dépannage

Erreur 401 Non autorisé

• Assurez-vous que le plugin Basic Auth est activé
• Vérifiez que votre nom d'utilisateur et mot de passe sont corrects
• Vérifiez que votre site WordPress utilise HTTPS

404 Endpoint non trouvé

• Assurez-vous que les permaliens sont activés dans Réglages → Permaliens
• Vérifiez que l'API REST est accessible : {WP_SITE_URL}/wp-json/

403 Interdit / Bloqué par Cloudflare

Si vous obtenez une erreur 403, Cloudflare bloque peut-être la requête API. Cela se produit car les requêtes à l'API REST WordPress provenant d'outils automatisés peuvent être signalées comme suspectes.

Solution — Définir un en-tête User-Agent personnalisé :

Lorsque vous faites des requêtes via OpenClaw Ultra, définissez explicitement une chaîne User-Agent commune pour que Cloudflare traite la requête comme provenant d'un vrai navigateur. Par exemple :

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

Dans votre instruction OpenClaw Ultra, incluez l'en-tête User-Agent comme ceci :

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 disponible

• Assurez-vous que le plugin WooCommerce est installé et activé
• L'API WooCommerce nécessite WooCommerce 3.0+

Prochaines étapes

• Explorez d'autres endpoints de l'API REST WordPress
• Automatisez les plannings de publication de contenu
• Créez un flux de travail de contenu complet avec OpenClaw Ultra

Poursuivez avec d'autres guides d'intégration pour étendre vos capacités d'automatisation.