TweetClaw for OpenClaw

TweetClaw is the official OpenClaw plugin for using Xquik from an OpenClaw agent. It gives your agent a safe endpoint catalog, account-backed X automation, optional read-only MPP access, slash commands, and monitor notifications without exposing API keys to the model. Use it when your OpenClaw workflow needs X search, user lookups, tweet posting, replies, likes, retweets, follows, DMs, monitors, webhooks, giveaway draws, extraction jobs, media actions, or trend reads.

Prerequisites

OpenClaw 2026.7.1 or newer
Node.js 22 or newer
Xquik API key for account-backed automation
Optional MPP setup for anonymous read-only pay-per-use calls

Install agent plugins only from trusted sources. OpenClaw plugin installs run code, and the official OpenClaw plugin CLI docs recommend pinned versions for production installs.

Install

Install the official OpenClaw package. Current OpenClaw checks ClawHub first, then npm:

openclaw plugins install @xquik/tweetclaw

For repeatable shared environments, pin the current published npm version:

openclaw plugins install @xquik/tweetclaw@1.6.37 --pin

@xquik/tweetclaw is the official package. The plugin id is tweetclaw. The current published npm version and source-truth version are both 1.6.37.

Configure API Key Auth

Create an API key from the Xquik dashboard, then configure TweetClaw:

export XQUIK_API_KEY="xq_..."
openclaw config set plugins.entries.tweetclaw.config.apiKey "$XQUIK_API_KEY"

API key auth unlocks account status, reads, monitor management, webhook management, extraction jobs, giveaway draws, media actions, and write actions for connected X accounts.

Configure MPP Pay-Per-Use

MPP lets TweetClaw call 7 read-only X API endpoints at fixed prices without an Xquik account or API key. Use a guest paid_reads key when the workflow needs the broader 33-route prepaid catalog.

npm i mppx viem
export MPP_SIGNING_KEY="0x..."
openclaw config set plugins.entries.tweetclaw.config.tempoSigningKey "$MPP_SIGNING_KEY"

MPP mode is read-only. Use API key auth when the agent needs private reads, account state, monitors, webhooks, extractions, draws, media downloads, media uploads, or write actions.

Optional Settings

TweetClaw can poll Xquik events and surface monitor notifications in chat.

openclaw config set plugins.entries.tweetclaw.config.pollingEnabled true
openclaw config set plugins.entries.tweetclaw.config.pollingInterval 60

Use the default base URL unless you operate a private Xquik deployment:

openclaw config set plugins.entries.tweetclaw.config.baseUrl "https://xquik.com"

Tools

explore

Search the bundled Xquik endpoint catalog and inspect parameters. This tool does not call the network.

tweetclaw

Call catalog-listed Xquik endpoints with structured method, path, query, and body input. This tool can make network requests.

The explore tool is the safe first step. Ask the agent to inspect the catalog before it calls an endpoint:

Find the endpoint for searching tweets about AI agents, then show the required parameters.

The tweetclaw tool is optional because it can spend credits, read private account data, or perform write-like actions. If OpenClaw hides optional tools, allow it explicitly:

openclaw config set tools.alsoAllow '["explore", "tweetclaw"]'

Workflow Handoffs

Use explore first, then call tweetclaw only for the endpoint, target, and limit you intend to run.

Tweet Replies Export

Estimate reply_extractor with targetTweetId, create the extraction, poll /api/v1/extractions/{id}, then return CSV, JSON, and XLSX export URLs.

Follower Export

Estimate follower_explorer with targetUsername, create the extraction, poll until completion, then export the job for CRM or warehouse import.

Monitor Webhook Handoff

Use explore to find monitor and webhook endpoints, then call tweetclaw for POST /api/v1/monitors or POST /api/v1/monitors/keywords and POST /api/v1/webhooks only after approval. Store the webhook secret in a secret manager. In receivers, verify X-Xquik-Signature, store deliveryId and streamEventId, return 2xx for accepted duplicates, and keep endpoint signing values, raw request body, raw signature, and full headers out of chat logs and shared workflow outputs.

Media Tweets and DM Attachments

For tweets or replies, call POST /api/v1/x/tweets with public media URLs in media. Store tweetId when confirmed; if the response includes writeActionId, poll GET /api/v1/x/write-actions/{id} before retrying. For DM attachments, upload media first, pass the returned mediaId as the one-item media_ids value, then store messageId. Keep full DM bodies out of shared outputs and leave reply_to_message_id unset.

Use explore to find reply_extractor extraction endpoints.
Estimate replies for tweet 1893704267862470862.
Create the job with targetTweetId and resultsLimit 500 only if allowed.
Return extraction id, status, poll URL, and CSV, JSON, and XLSX export URLs.

Use explore to find follower_explorer extraction endpoints.
Estimate followers for @username with resultsLimit 10000.
Create the job only if allowed.
Return extraction id, status, poll URL, and CSV, JSON, and XLSX export URLs.

