2. Basic Auth (Legacy)

Requires Basic Auth plugin. Less secure, not recommended for production.

Environment Variables

Set these to avoid passing credentials every time:

export WP_URL="https://example.com"
export WP_USERNAME="admin"
export WP_APP_PASSWORD="xxxx xxxx xxxx xxxx xxxx xxxx"

Multi-Site Management

Configuration

1. Copy the example config:

cp config/sites.example.json config/sites.json

2. Edit config/sites.json with your sites:

{
  "sites": {
    "my-site": {
      "url": "https://mysite.com",
      "username": "admin",
      "app_password": "xxxx xxxx xxxx",
      "description": "My WordPress site"
    }
  },
  "groups": {
    "all": ["my-site"]
  }
}

CLI Wrapper (./wp.sh)

# List sites
./wp.sh --list-sites
./wp.sh --list-groups

# Single site operations
./wp.sh my-site update-post --id 123 --content "..."
./wp.sh my-site create-post --title "..." --content "..."
./wp.sh my-site get-post --id 123
./wp.sh my-site list-posts --per-page 10

# Group operations (runs on all sites in group)
./wp.sh all update-post --id 123 --status "publish"

Batch Operations

# Update multiple posts across multiple sites
python3 scripts/batch_update.py \
  --group digitizer \
  --post-ids 123,456,789 \
  --status "publish"

# Update meta field on all sites
python3 scripts/batch_update.py \
  --sites all \
  --post-ids 100 \
  --meta-key "seo_score" \
  --meta-value "95"

# Dry run (see what would happen)
python3 scripts/batch_update.py \
  --group all \
  --post-ids 123 \
  --status "draft" \
  --dry-run

Individual Scripts

All scripts support both command-line arguments and environment variables.

Update Post

python3 scripts/update_post.py \
  --post-id 123 \
  --content "Updated content" \
  --title "New Title" \
  --status "publish"

Supports:

• Content (HTML or Gutenberg blocks)
• Title
• Status (publish, draft, pending, private)
• Featured image ID
• Custom fields (meta)

Create Post

python3 scripts/create_post.py \
  --title "New Post" \
  --content "Post content" \
  --status "draft"

Get Post

python3 scripts/get_post.py --post-id 123

Returns full post data as JSON.

List Posts

python3 scripts/list_posts.py --per-page 10 --status "publish"

Options:

• --per-page N - Posts per page (default: 10, max: 100)
• --page N - Page number
• --status STATUS - Filter by status (publish, draft, pending, private)
• --author ID - Filter by author

Plugin Integration

Detect Plugins

Automatically detect installed WordPress plugins (ACF, Rank Math, Yoast, JetEngine):

python3 scripts/detect_plugins.py
python3 scripts/detect_plugins.py --verbose

ACF (Advanced Custom Fields)

Read and write ACF fields with automatic fallback to postmeta:

# Get all ACF fields
python3 scripts/acf_fields.py --post-id 123

# Get specific field
python3 scripts/acf_fields.py --post-id 123 --field my_field

# Set fields from JSON
python3 scripts/acf_fields.py --post-id 123 --set '{"field1": "value1", "field2": "value2"}'

# Set single field
python3 scripts/acf_fields.py --post-id 123 --field my_field --value "my value"

Features:

• Automatic REST API detection with postmeta fallback
• Support for simple, repeater, and group fields
• JSON input/output for complex field structures

SEO Meta (Rank Math & Yoast)

Read and write SEO meta fields with auto-detection:

# Auto-detect plugin and get meta
python3 scripts/seo_meta.py --post-id 123

# Detect which SEO plugin is active
python3 scripts/seo_meta.py --post-id 123 --detect

# Get specific plugin's meta
python3 scripts/seo_meta.py --post-id 123 --plugin rankmath
python3 scripts/seo_meta.py --post-id 123 --plugin yoast

# Set SEO meta
python3 scripts/seo_meta.py --post-id 123 --set '{"title": "SEO Title", "description": "Meta description"}'

# Set with specific plugin
python3 scripts/seo_meta.py --post-id 123 --plugin rankmath --set '{"focus_keyword": "keyword"}'

Supported fields:

• Rank Math: title, description, focus_keyword, robots, canonical_url, schema
• Yoast: title, description, focus_keyword, canonical, meta_robots_noindex, meta_robots_nofollow

JetEngine Fields

Read and write JetEngine custom fields (stored as postmeta):

