Documentation

Getting started

Go from zero to a fully autonomous WordPress site in under 5 minutes. No developer needed.

STEP 1

Install WP-Claw Plugin

Download and install the free WP-Claw plugin on your WordPress site.

  1. 1Download the plugin ZIP from your WP-Claw dashboard after subscribing
  2. 2Go to your WordPress admin panel
  3. 3Navigate to Plugins → Add New → Upload Plugin
  4. 4Upload the ZIP file and click Install Now, then Activate
  5. 5The plugin is under 2MB and has zero dependencies

The plugin is a lightweight connector — all AI intelligence runs on your managed Klawty instance (EU-hosted), not inside WordPress. A WP-Claw subscription is required for agents to operate.

STEP 2

Create your WP-Claw account

Sign up at wp-claw.ai to create your account and access the management dashboard.

  1. 1Visit wp-claw.ai and click "Get Started"
  2. 2Enter your email address
  3. 3Click the magic link sent to your inbox (no password needed)
  4. 4You're in — your dashboard is ready

We use passwordless authentication via magic links. No passwords to remember or manage.

STEP 3

Choose your plan

Select the plan that fits your needs. All plans include EU hosting, dashboard, and support. Add an API credit pack for agent AI usage.

  1. 1Starter (€99/mo): 1 site, 6 AI agents, all 11 modules
  2. 2Pro (€249/mo): 3 sites, 6 AI agents per site, priority support
  3. 3Business (€449/mo): 10 sites, 6 AI agents per site, API access
  4. 4API Credits: Light (€25/mo), Standard (€50/mo), Power (€100/mo)
  5. 5Annual billing saves 2 months on the base plan

Founding member prices available for the first 10 customers on each plan. Locked for life.

STEP 4

Connect your WordPress site

Link your WordPress site to WP-Claw with a secure, one-time connection token.

  1. 1In your WP-Claw dashboard, click "Add Site"
  2. 2Enter your WordPress site URL
  3. 3Copy the generated connection token
  4. 4In WordPress admin, go to WP-Claw → Settings
  5. 5Paste the connection token and click Connect
  6. 6The handshake completes in about 10 seconds

Tokens are single-use and expire after 24 hours. The connection uses encrypted API keys — your credentials never leave your server.

STEP 5

Configure your modules

Enable the modules you need. Each module activates the corresponding AI agent.

  1. 1In your WP-Claw dashboard, click on your connected site
  2. 2Toggle on the modules you want: SEO, Security, Content, Analytics, CRM, Chat, etc.
  3. 3Each module shows which agent handles it and what it does
  4. 4Optional: customize agent instructions for your specific needs (Pro and Business plans)

You can enable or disable modules at any time. Changes take effect within minutes.

STEP 6

Your agents go live

That's it. Your AI team starts working immediately on the modules you enabled.

  1. 1Agents begin their first audit within minutes of activation
  2. 2Monitor progress from the real-time dashboard
  3. 3Approve proposals that need your sign-off (like content publishing or security changes)
  4. 4View detailed activity logs for full transparency
  5. 5Agents operate 24/7 — you check in when it suits you

Your agents respect a tiered autonomy model: routine tasks are automatic, significant changes require your approval via the dashboard.

Ready to get started?

Choose your plan

For developers

API Reference

The WP-Claw plugin communicates with your managed Klawty instance through wp-claw.ai proxy endpoints. All requests are authenticated, rate-limited, and audit-logged.

Authentication

All API requests require a Bearer token in the Authorization header. The API key is generated during the site connection handshake and stored encrypted in your WordPress database.

Authorization: Bearer your_api_key_here
Content-Type: application/json

API keys are 64-character random strings, encrypted at rest with AES-256-GCM. You can revoke and regenerate keys from your WP-Claw dashboard at any time.

Rate Limits

All endpoints are rate-limited per connected site. Exceeding the limit returns a 429 status code with a Retry-After header.

EndpointLimit
/api/proxy/tasks100 requests/min
/api/proxy/agents30 requests/min
/api/proxy/chat30 requests/min
/api/proxy/webhook200 requests/min
POST/api/proxy/tasks

Create a new agent task. The task is routed to the appropriate agent based on module type.

Rate limit: 100/min per site

Request body
{
  "module": "seo",
  "action": "audit_page",
  "target": "/about",
  "priority": "normal"
}
Response
{
  "task_id": "tsk_a1b2c3d4",
  "agent": "scribe",
  "status": "queued",
  "created_at": "2026-03-24T10:30:00Z"
}
GET/api/proxy/tasks

List all tasks for your connected site. Supports filtering by status, agent, and module.

Rate limit: 100/min per site

