ClawWP Documentation

Everything you need to manage your WordPress site with AI — from your dashboard, Telegram, Slack, or Discord. Trade prediction markets, execute blockchain transactions, and extend your agent with MCP.

1 Getting Started

Requirements

  • WordPress 6.0 or higher
  • PHP 8.0 or higher
  • An Anthropic API key (get one at console.anthropic.com) — or a ClawWP Pro license (no API key needed with HFB Proxy)

Download

Get the latest version of ClawWP:

Installation

1

Download the ClawWP zip file using one of the links above.

2

In your WordPress dashboard go to Plugins → Add New → Upload Plugin.

3

Upload the zip file and click Activate.

First-Time Setup

1

Go to ClawWP → Settings in your admin menu.

2

Free users: Enter your Anthropic API key under AI Provider and click Save Changes.

Pro users: Enter your license key under Pro License and click Activate. Then select HFB Proxy as your provider — no API key needed. You get 500K tokens/month included.

3

(Optional) Enable GuessMarket to trade prediction markets — free for all users.

4

(Optional) Connect Telegram, Slack, or Discord to manage your site from your phone or team chat.

Test It

Click the chat bubble in the bottom-right corner of wp-admin and type:

How many posts do I have?

You should see an AI-generated answer within seconds.

2 Sidebar Chat

  • Always available in wp-admin — look for the chat bubble in the bottom-right corner.
  • Click to expand the panel, type a message, and get instant AI responses.
  • Token usage is displayed in real-time so you can monitor costs as you chat.
  • Start a fresh conversation at any time with the + button.
  • The sidebar can be disabled under ClawWP → Settings → Interface → Sidebar Chat.

3 AI Provider & Model Settings

ClawWP supports multiple AI providers. Choose the one that fits your workflow and budget under ClawWP → Settings → AI Provider.

Choosing a Provider

Use the Provider dropdown at the top of the AI Provider section to select how your agent connects to AI models:

✔

HFB Proxy Recommended Pro

No API key needed. Requests are routed through HiFriendbot.com using our Anthropic API key. Includes 500K tokens/month with your Pro subscription. This is the easiest way to get started — just activate your license and go.

C

Claude (Anthropic) Free

Bring your own Anthropic API key. You pay Anthropic directly for usage. Get your key at console.anthropic.com. Keys are stored with quantum-safe encryption in your database.

O

OpenAI Pro

Use GPT-4o or other OpenAI models. Bring your own OpenAI API key. Available with an active Pro license.

Selecting a Model

After choosing a provider, pick a model from the dropdown. Each model has different pricing and capabilities:

Model Best For Input / Output per 1M Tokens
Claude Sonnet 4.5 Best balance of speed, quality, and cost $3.00 / $15.00
Claude Haiku 3.5 Fastest and cheapest — great for simple tasks $0.80 / $4.00
Claude Opus 4 Most capable — complex reasoning and writing $15.00 / $75.00
GPT-4o Pro OpenAI’s flagship model $2.50 / $10.00
GPT-4o-mini Pro Fast and affordable OpenAI alternative $0.15 / $0.60

Prices shown are from each provider’s current pricing. When using HFB Proxy, tokens come from your included 500K/month quota instead.

4 Connect Telegram

Manage your WordPress site from Telegram on your phone. Free for all users.

Setup

1

Create a bot

Open Telegram and search for @BotFather. Send /newbot and follow the prompts to create your bot.

2

Copy your token

BotFather will give you a bot token (a long string like 123456:ABC-DEF...). Copy it.

3

Add it to ClawWP

Go to ClawWP → Settings → Telegram → Bot Token, paste your token, and click Save Changes.

4

Webhook registers automatically

ClawWP sets up the Telegram webhook for you — no manual configuration needed. You should see a green Connected indicator next to the token field.

5

Pair your account

