# WP DXTechAI Claw Agent
π **English** | [TiαΊΏng Viα»t](README.md)
> Autonomous AI Agent for WordPress β executes actions instead of just answering text.
[](https://wordpress.org)
[](https://php.net)
[](https://www.gnu.org/licenses/gpl-2.0.html)
**WP DXTechAI Claw Agent** is an AI Agent plugin for WordPress, powered by the **ReAct** (Reason + Act) loop. The agent doesn't just answer questions β it **directly executes actions** on your WordPress site.
## β¨ Key Features
| Feature | Description |
|---------|-------------|
| π€ **Command Palette** | Open with `Ctrl+I`, `Ctrl+G` or `Ctrl+Shift+K`, modern glassmorphism-style chat interface |
| π§ **ReAct Loop** | Agent reasons, selects tools, executes, observes results, and continues |
| β
**Confirm Before Executing** | Data-modifying actions require user confirmation |
| π **Chain Actions** | Automatically performs sequential chains of actions |
| π **Multi LLM Provider** | OpenAI (GPT-4o) Β· Google Gemini (2.5 Flash/Pro) Β· Anthropic Claude (Sonnet 4) Β· Cloudflare Workers AI (Free) |
| π **Multi-Key & Failover** | Gemini supports up to 5 API keys with round-robin rotation + auto failover to Cloudflare on quota exhaustion |
| π **WooCommerce Ready** | Auto-activates product, order, and customer management tools |
| πΎ **Session Persistence** | Saves session state via WordPress transients |
| π **Web Research** | Direct web search (free DuckDuckGo or Google CSE) |
| π¬ **Discord Bot** | Control WordPress from Discord slash commands with Approve/Reject buttons |
## π οΈ 11 Built-in Tools
### WordPress Core (8 tools)
| # | Tool | Function Name | Capability |
|---|------|---------------|------------|
| 1 | **Content Manager** | `wp_content_manager` | Create/update posts with categories, tags, HTML |
| 2 | **System Inspector** | `wp_system_inspector` | View site info, plugins, categories, tags, post types |
| 3 | **Web Research** | `web_research_tool` | Search the web via DuckDuckGo or Google CSE |
| 4 | **Taxonomy Manager** | `wp_taxonomy_manager` | Create/edit/delete categories & tags |
| 5 | **Media Manager** | `wp_media_manager` | Upload images from URL, set featured image, list/delete media |
| 6 | **Page Manager** | `wp_page_manager` | Create/edit/delete/list Pages, supports templates & sub-pages |
| 7 | **User Inspector** | `wp_user_inspector` | View user list, details, statistics by role |
| 8 | **Analytics Reader** | `wp_analytics_reader` | Post statistics, comments, content overview |
### WooCommerce (3 tools β auto-activated)
| # | Tool | Function Name | Capability |
|---|------|---------------|------------|
| 9 | **Product Manager** | `woo_product_manager` | CRUD products (name, price, SKU, stock, images), manage categories |
| 10 | **Order Inspector** | `woo_order_inspector` | View orders, update status, revenue statistics |
| 11 | **Customer Inspector** | `woo_customer_inspector` | View/search customers, statistics, top customers |
## ποΈ Architecture
```
wp-open-claw/
βββ dxtechai-claw-agent.php # Entry point, constants, hooks
βββ src/
β βββ Actions/ # 11 Tool implementations
β β βββ ContentTool.php
β β βββ SystemTool.php
β β βββ ResearchTool.php
β β βββ TaxonomyTool.php
β β βββ MediaTool.php
β β βββ PageTool.php
β β βββ UserInspector.php
β β βββ AnalyticsReader.php
β β βββ ProductTool.php # WooCommerce
β β βββ OrderTool.php # WooCommerce
β β βββ CustomerTool.php # WooCommerce
β βββ Agent/
β β βββ Kernel.php # ReAct loop engine
β β βββ ContextProvider.php # Auto-inject site context
β βββ LLM/
β β βββ ClientInterface.php
β β βββ OpenAIClient.php
β β βββ GeminiClient.php # Multi-key rotation (5 keys)
β β βββ AnthropicClient.php
β β βββ CloudflareClient.php # Cloudflare Workers AI
β βββ REST/
β β βββ AgentController.php # REST API endpoints
β βββ Admin/
β β βββ Settings.php # Settings page
β β βββ Dashboard.php # Admin dashboard
β βββ Tools/
β βββ ToolInterface.php
β βββ DynamicConfirmInterface.php
β βββ Manager.php # Tool registry & dispatcher
β βββ Discord/
β β βββ DiscordController.php # Discord interactions handler
β β βββ DiscordClient.php # Discord REST API client
β β βββ StepFormatter.php # Format agent steps for Discord
βββ assets/
β βββ css/
β βββ js/
βββ vendor/ # Composer dependencies
```
### Workflow
```
User Input β Kernel.handle()
β
System Prompt (+ ContextProvider snapshot)
β
LLM Chat (OpenAI / Gemini / Anthropic / Cloudflare)
β
ββ Rate Limit (429) β Failover to Cloudflare (if configured)
β
ββ Text Response β Return to user
β
ββ Tool Call β Manager.dispatch()
β
ββ Read-only β Execute immediately β Observation β Continue loop
β
ββ Write action β Pending Confirmation
β
User Approve β Kernel.confirmAction() β Execute β Resume loop
User Reject β Kernel.rejectAction() β Stop
```
## π¦ Installation
**Option 1: Upload ZIP (Recommended)**
1. Download the latest ZIP from [GitHub Releases](https://github.com/dx-tech-ai/wp-open-claw/releases)
2. Go to WP Admin β Plugins β Add New β Upload Plugin
3. Select the ZIP file β Install Now β Activate
4. Go to **DXTechAI Claw Agent** β configure your API key
5. Press `Ctrl+I` or `Ctrl+G` to get started!
**Option 2: Clone from GitHub**
```bash
cd /path/to/wp-content/plugins/
git clone https://github.com/dx-tech-ai/wp-open-claw.git
# Activate plugin in WP Admin β Plugins
# Go to DXTechAI Claw Agent β configure API key
# Press Ctrl+I or Ctrl+G to get started!
```
## βοΈ Configuration
### LLM Provider
| Provider | Models | Free Tier | Get API Key |
|----------|--------|-----------|-------------|
| **Google Gemini** | Gemini 2.5 Flash, Flash Lite, 2.5 Pro Preview | β
Yes (supports 5-key rotation) | [aistudio.google.com](https://aistudio.google.com/apikey) |
| **Cloudflare Workers AI** | Qwen 2.5 72B, Gemma 3 12B, DeepSeek R1 32B | β
Yes (generous free tier) | [dash.cloudflare.com](https://dash.cloudflare.com/profile/api-tokens) |
| **OpenAI** | GPT-4o, GPT-4o Mini, GPT-4 Turbo | β No | [platform.openai.com](https://platform.openai.com) |
| **Anthropic** | Claude Sonnet 4, Claude 3.5 Haiku | β No | [console.anthropic.com](https://console.anthropic.com) |
### Gemini Multi-Key Rotation
To avoid rate limits on the free tier, you can configure up to **5 API keys** from Google AI Studio. The plugin automatically rotates (round-robin) between keys and retries on 429 errors.
### Cloudflare Failover
If you configure Cloudflare Workers AI (Account ID + API Token), the plugin will **automatically switch to Cloudflare** when the primary provider (Gemini/OpenAI/Anthropic) hits rate limits. No need to select Cloudflare as primary β just fill in the credentials and failover works automatically.
### 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)
### Discord Bot
1. Create an application in the Discord Developer Portal and add the bot to your server
2. Copy the `Bot Token`, `Application ID`, and `Public Key`
3. Open **DXTechAI Claw Agent β Discord** in WordPress and fill in those values
4. Add `Allowed Channel IDs` and `Allowed User IDs` to restrict where and who can run the bot
5. Optionally add a `Guild ID` if you want faster slash command updates inside one Discord server
6. Expose your WordPress site over HTTPS, preferably with `ngrok` for local testing, and set:
`https://your-domain/wp-json/dxtechai-claw-agent/v1/discord/interactions`
as the `Interactions Endpoint URL` in the Discord Developer Portal
7. Click **Register /openclaw Command**
8. Run `/openclaw run` in an allowed Discord channel
**Discord capabilities:**
- `/openclaw` reuses the same Kernel as the admin chatbox and Telegram
- Only users listed in `Allowed User IDs` can execute commands in approved channels
- Supports `Guild ID` for faster guild-scoped command updates during setup
- Discord receives a fast acknowledgement, then the bot posts results to the channel
- Write actions render **Approve** / **Reject** buttons
- Only the user who started the request can confirm it
- Sessions are persisted per `channel + Discord user`
## π‘ Usage Examples
### WordPress
```
"Create a category called Technology"
"Write a post about AI trends 2025, save as draft"
"Search the web about WordPress performance and write a summary post"
"Show me the post statistics on this site"
"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 $25"
"Create a Fashion product category, then add 5 products to it"
"Show me this month's revenue"
"Update order #123 to completed status"
"Find customers with email containing 'gmail'"
"Show me the top 5 highest-spending customers"
```
### Discord
```
/openclaw run prompt: Show me site info
/openclaw run prompt: Create a category called Discord Test
/openclaw run prompt: Draft a post about WordPress performance
/openclaw reset
```
## β FAQ
Is the plugin free?
The plugin is completely free and open source. You need an API key from an LLM provider (Gemini has a free tier).
What PHP version is required?
PHP 7.4 or higher is required.
Can the agent delete data?
All write actions (create/edit/delete) require user confirmation. Mixed tools use Dynamic Confirmation β only write actions require confirmation, read actions execute immediately.
Does it support WooCommerce?
Yes! The plugin automatically detects WooCommerce and activates 3 tools: Product Manager, Order Inspector, Customer Inspector.
Can the agent perform multiple consecutive actions?
Yes! The agent supports Chain Actions β after confirming one action, the agent automatically continues the ReAct loop to perform subsequent actions.
## π Changelog
### 1.1.0
- **Gemini Multi-Key Rotation**: Support up to 5 API keys with round-robin rotation, auto-retry on 429 rate limit
- **Cloudflare Workers AI**: New free provider β Qwen 2.5 72B (best Vietnamese), Gemma 3 12B (fast), DeepSeek R1 32B (reasoning)
- **Auto Failover**: Automatically switch to Cloudflare when primary provider hits quota
- Fix: `render_text_field` supports provider toggle CSS class
### 1.0.0
- Initial release
- 11 built-in tools (8 WordPress core + 3 WooCommerce)
- Support for OpenAI (GPT-4o), Gemini (2.5 Flash/Pro), Anthropic (Claude Sonnet 4)
- Command Palette UI with `Ctrl+I` or `Ctrl+G` shortcuts
- Discord slash command integration with approval buttons
- ReAct Loop engine with configurable max iterations
- DuckDuckGo web search (free, no API key needed)
- Dynamic Confirmation for mixed read/write tools
- Chain action execution β agent resumes loop after confirmation
- Session persistence via WordPress transients
- WooCommerce auto-detection and tool activation
- Context Provider with auto-injected site snapshot
- REST API with session management
## π License
GPLv2 or later β [https://www.gnu.org/licenses/gpl-2.0.html](https://www.gnu.org/licenses/gpl-2.0.html)
---
**Made with β€οΈ by [DX Tech AI](https://github.com/dx-tech-ai)**