# Get all JetEngine fields
python3 scripts/jetengine_fields.py --post-id 123

# Get specific field
python3 scripts/jetengine_fields.py --post-id 123 --field my_field

# Set fields from JSON
python3 scripts/jetengine_fields.py --post-id 123 --set '{"field1": "value1", "field2": "value2"}'

# Set single field
python3 scripts/jetengine_fields.py --post-id 123 --field my_field --value "my value"

Elementor Content

Manage Elementor page builder content via _elementor_data meta field:

# Get Elementor data for a page
python3 scripts/elementor_content.py --post-id 123 --action get

# Update specific widget content
python3 scripts/elementor_content.py \
  --post-id 123 \
  --action update \
  --widget-id "abc123" \
  --content "New heading text"

Supported widget types:

• Headings (heading)
• Text Editor (text-editor)
• Buttons (button)
• Generic fallback for other widgets

How it works:

• Gets page data with _elementor_data meta field
• Parses JSON structure
• Finds widget by ID (recursively through nested elements)
• Updates content based on widget type
• Saves back to WordPress

Media Upload

Upload images and files to WordPress media library:

# Upload local file
python3 scripts/upload_media.py \
  --file "/path/to/image.jpg" \
  --title "My Image" \
  --alt-text "Description for accessibility"

# Upload from URL
python3 scripts/upload_media.py \
  --file "https://example.com/image.jpg" \
  --title "Remote Image"

# Upload and set as featured image
python3 scripts/upload_media.py \
  --file "image.jpg" \
  --set-featured \
  --post-id 123

Features:

• Supports local files and URLs
• Auto-detects MIME type
• Returns media ID for further operations
• Can set as featured image in one call

WooCommerce Products

Manage WooCommerce products via REST API v3:

# List products
python3 scripts/woo_products.py \
  --consumer-key "ck_..." \
  --consumer-secret "cs_..." \
  --action list \
  --per-page 10

# Get single product
python3 scripts/woo_products.py \
  --consumer-key "ck_..." \
  --consumer-secret "cs_..." \
  --action get \
  --product-id 456

# Create product
python3 scripts/woo_products.py \
  --consumer-key "ck_..." \
  --consumer-secret "cs_..." \
  --action create \
  --title "New Product" \
  --price "29.99" \
  --description "Product description" \
  --status "publish"

# Update product
python3 scripts/woo_products.py \
  --consumer-key "ck_..." \
  --consumer-secret "cs_..." \
  --action update \
  --product-id 456 \
  --price "39.99" \
  --status "publish"

Authentication:

• Requires WooCommerce Consumer Key and Consumer Secret
• Get from: WooCommerce → Settings → Advanced → REST API
• Environment variables: WC_CONSUMER_KEY, WC_CONSUMER_SECRET

Supported fields:

• --title / --name - Product name
• --price - Regular price
• --sale-price - Sale price
• --description - Full description
• --short-description - Short description
• --status - publish, draft, pending, private
• --sku - Stock keeping unit
• --stock-quantity - Stock amount
• --manage-stock - Enable stock management

Gutenberg Blocks

WordPress uses Gutenberg block format for content. See references/gutenberg-blocks.md for details.

Example block:

<!-- wp:paragraph -->
<p>This is a paragraph.</p>
<!-- /wp:paragraph -->

API Reference

See references/api-reference.md for complete WordPress REST API documentation.

Common endpoints:

• /wp-json/wp/v2/posts - Posts
• /wp-json/wp/v2/pages - Pages
• /wp-json/wp/v2/media - Media
• /wp-json/wp/v2/users - Users
• /wp-json/wp/v2/categories - Categories
• /wp-json/wp/v2/tags - Tags

Error Handling

All scripts return:

• Exit code 0 on success
• Exit code 1 on error
• JSON output to stdout
• Error messages to stderr

Security

• ✅ DO: Use Application Passwords
• ✅ DO: Use HTTPS only
• ✅ DO: Store credentials in environment variables
• ❌ DON'T: Hardcode passwords in scripts
• ❌ DON'T: Use Basic Auth in production
• ❌ DON'T: Commit credentials to git

Limitations

• Requires WordPress 4.7+ (REST API built-in)
• Requires Application Passwords plugin for WordPress <5.6
• Some endpoints require specific user permissions
• Rate limiting depends on host configuration