Open your bot in Telegram and send /pair. You will receive a 6-digit pairing code. Enter it in ClawWP → Settings → Channel Pairings. See Channel Pairings for details.

You can now manage your WordPress site from Telegram! Try sending your bot a message like List my recent posts.

5 Connect Slack Pro

Let your team manage your WordPress site from Slack. Requires an active Pro license.

Create a Slack App

1

Go to Slack API

Visit api.slack.com/apps and click Create New App. Choose From scratch and pick your workspace.

2

Enable Event Subscriptions

In your app settings, go to Event Subscriptions and toggle it on. Set the Request URL to:

https://yoursite.com/wp-json/clawwp/v1/webhook/slack

Subscribe to bot events: message.im (direct messages to your bot).

3

Set Bot Permissions

Go to OAuth & Permissions and add these Bot Token Scopes:

  • chat:write — send messages
  • im:history — read direct messages
  • im:read — access direct message channels
  • im:write — open direct message channels
4

Install to workspace

Click Install to Workspace and authorize the app. Copy the Bot User OAuth Token (starts with xoxb-).

5

Get Signing Secret

Go to Basic Information in your Slack app settings. Under App Credentials, copy the Signing Secret. This is used to verify that incoming webhooks are genuinely from Slack.

Add to ClawWP

6

Go to ClawWP → Settings → Slack.

7

Paste your Bot Token (xoxb-...) and Signing Secret into the corresponding fields.

8

Click Save Changes. Then pair your Slack account — see Channel Pairings.

Send a direct message to your Slack bot to start managing WordPress. Try: Draft a blog post about our Q1 results.

6 Connect Discord Pro

Chat with your WordPress AI agent from your Discord server. Requires an active Pro license.

Create a Discord Application

1

Create the application

Go to discord.com/developers/applications and click New Application. Give it a name (e.g. “ClawWP”).

2

Copy Application ID & Public Key

On the General Information page, copy the Application ID and Public Key (Ed25519 hex string). You will need both for ClawWP settings.

3

Create a bot

Go to the Bot section and click Add Bot. Copy the Bot Token. Under Privileged Gateway Intents, enable Message Content Intent.

4

Set up Interactions Endpoint

On the General Information page, set the Interactions Endpoint URL to:

https://yoursite.com/wp-json/clawwp/v1/webhook/discord

Discord will verify the endpoint before saving. Make sure ClawWP is installed and active on your site.

5

Invite bot to your server

Go to OAuth2 → URL Generator. Select the bot scope, then pick permissions: Send Messages, Read Message History. Copy the generated URL and open it in your browser to invite the bot to your server.

Add to ClawWP

6

Go to ClawWP → Settings → Discord.

7

Enter your Bot Token, Application ID, and Public Key.

8

Click Save Changes. Then pair your Discord account — see Channel Pairings.

DM your Discord bot or mention it in a channel to start chatting. Try: @ClawWP Show me comments awaiting moderation.

7 Channel Pairings

Before you can use ClawWP from Telegram, Slack, or Discord, you must pair your channel account to your WordPress account. This ensures the agent knows who you are and respects your WordPress permissions.

How to Pair

1

Send /pair to your bot in Telegram, Slack, or Discord. The bot will respond with a 6-digit pairing code.

2

Go to ClawWP → Settings → Channel Pairings in your WordPress admin.

3

Enter the 6-digit code in the Pairing Code field and click Pair.

Managing Pairings

  • The Channel Pairings table shows all your active pairings — channel type, user ID, and when they were paired.
  • Click Unpair to disconnect a channel account. The user will no longer be able to use ClawWP from that channel until they re-pair.
  • Each WordPress user pairs their own accounts independently. An editor pairs their own Telegram, a contributor pairs theirs, etc.
  • Free: 1 pairing per channel. Pro: Unlimited pairings — your whole team can connect.

Why pairing matters: Without pairing, anyone who finds your bot could send it commands. Pairing ensures only verified WordPress users can control your site, and each user’s actions are limited to their WordPress role.

