Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.xquik.com/llms.txt

Use this file to discover all available pages before exploring further.

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.5.4 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 package version: 
openclaw plugins install @xquik/tweetclaw@1.6.31 --pin
@xquik/tweetclaw is the official package. The plugin id is tweetclaw. The current source-truth version is 1.6.31.

​
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 31 read-only X API endpoints without an Xquik account or API key. Use it for agent research workflows that only need public X data. 
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.

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.
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 @xquikcom 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 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.
Return tweetId for confirmed posts, writeActionId for pending posts, and mediaId plus messageId for DMs.

​
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 MPP-eligible read endpoints.

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.

​
References

Last modified on May 18, 2026