{
  "sites": {
    "site1": {
      "url": "https://site1.com",
      "username": "admin",
      "app_password": "xxxx xxxx xxxx",
      "description": "First site"
    },
    "site2": {
      "url": "https://site2.com",
      "username": "admin",
      "app_password": "yyyy yyyy yyyy",
      "description": "Second site"
    }
  },
  "groups": {
    "all": ["site1", "site2"]
  }
}

3. Use the CLI wrapper:

# List sites
./wp.sh --list-sites

# Update post on specific site
./wp.sh site1 update-post --id 123 --content "New content"

# Update on all sites
./wp.sh all update-post --id 456 --status "publish"

# Batch update
python3 scripts/batch_update.py --group all --post-ids 123,456 --status "publish"

Option B: Single Site Setup

1. Create Application Password

1. Go to: https://yoursite.com/wp-admin/profile.php
2. Scroll to "Application Passwords"
3. Name: "OpenClaw API"
4. Click "Add New Application Password"
5. Copy the password

2. Set Environment Variables

export WP_URL="https://yoursite.com"
export WP_USERNAME="your-username"
export WP_APP_PASSWORD="xxxx xxxx xxxx xxxx xxxx xxxx"

3. Use the Skill

Update a post:

python3 ~/.openclaw/workspace/skills/wordpress-api-pro/scripts/update_post.py \
  --post-id 123 \
  --title "New Title" \
  --content "Updated content" \
  --status "publish"

Create a post:

python3 scripts/create_post.py \
  --title "My Post" \
  --content "Post content here" \
  --status "draft"

Get a post:

python3 scripts/get_post.py --post-id 123

List posts:

python3 scripts/list_posts.py --per-page 10 --status "publish"

Scripts

Core Scripts

| Script | Purpose | |--------|---------| | update_post.py | Update existing post | | create_post.py | Create new post | | get_post.py | Retrieve single post | | list_posts.py | List/filter posts |

Plugin Integration (New in v3.2.0)

| Script | Purpose | |--------|---------| | detect_plugins.py | Auto-detect installed plugins (ACF, Rank Math, Yoast, JetEngine) | | acf_fields.py | Read/write Advanced Custom Fields | | seo_meta.py | Read/write Rank Math & Yoast SEO meta | | jetengine_fields.py | Read/write JetEngine custom fields | | elementor_content.py | Read/update Elementor page content | | upload_media.py | Upload images to WordPress media library | | woo_products.py | Manage WooCommerce products |

Examples:

# Detect plugins
python3 scripts/detect_plugins.py

# Get ACF fields
python3 scripts/acf_fields.py --post-id 123

# Set SEO meta
python3 scripts/seo_meta.py --post-id 123 --set '{"title": "SEO Title", "description": "Meta desc"}'

# Update JetEngine field
python3 scripts/jetengine_fields.py --post-id 123 --field my_field --value "value"

# Elementor Content
python3 scripts/elementor_content.py get --post-id 123 --widget-id some_widget_id
python3 scripts/elementor_content.py update --post-id 123 --widget-id some_widget_id --field 'title' --value 'New Title'

# Media Upload
python3 scripts/upload_media.py --file-path /path/to/image.jpg --title "My Image" --caption "A beautiful image"
python3 scripts/upload_media.py --url https://example.com/image.png --set-featured --post-id 123

# WooCommerce Products
python3 scripts/woo_products.py list --status 'publish'
python3 scripts/woo_products.py get --id 456
python3 scripts/woo_products.py create --name "New Product" --type 'simple' --regular-price '29.99'
python3 scripts/woo_products.py update --id 456 --description "Updated product description"

Documentation

• SKILL.md - Full skill documentation
• references/api-reference.md - WordPress REST API reference
• references/gutenberg-blocks.md - Gutenberg block format guide

Requirements

• Python 3.6+
• WordPress 4.7+ (REST API built-in)
• Application Passwords (WordPress 5.6+ or plugin for older versions)
• requests library (for plugin integration scripts): pip install requests

Security

• ✅ Use Application Passwords (not regular passwords)
• ✅ Always use HTTPS
• ✅ Store credentials in environment variables
• ❌ Never commit credentials to git

Use Cases

• Publishing blog posts
• Content migration
• Batch updates
• Automated publishing
• Content management workflows
• Integration with other systems

License

MIT License - See LICENSE.txt

Links

• OpenClaw: https://openclaw.ai
• ClawHub: https://clawhub.com
• WordPress REST API: https://developer.wordpress.org/rest-api/

Built with ❤️ for OpenClaw by Digitizer