8 Available Tools

ClawWP ships with a growing set of tools the AI agent can call on your behalf. Free tools are available to everyone; Pro tools require an active license.

Tool What It Does Tier
create_post Draft or publish a new blog post Free
edit_post Update the title, content, status, or metadata of an existing post Free
list_posts Retrieve a filtered list of posts (by status, date, author, etc.) Free
schedule_post Schedule a post to go live at a specific date and time Free
delete_post Move a post to the trash or permanently delete it Free
manage_pages Create, edit, list, or delete pages Free
manage_media List, search, get details, update alt text/captions, and manage media library items Free
moderate_comments Approve, spam, trash, or reply to comments Free
get_site_info View site title, URL, version, active theme, and plugin info Free
generate_seo Generate meta titles, descriptions, and keyword suggestions Free
GuessMarket tools Browse prediction markets, check odds, place trades, view positions (17+ tools via MCP) Free
MCP server tools Any tools provided by user-configured MCP servers (HTTP or stdio) Free
manage_wallet Create wallets, check balances, sign and broadcast blockchain transactions via AgentWallet Pro
woo_sales_report Generate WooCommerce sales reports by date range Pro
woo_inventory Check stock levels, low-stock alerts, and update quantities Pro
woo_orders List, view, or update WooCommerce orders Pro
woo_products Create, edit, or delete WooCommerce products Pro
woo_customers Look up customer details, order history, and lifetime value Pro
schedule_task Schedule recurring or one-time background tasks Pro
bulk_operations Batch update, delete, or modify posts, products, or users Pro

9 GuessMarket & Prediction Markets

ClawWP connects to GuessMarket via MCP, giving your agent the ability to trade prediction markets directly from chat. Free for all users.

Setup

1

Go to ClawWP → Settings → GuessMarket.

2

Toggle Enable GuessMarket prediction market tools on.

3

Click Discover Tools. ClawWP connects to the GuessMarket MCP server and discovers available tools. You should see 17+ tools discovered.

No API key or account is required. GuessMarket tools are free for all ClawWP users.

What You Can Do

  • Browse markets — “Show me popular prediction markets”
  • Check odds — “What are the odds on the next election?”
  • Place trades — “Buy $10 of Yes on market #123”
  • View positions — “Show my open positions”
  • Track P&L — “How are my trades doing?”

How Trading Works

When you place a trade, GuessMarket prepares the blockchain transaction. If you have AgentWallet connected (Pro), the agent signs and broadcasts it on-chain automatically. Without AgentWallet, GuessMarket returns the unsigned transaction for you to sign manually.

10 AgentWallet & Blockchain Pro

AgentWallet is a server-side EVM wallet for AI agents. Connect it to ClawWP so your agent can create wallets, check balances, and sign transactions on any EVM chain. Requires an active Pro license.

Setup

1

Create a free AgentWallet account at hifriendbot.com/wallet.

2

Copy your Username and API Key from your AgentWallet dashboard.

3

Go to ClawWP → Settings → AgentWallet.

4

