DXTechAI Claw Agent

Description

WP DXTechAI Claw Agent is an AI Agent plugin for WordPress, powered by a ReAct (Reason + Act) loop. The Agent doesn’t just answer questions — it executes actions directly on your WordPress site.

Key Features

• 🤖 Command Palette — Open with Ctrl+I, Ctrl+G or Ctrl+Shift+K, modern glassmorphism chat interface
• 🧠 ReAct Loop — Agent reasons, selects tools, executes, observes results, and continues
• ✅ Confirm Before Executing — Data-changing actions require user confirmation
• 🔗 Chain Actions — Automatically performs sequential actions (e.g., create category then create multiple products)
• 🔌 Multi LLM Provider — Supports OpenAI (GPT-4o), Google Gemini (2.5 Flash/Pro), Anthropic Claude (Sonnet 4), Cloudflare Workers AI (Free)
• 🛒 WooCommerce Ready — Auto-detects WooCommerce and activates product, order, and customer management tools
• 💾 Session Persistence — Saves session state to resume after action confirmation
• 🔍 Web Research — Built-in web search via DuckDuckGo (free) or Google Custom Search
• 📱 Telegram Bot — Control your WordPress site via Telegram with inline keyboard confirmations

12 Built-in Tools

WordPress Core (9 tools):

1. Content Manager (wp_content_manager) — Create/update posts with categories, tags, and HTML content
2. System Inspector (wp_system_inspector) — View site info, active plugins, categories, tags, post types
3. Web Research (web_research_tool) — Search the web via DuckDuckGo (free) or Google Custom Search
4. Taxonomy Manager (wp_taxonomy_manager) — Create/update/delete categories & tags
5. Media Manager (wp_media_manager) — Upload images from URL, set featured images, list/delete media
6. Page Manager (wp_page_manager) — Create/update/delete/list pages, supports templates & sub-pages
7. User Inspector (wp_user_inspector) — List users, view details, count by role
8. Analytics Reader (wp_analytics_reader) — Post stats by status, comment stats, content summary
9. Report & Analytics (wp_report) — Dashboard overview, order reports, product reports, content reports

WooCommerce (3 tools — auto-activated when WooCommerce is active):

1. Product Manager (woo_product_manager) — Full product CRUD (name, price, SKU, stock, images), manage product categories
2. Order Inspector (woo_order_inspector) — List/view orders, update status, revenue statistics
3. Customer Inspector (woo_customer_inspector) — List/search customers, customer stats, top customers

Architecture

• ReAct Loop Engine (Kernel) — Reason→Act→Observe loop with configurable max iterations
• Dynamic Confirmation — Mixed read/write tools only require confirmation for write actions
• Context Provider — Auto-injects site snapshot (categories, post types, user) into LLM context
• Auto-Discovery — Automatically discovers and registers tools from the Actions/ directory
• REST API — Two endpoints: /agent/chat and /agent/confirm with session management
• Telegram Controller — Webhook-based bot with inline keyboard confirmations and session per chat

Usage Examples

WordPress:
* “Create a Technology category”
* “Write a blog post about AI trends 2025, save as draft”
* “Search the web for WordPress performance tips and write a summary post”
* “Show me site post statistics”
* “Create an About Us page with company introduction content”
* “Upload an image from URL and set it as featured image for the post”

WooCommerce:
* “Create 3 T-shirt products priced at 250,000”
* “Create a Fashion product category, then add 5 products to it”
* “Show me this month’s revenue”
* “Update order #123 status to completed”
* “Find customers with ‘gmail’ in their email”
* “Show me the top 5 customers by total spending”

Reports & Analytics:
* “Show me dashboard overview”
* “Thống kê đơn hàng tháng này”
* “Sản phẩm bán chạy nhất”
* “Báo cáo bài viết và trang”

Configuration

LLM Provider

Choose one of four providers:

• Google Gemini (AI Studio) — Free tier available at aistudio.google.com
  • Models: Gemini 2.5 Flash (Free), Gemini 2.5 Flash Lite (Free), Gemini 2.5 Pro Preview, Gemini 2.0 Flash Lite
• OpenAI — API key required from platform.openai.com
  • Models: GPT-4o, GPT-4o Mini, GPT-4 Turbo
• Anthropic — API key required from console.anthropic.com
  • Models: Claude Sonnet 4, Claude 3.5 Haiku
• Cloudflare Workers AI — API token required from dash.cloudflare.com
  • Models: Qwen 2.5 72B (Best Vietnamese), Gemma 3 12B, DeepSeek R1 32B

Web Search

• Default: DuckDuckGo (free, no API key required)
• Optional: Google Custom Search (requires API key + Search Engine ID)

Agent Settings

