Integración con WordPress REST API

Esta guía muestra cómo usar OpenClaw Ultra para administrar tu sitio WordPress — publicar entradas, gestionar productos WooCommerce, seleccionar categorías y añadir hashtags — todo a través de la API REST de WordPress.

Requisitos previos

• Un sitio WordPress autoalojado (wordpress.org, no wordpress.com)
• El plugin Basic Auth instalado en tu sitio WordPress
• OpenClaw Ultra instalado en tu escritorio Windows

Paso 1: Instalar el plugin Basic Auth

La API REST de WordPress requiere autenticación. La forma más sencilla es usar el plugin Basic Auth.

1. Descarga el plugin desde: https://github.com/WP-API/Basic-Auth
2. En el panel de administración de WordPress, ve a Plugins → Añadir nuevo → Subir plugin
3. Sube el archivo Basic-Auth-master.zip descargado
4. Haz clic en Activar

Autenticación alternativa

Si tu servidor es compatible con OAuth o Contraseñas de aplicación (WordPress 5.6+), puedes usarlos. Esta guía usa Basic Auth por simplicidad.

Paso 2: Crear un archivo .env para las credenciales

Crea un archivo .env en una ubicación segura de tu ordenador para guardar las credenciales de tu sitio WordPress.

Crea un archivo llamado wordpress.env con el siguiente contenido:

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

Mantén seguro tu archivo .env

Nunca subas tu archivo .env al control de versiones ni lo compartas públicamente. Añade *.env a tu archivo .gitignore.

Paso 3: Configurar OpenClaw Ultra para leer el archivo .env

En OpenClaw Ultra, puedes usar la habilidad File para leer tu archivo .env y cargar las credenciales.

1. Abrir OpenClaw Ultra
2. En el chat, escribe:

Lee el archivo en C:\ruta\hacia\wordpress.env y guarda cada línea como una variable.

3. OpenClaw Ultra analizará el archivo .env y pondrá los valores a disposición de las siguientes solicitudes.

Paso 4: Publicar una entrada de WordPress mediante la API REST

Ahora puedes usar OpenClaw Ultra para crear y publicar entradas de WordPress automáticamente.

Ejemplo de instrucción:

Usando la API REST de WordPress en {WP_SITE_URL}/wp-json/wp/v2/posts,
crea una nueva entrada 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 usuario {WP_USERNAME} y contraseña {WP_APPLICATION_PASSWORD}.

OpenClaw Ultra enviará una solicitud POST al endpoint de la API REST de WordPress y publicará tu entrada.

Referencia de endpoints de la API

Acción	Endpoint	Method
Crear entrada	/wp-json/wp/v2/posts	POST
Actualizar entrada	/wp-json/wp/v2/posts/{id}	PUT
Obtener entradas	/wp-json/wp/v2/posts	GET
Eliminar entrada	/wp-json/wp/v2/posts/{id}	DELETE

Paso 5: Gestionar productos WooCommerce

Si tienes WooCommerce instalado, también puedes gestionar productos mediante la API REST de WooCommerce.

Ejemplo de instrucción:

Usando la API REST de WooCommerce en {WP_SITE_URL}/wp-json/wc/v3/products,
crea un nuevo producto 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 usuario {WP_USERNAME} y contraseña {WP_APPLICATION_PASSWORD}.

Endpoints de la API de WooCommerce

Acción	Endpoint	Method
Crear producto	/wp-json/wc/v3/products	POST
Obtener productos	/wp-json/wc/v3/products	GET
Actualizar producto	/wp-json/wc/v3/products/{id}	PUT
Eliminar producto	/wp-json/wc/v3/products/{id}	DELETE
Obtener pedidos	/wp-json/wc/v3/orders	GET
Crear categoría	/wp-json/wc/v3/products/categories	POST

Paso 6: Seleccionar categorías

Antes de asignar categorías a tus entradas, puede que necesites encontrar los IDs de categorías existentes.

Instrucción para obtener categorías:

Usando la API REST de WordPress en {WP_SITE_URL}/wp-json/wp/v2/categories,
lista todas las categorías del sitio.

Usa Basic Auth con usuario {WP_USERNAME} y contraseña {WP_APPLICATION_PASSWORD}.

Para crear una nueva categoría:

Crea una nueva categoría llamada "AI Tutorials" mediante:
POST {WP_SITE_URL}/wp-json/wp/v2/categories
con nombre "AI Tutorials" y slug "ai-tutorials".

Usa Basic Auth con usuario {WP_USERNAME} y contraseña {WP_APPLICATION_PASSWORD}.

Paso 7: Rellenar hashtags automáticamente

Puedes pedir a OpenClaw Ultra que genere y añada hashtags relevantes a tus entradas.

Ejemplo de instrucción:

Para la entrada titulada "My First Automated Post" en {WP_SITE_URL},
genera 5 hashtags relevantes basados en su contenido y añádelos a la entrada.

Usa la API REST de WordPress para actualizar las etiquetas o campos personalizados de la entrada.
Usa Basic Auth con usuario {WP_USERNAME} y contraseña {WP_APPLICATION_PASSWORD}.

Solución de problemas

Error 401 No autorizado

• Asegúrate de que el plugin Basic Auth está activado
• Verifica que tu usuario y contraseña son correctos
• Comprueba que tu sitio WordPress usa HTTPS

404 Endpoint no encontrado

• Asegúrate de que los enlaces permanentes están activados en Ajustes → Enlaces permanentes
• Verifica que la API REST es accesible: {WP_SITE_URL}/wp-json/

403 Prohibido / Bloqueado por Cloudflare

Si obtienes un error 403, Cloudflare puede estar bloqueando la solicitud a la API. Esto ocurre porque las solicitudes a la API REST de WordPress desde herramientas automatizadas pueden marcarse como sospechosas.

Solución — Establecer un encabezado User-Agent personalizado:

Al hacer solicitudes mediante OpenClaw Ultra, establece explícitamente una cadena User-Agent común para que Cloudflare trate la solicitud como si viniera de un navegador real. Por ejemplo:

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

En tu instrucción de OpenClaw Ultra, incluye el encabezado User-Agent así:

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 de WooCommerce no disponible

• Asegúrate de que el plugin WooCommerce está instalado y activado
• La API de WooCommerce requiere WooCommerce 3.0+

Próximos pasos

• Explora otros endpoints de la API REST de WordPress
• Automatiza los horarios de publicación de contenido
• Construye un flujo de trabajo completo de contenido con OpenClaw Ultra

Continúa con otras guías de integración para ampliar tus capacidades de automatización.