Enter your Username and API Key. The API URL is pre-filled with the default (https://hifriendbot.com/wp-json/agentwallet/v1/) — you can leave it as-is.

5

Click Test Connection to verify everything works.

Supported Chains

AgentWallet supports any EVM-compatible chain, including:

  • Ethereum (mainnet)
  • Base
  • Polygon
  • BSC (Binance Smart Chain)
  • PulseChain
  • And many more — any chain with an EVM RPC endpoint

What You Can Do

  • Check balance — “What’s my wallet balance on Base?”
  • Sign transactions — GuessMarket trades are signed automatically
  • Send tokens — “Send 0.1 ETH to 0x...”
  • View transaction history — “Show my recent transactions”

Pricing

6,000 free transactions per month. After that, just $0.0069 per transaction. No monthly commitment. Learn more

GuessMarket + AgentWallet

GuessMarket tools prepare blockchain transactions. AgentWallet signs and broadcasts them. Both are needed for fully automated prediction market trading. Without AgentWallet, you can still browse markets and get transaction data — you’ll just need to sign manually.

11 MCP Servers

MCP (Model Context Protocol) is an open standard that lets AI agents connect to external tools. ClawWP can connect to any MCP server to extend your agent’s capabilities. Free for all users.

Built-In MCP Servers

ClawWP includes a built-in connection to GuessMarket (prediction market trading). Just enable it in settings — no configuration needed. See GuessMarket & Prediction Markets for details.

Add Custom MCP Servers

Go to ClawWP → Settings → Custom MCP Servers to connect additional MCP servers.

1

Enter a Server Name to identify the server.

2

Choose a Transport type:

HTTP Transport

For remote MCP servers accessed via URL. Enter the Endpoint URL (e.g. https://example.com/mcp). Optionally configure authentication: None, Basic Auth (username:password), or Bearer Token.

Stdio Transport

For local MCP servers that run as a command. Enter the Command (e.g. npx some-mcp-server). ClawWP spawns the process, communicates via stdin/stdout, and manages the lifecycle automatically.

3

Click Add Server. ClawWP will connect to the server and discover its tools automatically.

Managing MCP Servers

  • The server table shows each server’s name, transport type (HTTP or STDIO badge), endpoint/command, and tool count.
  • Click Rediscover to refresh a server’s tool list (useful after the server adds new tools).
  • Click Remove to disconnect a server and remove its tools from your agent.
  • Discovered tools appear alongside ClawWP’s built-in tools — the agent can use them all in the same conversation.

Note: Stdio transport requires proc_open() to be enabled on your server. Most VPS and dedicated hosts support this. Some shared hosting environments may have it disabled. HTTP transport works on all hosts.

12 Pro License & Features

Activate Your License

1

Purchase ClawWP Pro at hifriendbot.com/clawwp. You will receive a license key (format: CLWP-XXXX-XXXX-XXXX) by email.

2

Go to ClawWP → Settings → Pro License.

3

Paste your license key and click Activate. You should see a green Active status with your tier displayed.

Each license key can be activated on 1 site. To move it to a different site, click Deactivate License first, then activate on the new site. Your license is validated periodically to ensure it remains active.

What You Unlock

HFB Proxy — 500K Tokens/Month

No API key needed. Requests routed through HiFriendbot.com. Just activate your license and start chatting.

AgentWallet Blockchain Trading

Sign and broadcast transactions on Ethereum, Base, Polygon, and any EVM chain. 6,000 free transactions/month.

Slack & Discord Channels

Connect Slack or Discord bots so your entire team can manage the site from the tools they already use.

WooCommerce Integration

Sales reports, inventory management, order tracking, product editing, and customer look-ups — all via natural language.

OpenAI Model Support

Use GPT-4o or other OpenAI models as an alternative to Claude for your AI provider.

Cognitive Memory

Memories persist across sessions with semantic search — the AI remembers your preferences, past instructions, and site context.

Scheduled Tasks

Set up recurring or one-time background operations the AI executes automatically.

Unlimited User Pairings

Pair as many Telegram, Slack, or Discord accounts as you need — no per-user limits.

13 Budget & Limits

Control your AI spending with built-in budget tracking. Found at ClawWP → Settings → Budget & Limits.

Monthly Budget

  • Set a Monthly Budget (USD) to cap your AI API spending. When using your own Anthropic or OpenAI key, ClawWP tracks estimated costs based on token usage and model pricing.
  • You will receive alerts at 80% and 100% of your budget. Once 100% is reached, the agent will stop making API calls until the next month.
  • Set to 0 for no limit.
  • Budget resets on the 1st of each month.

Cost Dashboard

Visit ClawWP → Dashboard to see:

  • Total spending this month with a progress bar against your budget
  • Daily breakdown of token usage and estimated costs
  • Per-conversation token counts so you can see which tasks cost the most

Tip: To keep costs low, use Claude Haiku 3.5 for simple tasks (comments, listing posts) and save Sonnet for complex writing and analysis. Or upgrade to Pro and use the HFB Proxy — 500K tokens/month included, no API key needed.

14 Security

Encrypted Credentials

All API keys, bot tokens, and credentials are protected with quantum-safe encryption. They are never stored in plain text.

Full Audit Log

Every action the AI agent takes is recorded in the Audit Log — who triggered it, what changed, and when.

Capability-Aware

Tool execution respects WordPress user roles and capabilities. Editors cannot delete users, subscribers cannot publish posts, etc.

Webhook Verification

Telegram, Slack, and Discord webhook requests are verified with secret tokens and signatures to prevent spoofed messages.

Mandatory Pairing

Channel users (Telegram, Slack, Discord) must pair with a WordPress account before they can execute any commands.

SSRF Protection

All outbound API connections validate URLs against private/reserved IP ranges to prevent server-side request forgery.

15 Troubleshooting

License Activation Failed

Make sure your license key matches the format CLWP-XXXX-XXXX-XXXX. Check that your site can reach hifriendbot.com (some hosts block outbound HTTP requests). If the key was previously activated on another site, deactivate it there first.

HTTP 400 / 401 Errors

Your API key may be invalid or out of credits. Double-check the key in ClawWP → Settings and verify your balance at your provider’s dashboard. If using HFB Proxy, verify your Pro license is active.

Telegram Bot Not Responding

Confirm the webhook registered successfully (look for the green Connected indicator next to your bot token). Re-check your bot token and make sure your site is accessible over HTTPS. Also verify your account is paired.

Slack Bot Not Responding

Verify the Bot Token and Signing Secret are correct. Make sure your Slack app has the right scopes (chat:write, im:history, im:read, im:write) and that Event Subscriptions are pointing to your site’s webhook URL. Check that your account is paired.

Discord Bot Not Responding

Make sure the Bot Token, Application ID, and Public Key are all entered correctly. Verify that the Interactions Endpoint URL is set to https://yoursite.com/wp-json/clawwp/v1/webhook/discord and that Message Content Intent is enabled on the bot. Check that your account is paired.

GuessMarket Tools Not Showing

Make sure GuessMarket is enabled in ClawWP → Settings. Click Discover Tools (or Rediscover) to refresh. If discovery fails, check that your server can reach mcp.hifriendbot.com.

AgentWallet Connection Failed

Verify your Username and API Key in ClawWP → Settings → AgentWallet. Use Test Connection to diagnose. Ensure your Pro license is active. The default API URL should be https://hifriendbot.com/wp-json/agentwallet/v1/.

MCP Stdio Server Not Working

Stdio transport requires proc_open() to be enabled in your PHP configuration. Check with your hosting provider. Also make sure the command (e.g. npx some-mcp-server) is available on your server’s PATH. HTTP transport works on all hosts as a fallback.

Pro Features Not Visible

Go to ClawWP → Settings → Pro License and verify the license shows as Active. AgentWallet, Slack, Discord, and other Pro features only appear when the license is activated. If it expired, renew at hifriendbot.com/clawwp.

High Costs

Set a monthly budget in ClawWP → Settings → Budget & Limits to cap spending. Switch to Claude Haiku 3.5 for significantly lower per-token costs. Or upgrade to Pro and use the HFB Proxy for 500K tokens/month included.

HFB Proxy Token Quota Exceeded

Pro licenses include 500K tokens/month via the HFB Proxy. If you hit the limit, you can switch to your own Anthropic API key in AI Provider settings for unlimited usage, or wait for the quota to reset on the 1st of the next month.

Need Help?

Email us at [email protected] and we will get back to you as quickly as possible.