Use explore to find monitor and webhook endpoints.
Create an account monitor or keyword monitor only after approval.
Register the receiver URL with POST /api/v1/webhooks.
Store the webhook secret in a secret manager.
Verify X-Xquik-Signature, store deliveryId and streamEventId, and return 2xx for accepted duplicates.
Keep endpoint signing values, raw request body, raw signature, and full headers out of chat logs and shared workflow outputs.

Use explore to find media write endpoints.
For a tweet or reply, call POST /api/v1/x/tweets with media set to public HTTPS image or MP4 URLs. Do not send media_ids.
If POST /api/v1/x/tweets returns writeActionId, store write_action_id, status, charged_credits, and poll GET /api/v1/x/write-actions/{id} before retrying.
For a DM attachment, call POST /api/v1/x/media first, then POST /api/v1/x/dm/{userId} with one media_ids value. Leave reply_to_message_id unset.
Return tweetId for confirmed posts, writeActionId for pending posts, and mediaId plus messageId for DMs.
Keep full DM bodies out of shared outputs.

Runtime Diagnostics

TweetClaw can be installed before credentials are configured. In that state, use explore for free endpoint discovery. Live API calls return setup guidance until you add an API key or MPP signing key. Verify runtime registration after install or update:

openclaw plugins inspect tweetclaw --runtime
openclaw skills info tweetclaw

If the agent can see the TweetClaw skill but cannot call the tools, add explore and tweetclaw to tools.alsoAllow so your normal tool profile stays intact. Only change baseUrl for a self-hosted Xquik-compatible API. TweetClaw requires an HTTPS base URL with no embedded credentials.

Slash Commands

/xstatus

Show the connected X account, email, locale, subscription status, plan, and usage when API key auth is configured.

/xtrends

Show current topics from Xquik Radar.

/xtrends tech

Show current Xquik Radar topics filtered by the tech category.

Safety Model

TweetClaw keeps credentials in plugin config and injects auth at request time. The model does not receive your API key or MPP signing key as a tool argument. OpenClaw approval prompts apply before write-like tweetclaw calls. Review the structured request before approving any post, delete, follow, DM, monitor change, extraction, webhook change, media action, profile change, or community action. Dashboard-only account-admin, billing, support-ticket, and raw credential flows are excluded from the agent catalog and blocked at runtime.

API Coverage

TweetClaw exposes 99 agent-callable endpoints across 9 categories.

account

1 endpoint for account status and usage.

composition

13 endpoints for compose, drafts, writing styles, and radar.

credits

1 endpoint for credit balance reads.

extraction

9 endpoints for extraction jobs, giveaway draws, and exports.

media

1 endpoint for authenticated tweet media downloads and gallery links.

monitoring

18 endpoints for account monitors, keyword monitors, events, and webhooks.

twitter

37 endpoints for search, lookups, timelines, articles, trends, bookmarks, and notifications.

x-accounts

1 endpoint for listing connected accounts before explicit user-selected actions.

x-write

18 endpoints for post, reply, like, retweet, follow, remove follower, DM, profile, media, and community actions.

Verify

After installing and configuring the plugin, run:

/xstatus

Then test a read-only workflow:

Search tweets about AI agents and return the top 5 results with author handles.

For write workflows, ask the agent to draft first and request approval before calling tweetclaw:

Draft a short launch tweet for Xquik. Do not post it until I approve the exact text.

Troubleshooting

Tools Missing

Add explore and tweetclaw to tools.alsoAllow, run the runtime inspection commands, then restart OpenClaw.

Auth Fails

Create a fresh Xquik API key and update plugins.entries.tweetclaw.config.apiKey.

MPP Setup Fails

Install mppx and viem, fund the MPP account, and call only the 7 direct MPP operations.

Monitor Alerts Missing

Set pollingEnabled to true and keep pollingInterval at 60 seconds or higher.

Write Approval Required

Review the structured request and approve only the exact intended post, delete, follow, DM, monitor, extraction, webhook, profile, or community action.

​Prerequisites

​Install

​Configure API Key Auth

​Configure MPP Pay-Per-Use

​Optional Settings

​Tools

explore

tweetclaw

​Workflow Handoffs

Tweet Replies Export

Follower Export

Monitor Webhook Handoff

Media Tweets and DM Attachments

​Runtime Diagnostics

​Slash Commands

/xstatus

/xtrends

/xtrends tech

​Safety Model

​API Coverage

account

composition

credits

extraction

media

monitoring

twitter

x-accounts

x-write

​Verify

​Troubleshooting

Tools Missing

Auth Fails

MPP Setup Fails

Monitor Alerts Missing

Write Approval Required

​References

Prerequisites

Install

Configure API Key Auth

Configure MPP Pay-Per-Use

Optional Settings

Tools

Workflow Handoffs

Runtime Diagnostics

Slash Commands

Safety Model

API Coverage

Verify

Troubleshooting

References