• Max Iterations — Maximum ReAct loop iterations (1–20, default: 10)

Telegram Integration

Control the AI agent directly from Telegram:

1. Create a bot via @BotFather on Telegram
2. Copy the Bot Token to DXTechAI Claw Agent → Telegram → Bot Token
3. Add your Telegram Chat ID to Allowed Chat IDs (send a message to your bot, then use the Telegram Bot API getUpdates method to find your chat ID)
4. Click Register Webhook to connect your site to Telegram
5. Send messages to your bot — the AI agent will respond!

Telegram Features:
* Send natural language messages to control WordPress
* Inline keyboard buttons for action confirmations (Approve/Reject)
* Session persistence per chat — multi-turn conversations
* Automatic Markdown fallback if formatting fails
* Secure with secret token verification and chat ID whitelist

Commands:
* /start — Show help message
* /reset — Clear current session

Discord Integration

Control the AI agent directly from Discord via slash commands (/agent) and interaction buttons:

1. Create an Application in the Discord Developer Portal
2. Copy the Bot Token, Application ID, and Public Key to the DXTechAI Claw Agent settings
3. Set your Interactions Endpoint URL in Discord to: https://your-domain/wp-json/dxtechai-claw-agent/v1/discord/interactions
4. Use the Sync Commands button in the plugin settings to register the /agent slash command
5. Use /agent in your Discord server to command the agent

Discord Features:
* Control WordPress natively using the Discord slash command interface
* Rich Embeds for agent responses and confirmation prompts
* Action buttons directly in the chat to Approve or Reject changes safely
* Secure validation of every request using Ed25519 signatures

External Services

This plugin connects to third-party AI and search services to provide its core functionality. No data is sent to any external service until the user explicitly configures an API key and initiates a request.

OpenAI API

When OpenAI is selected as the AI provider, user prompts and WordPress site context are sent to the OpenAI API for processing.
* Service URL: https://api.openai.com
* Terms of Use: https://openai.com/terms
* Privacy Policy: https://openai.com/privacy

Google Gemini (AI Studio)

When Gemini is selected as the AI provider, user prompts and WordPress site context are sent to the Google Generative AI API.
* Service URL: https://generativelanguage.googleapis.com
* Terms of Use: https://ai.google.dev/terms
* Privacy Policy: https://policies.google.com/privacy

Anthropic (Claude)

When Anthropic is selected as the AI provider, user prompts and WordPress site context are sent to the Anthropic API.
* Service URL: https://api.anthropic.com
* Terms of Use: https://www.anthropic.com/terms
* Privacy Policy: https://www.anthropic.com/privacy

Cloudflare Workers AI

When Cloudflare is selected as the AI provider, user prompts and WordPress site context are sent to the Cloudflare API.
* Service URL: https://api.cloudflare.com
* Terms of Use: https://www.cloudflare.com/website-terms/
* Privacy Policy: https://www.cloudflare.com/privacypolicy/

DuckDuckGo Search

The web research tool uses DuckDuckGo’s HTML search as the default search provider. Search queries are sent when the AI agent decides to perform web research.
* Service URL: https://html.duckduckgo.com
* Terms of Use: https://duckduckgo.com/terms
* Privacy Policy: https://duckduckgo.com/privacy

Google Custom Search

When configured, the web research tool can use Google Custom Search API instead of DuckDuckGo. Search queries are sent to the Google API.
* Service URL: https://www.googleapis.com/customsearch
* Terms of Use: https://developers.google.com/terms
* Privacy Policy: https://policies.google.com/privacy

Pexels API

When Pexels API key is configured, the agent may search and download free stock photos from Pexels for blog post thumbnails. Search queries (based on your post titles or keywords) are sent to the Pexels API.
* Service URL: https://api.pexels.com
* Terms of Use: https://www.pexels.com/terms-of-service/
* Privacy Policy: https://www.pexels.com/privacy-policy/

Unsplash API

When Unsplash API key is configured, the agent may search and download free stock photos from Unsplash for blog post thumbnails. Search queries (based on your post titles or keywords) are sent to the Unsplash API.
* Service URL: https://api.unsplash.com
* Terms of Use: https://unsplash.com/terms
* Privacy Policy: https://unsplash.com/privacy

Telegram Bot API

When Telegram integration is enabled, the plugin sends messages to the Telegram Bot API to deliver responses and inline keyboards to the configured bot.
* Service URL: https://api.telegram.org
* Terms of Use: https://telegram.org/tos
* Privacy Policy: https://telegram.org/privacy

Discord Bot API

When Discord integration is enabled, the plugin communicates with the Discord API to sync slash commands and send callback responses.
* Service URL: https://discord.com/api
* Terms of Use: https://discord.com/terms
* Privacy Policy: https://discord.com/privacy