Интеграция с WordPress REST API

Это руководство показывает, как использовать OpenClaw Ultra для управления вашим сайтом WordPress — публиковать записи, управлять товарами WooCommerce, выбирать категории и заполнять хэштеги — всё через REST API WordPress.

Что вам понадобится

• Самостоятельно размещённый сайт WordPress (wordpress.org, не wordpress.com)
• Плагин Basic Auth, установленный на вашем сайте WordPress
• OpenClaw Ultra, установленный на вашем Windows-компьютере

Шаг 1: Установка плагина Basic Auth

REST API WordPress требует аутентификации. Самый простой способ — использовать плагин Basic Auth.

1. Скачайте плагин с: https://github.com/WP-API/Basic-Auth
2. В панели администратора WordPress перейдите в Плагины → Добавить новый → Загрузить плагин
3. Загрузите скачанный файл Basic-Auth-master.zip
4. Нажмите Активировать

Альтернативная аутентификация

Если ваш сервер поддерживает OAuth или Пароли приложений (WordPress 5.6+), вы можете использовать их. В этом руководстве для простоты используется Basic Auth.

Шаг 2: Создание файла .env для учётных данных

Создайте файл .env в безопасном месте на вашем компьютере для хранения учётных данных сайта WordPress.

Создайте файл с именем wordpress.env со следующим содержимым:

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

Защитите ваш .env файл

Никогда не добавляйте ваш файл .env в систему контроля версий и не публикуйте его. Добавьте *.env в ваш файл .gitignore.

Шаг 3: Настройка OpenClaw Ultra для чтения файла .env

В OpenClaw Ultra вы можете использовать навык File для чтения вашего файла .env и загрузки учётных данных.

1. Откройте OpenClaw Ultra
2. В чате введите:

Прочитайте файл по пути C:\путь\к\wordpress.env и сохраните каждую строку как переменную.

3. OpenClaw Ultra проанализирует файл .env и сделает значения доступными для последующих запросов.

Шаг 4: Публикация записи WordPress через REST API

Теперь вы можете использовать OpenClaw Ultra для автоматического создания и публикации записей WordPress.

Пример запроса:

Используя REST API WordPress по адресу {WP_SITE_URL}/wp-json/wp/v2/posts,
создайте новую запись с:
- 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

Используйте Basic Auth с именем пользователя {WP_USERNAME} и паролем {WP_APPLICATION_PASSWORD}.

OpenClaw Ultra отправит POST-запрос к конечной точке REST API WordPress и опубликует вашу запись.

Справочник конечных точек API

Действие	Endpoint	Method
Создать запись	/wp-json/wp/v2/posts	POST
Обновить запись	/wp-json/wp/v2/posts/{id}	PUT
Получить записи	/wp-json/wp/v2/posts	GET
Удалить запись	/wp-json/wp/v2/posts/{id}	DELETE

Шаг 5: Управление товарами WooCommerce

Если у вас установлен WooCommerce, вы также можете управлять товарами через REST API WooCommerce.

Пример запроса:

Используя REST API WooCommerce по адресу {WP_SITE_URL}/wp-json/wc/v3/products,
создайте новый товар с:
- 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

Используйте Basic Auth с именем пользователя {WP_USERNAME} и паролем {WP_APPLICATION_PASSWORD}.

Конечные точки API WooCommerce

Действие	Endpoint	Method
Создать товар	/wp-json/wc/v3/products	POST
Получить товары	/wp-json/wc/v3/products	GET
Обновить товар	/wp-json/wc/v3/products/{id}	PUT
Удалить товар	/wp-json/wc/v3/products/{id}	DELETE
Получить заказы	/wp-json/wc/v3/orders	GET
Создать категорию	/wp-json/wc/v3/products/categories	POST

Шаг 6: Выбор категорий

Прежде чем назначать категории вашим записям, вам может понадобиться найти существующие ID категорий.

Запрос для получения категорий:

Используя REST API WordPress по адресу {WP_SITE_URL}/wp-json/wp/v2/categories,
перечислите все категории на сайте.

Используйте Basic Auth с именем пользователя {WP_USERNAME} и паролем {WP_APPLICATION_PASSWORD}.

Чтобы создать новую категорию:

Создайте новую категорию с названием "AI Tutorials" через:
POST {WP_SITE_URL}/wp-json/wp/v2/categories
с именем "AI Tutorials" и ярлыком "ai-tutorials".

Используйте Basic Auth с именем пользователя {WP_USERNAME} и паролем {WP_APPLICATION_PASSWORD}.

Шаг 7: Автоматическое заполнение хэштегов

Вы можете попросить OpenClaw Ultra генерировать и добавлять релевантные хэштеги к вашим записям.

Пример запроса:

Для записи с заголовком "My First Automated Post" на {WP_SITE_URL},
сгенерируйте 5 релевантных хэштегов на основе её содержимого и добавьте их к записи.

Используйте REST API WordPress для обновления тегов или пользовательских полей записи.
Используйте Basic Auth с именем пользователя {WP_USERNAME} и паролем {WP_APPLICATION_PASSWORD}.

Устранение неполадок

Ошибка 401 Не авторизован

• Убедитесь, что плагин Basic Auth активирован
• Проверьте правильность имени пользователя и пароля
• Проверьте, что ваш сайт WordPress использует HTTPS

404 Конечная точка не найдена

• Убедитесь, что включены ЧПУ в Настройках → Постоянные ссылки
• Проверьте доступность REST API: {WP_SITE_URL}/wp-json/

403 Запрещено / Заблокировано Cloudflare

Если вы получаете ошибку 403, Cloudflare может блокировать запрос к API. Это происходит потому, что запросы к REST API WordPress из автоматизированных инструментов могут быть помечены как подозрительные.

Решение — Установить пользовательский заголовок User-Agent:

При выполнении запросов через OpenClaw Ultra явно укажите стандартную строку User-Agent, чтобы Cloudflare обрабатывал запрос как исходящий от реального браузера. Например:

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

В вашем запросе к OpenClaw Ultra включите заголовок User-Agent следующим образом:

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

Конечная точка WooCommerce недоступна

• Убедитесь, что плагин WooCommerce установлен и активирован
• API WooCommerce требует WooCommerce 3.0+

Следующие шаги

• Изучите другие конечные точки REST API WordPress
• Автоматизируйте графики публикации контента
• Создайте полный рабочий процесс контента с OpenClaw Ultra

Продолжайте с другими руководствами по интеграции, чтобы расширить свои возможности автоматизации.