Response
{
  "tasks": [
    {
      "task_id": "tsk_a1b2c3d4",
      "agent": "scribe",
      "module": "seo",
      "status": "completed",
      "title": "SEO audit for /about",
      "created_at": "2026-03-24T10:30:00Z",
      "completed_at": "2026-03-24T10:31:12Z"
    }
  ],
  "total": 1,
  "page": 1
}
GET/api/proxy/agents

Get the status of all AI agents assigned to your site, including health, current task, and uptime.

Rate limit: 30/min per site

Response
{
  "agents": [
    {
      "name": "Thomas",
      "role": "Architect",
      "status": "active",
      "current_task": null,
      "health": "healthy",
      "uptime": "99.8%"
    },
    {
      "name": "Lina",
      "role": "Scribe",
      "status": "active",
      "current_task": "tsk_a1b2c3d4",
      "health": "healthy",
      "uptime": "99.9%"
    }
  ]
}
POST/api/proxy/chat

Send a visitor chat message to the Marc agent. Returns the AI response for your chat widget.

Rate limit: 30/min per site

Request body
{
  "message": "What are your business hours?",
  "session_id": "sess_x9y8z7",
  "visitor_page": "/contact"
}
Response
{
  "reply": "We're open Monday to Friday, 9am to 6pm CET. You can also reach us via the contact form on this page.",
  "session_id": "sess_x9y8z7",
  "confidence": 0.94
}
POST/api/proxy/webhook

Receive webhook notifications from your Klawty instance. Used for agent completion events, proposal updates, and alerts. Verified with HMAC-SHA256.

Rate limit: 200/min

Request body
{
  "event": "task.completed",
  "task_id": "tsk_a1b2c3d4",
  "agent": "scribe",
  "result": { "status": "success" }
}
Response
{
  "received": true
}

Common issues

Troubleshooting

Solutions for the most common issues. If you need further help, contact us at [email protected].

Connection fails

Symptoms
  • "Connection timed out" error in WP-Claw plugin settings
  • "Invalid API key" after pasting connection token
  • Handshake never completes
Solutions
  1. 1Verify your API key is correct — go to your WP-Claw dashboard, click the site, and copy the key again
  2. 2Check that your WP-Claw plugin version is up to date (minimum v1.0.0). Go to Plugins → Installed Plugins and check for updates
  3. 3Verify the site URL in your dashboard matches your WordPress site URL exactly (including https:// and trailing slash)
  4. 4Ensure your hosting provider is not blocking outbound HTTPS requests to wp-claw.ai
  5. 5Connection tokens expire after 24 hours — generate a new one if yours has expired

Agents not working

Symptoms
  • Tasks stay in "queued" status indefinitely
  • Agent status shows "offline" in dashboard
  • No activity in the activity log for 24+ hours
Solutions
  1. 1Check your Klawty instance status from the WP-Claw dashboard — look for the green "healthy" indicator on each agent
  2. 2Verify the modules you need are enabled — go to your site settings and toggle on the relevant modules
  3. 3Ensure your subscription is active — expired subscriptions pause all agent activity
  4. 4Check if proposals are waiting for your approval — some actions require manual sign-off
  5. 5If a specific agent shows "unhealthy", contact support at [email protected] with your site ID

Chat widget not showing

Symptoms
  • No chat bubble appears on the frontend
  • Chat widget loads but messages fail to send
  • Widget appears but shows "offline"
Solutions
  1. 1Verify the Chat module is enabled in your WP-Claw dashboard site settings
  2. 2Check that the WP-Claw plugin is activated in WordPress — go to Plugins → Installed Plugins
  3. 3Ensure the widget script is enqueued — view your page source and search for "wp-claw-chat"
  4. 4Check for JavaScript conflicts — open the browser console (F12) and look for errors
  5. 5If using a caching plugin, clear your cache after enabling the Chat module
  6. 6The widget requires an active internet connection to reach wp-claw.ai — verify no firewall or ad-blocker is blocking the request
Built-in

Monitoring & Health Checks

WP-Claw includes built-in health monitoring at every layer. No external tools or services required.

Agent health checks (every 5 minutes)

Your Klawty instance verifies connectivity to WordPress every 5 minutes. If two consecutive checks fail, all write operations halt automatically and you're notified. Operations resume when the connection recovers.

  • Automatic circuit breaker with exponential backoff
  • Self-recovery when connectivity restores
  • Health status visible in WP-Claw Settings page

Daily LLM budget enforcement

Each instance has a configurable daily spending cap. When the limit is reached, agent cycles pause automatically until the next calendar day. No surprise bills.

  • Per-instance daily budget in USD
  • Orchestrator checks budget before every cycle
  • Cost tracking per agent and per model in dashboard

Live system status page

Visit wp-claw.ai/status for real-time health checks on all WP-Claw infrastructure. The page pings actual endpoints every 30 seconds and shows response latency. No third-party status page service — it's built in.

Still stuck? We're here to help.

Contact support