Integração com WordPress REST API

Este guia mostra como usar o OpenClaw Ultra para gerenciar seu site WordPress — publicar posts, gerenciar produtos WooCommerce, selecionar categorias e preencher hashtags — tudo através da API REST do WordPress.

O que você precisa

• Um site WordPress auto-hospedado (wordpress.org, não wordpress.com)
• O plugin Basic Auth instalado no seu site WordPress
• OpenClaw Ultra instalado no seu desktop Windows

Passo 1: Instalar o plugin Basic Auth

A API REST do WordPress requer autenticação. A maneira mais fácil é usar o plugin Basic Auth.

1. Baixe o plugin de: https://github.com/WP-API/Basic-Auth
2. No painel administrativo do WordPress, vá em Plugins → Adicionar novo → Enviar plugin
3. Envie o arquivo Basic-Auth-master.zip baixado
4. Clique em Ativar

Autenticação alternativa

Se seu servidor suportar OAuth ou Senhas de aplicativo (WordPress 5.6+), você pode usá-los. Este guia usa Basic Auth por simplicidade.

Passo 2: Criar um arquivo .env para credenciais

Crie um arquivo .env em um local seguro do seu computador para armazenar as credenciais do seu site WordPress.

Crie um arquivo chamado wordpress.env com o seguinte conteúdo:

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

Mantenha seu arquivo .env seguro

Nunca envie seu arquivo .env para o controle de versão nem o compartilhe publicamente. Adicione *.env ao seu arquivo .gitignore.

Passo 3: Configurar o OpenClaw Ultra para ler o arquivo .env

No OpenClaw Ultra, você pode usar a habilidade File para ler seu arquivo .env e carregar as credenciais.

1. Abrir OpenClaw Ultra
2. No chat, digite:

Leia o arquivo em C:\caminho\para\wordpress.env e armazene cada linha como uma variável.

3. O OpenClaw Ultra analisará o arquivo .env e disponibilizará os valores para solicitações subsequentes.

Passo 4: Publicar um post do WordPress via API REST

Agora você pode usar o OpenClaw Ultra para criar e publicar posts do WordPress automaticamente.

Exemplo de instrução:

Usando a API REST do WordPress em {WP_SITE_URL}/wp-json/wp/v2/posts,
crie um novo post com:
- 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

Use Basic Auth com usuário {WP_USERNAME} e senha {WP_APPLICATION_PASSWORD}.

O OpenClaw Ultra enviará uma solicitação POST ao endpoint da API REST do WordPress e publicará seu post.

Referência de endpoints da API

Ação	Endpoint	Method
Criar post	/wp-json/wp/v2/posts	POST
Atualizar post	/wp-json/wp/v2/posts/{id}	PUT
Obter posts	/wp-json/wp/v2/posts	GET
Excluir post	/wp-json/wp/v2/posts/{id}	DELETE

Passo 5: Gerenciar produtos WooCommerce

Se você tiver o WooCommerce instalado, também pode gerenciar produtos através da API REST do WooCommerce.

Exemplo de instrução:

Usando a API REST do WooCommerce em {WP_SITE_URL}/wp-json/wc/v3/products,
crie um novo produto com:
- 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

Use Basic Auth com usuário {WP_USERNAME} e senha {WP_APPLICATION_PASSWORD}.

Endpoints da API WooCommerce

Ação	Endpoint	Method
Criar produto	/wp-json/wc/v3/products	POST
Obter produtos	/wp-json/wc/v3/products	GET
Atualizar produto	/wp-json/wc/v3/products/{id}	PUT
Excluir produto	/wp-json/wc/v3/products/{id}	DELETE
Obter pedidos	/wp-json/wc/v3/orders	GET
Criar categoria	/wp-json/wc/v3/products/categories	POST

Passo 6: Selecionar categorias

Antes de atribuir categorias aos seus posts, você pode precisar encontrar os IDs de categorias existentes.

Instrução para obter categorias:

Usando a API REST do WordPress em {WP_SITE_URL}/wp-json/wp/v2/categories,
liste todas as categorias do site.

Use Basic Auth com usuário {WP_USERNAME} e senha {WP_APPLICATION_PASSWORD}.

Para criar uma nova categoria:

Crie uma nova categoria chamada "AI Tutorials" via:
POST {WP_SITE_URL}/wp-json/wp/v2/categories
com nome "AI Tutorials" e slug "ai-tutorials".

Use Basic Auth com usuário {WP_USERNAME} e senha {WP_APPLICATION_PASSWORD}.

Passo 7: Preencher hashtags automaticamente

Você pode pedir ao OpenClaw Ultra para gerar e adicionar hashtags relevantes aos seus posts.

Exemplo de instrução:

Para o post intitulado "My First Automated Post" em {WP_SITE_URL},
gere 5 hashtags relevantes com base em seu conteúdo e adicione-as ao post.

Use a API REST do WordPress para atualizar as tags ou campos personalizados do post.
Use Basic Auth com usuário {WP_USERNAME} e senha {WP_APPLICATION_PASSWORD}.

Solução de problemas

Erro 401 Não autorizado

• Certifique-se de que o plugin Basic Auth está ativado
• Verifique se seu nome de usuário e senha estão corretos
• Verifique se seu site WordPress usa HTTPS

404 Endpoint não encontrado

• Certifique-se de que os permalinks amigáveis estão ativados em Configurações → Permalinks
• Verifique se a API REST está acessível: {WP_SITE_URL}/wp-json/

403 Proibido / Bloqueado pelo Cloudflare

Se você receber um erro 403, o Cloudflare pode estar bloqueando a solicitação à API. Isso acontece porque solicitações à API REST do WordPress de ferramentas automatizadas podem ser sinalizadas como suspeitas.

Solução — Definir um cabeçalho User-Agent personalizado:

Ao fazer solicitações via OpenClaw Ultra, defina explicitamente uma string User-Agent comum para que o Cloudflare trate a solicitação como vindo de um navegador real. Por exemplo:

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

Na sua instrução do OpenClaw Ultra, inclua o cabeçalho User-Agent assim:

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 não disponível

• Certifique-se de que o plugin WooCommerce está instalado e ativado
• A API WooCommerce requer WooCommerce 3.0+

Próximos passos

• Explore outros endpoints da API REST do WordPress
• Automatize os cronogramas de publicação de conteúdo
• Crie um fluxo de trabalho completo de conteúdo com o OpenClaw Ultra

Continue com outros guias de integração para expandir suas capacidades de automação.