Tweetclaw

TweetClaw

OpenClaw plugin for X/Twitter automation powered by Xquik. Install via:

openclaw plugins install @xquik/tweetclaw

When to Use

Use TweetClaw when the user wants to:

• Post tweets, reply to tweets, or delete tweets
• Like, retweet, or follow/unfollow users
• Send DMs on X/Twitter
• Update their X profile, avatar, or banner
• Upload media and tweet with images
• Search tweets or look up user profiles
• Extract bulk data (followers, replies, communities, spaces)
• Run giveaway draws from tweet replies
• Monitor X accounts for new activity
• Compose algorithm-optimized tweets
• Analyze a user's writing style
• Check trending topics on X
• Download tweet media (images, videos, GIFs)
• Set up Telegram alerts for monitor events
• Create and manage automation flows (triggers, steps, test runs)
• Open and manage support tickets
• Read X Articles (long-form posts)

Do NOT use TweetClaw for browsing X in a browser, analytics dashboards, scheduling future posts, or managing X ads.

Configuration

API key mode (full access)

openclaw config set plugins.entries.tweetclaw.config.apiKey 'xq_YOUR_KEY'

Get a key at dashboard.xquik.com.

MPP mode (no account, pay-per-use via Tempo/USDC)

npm i mppx viem
openclaw config set plugins.entries.tweetclaw.config.tempoPrivateKey '0xYOUR_KEY'

MPP gives agents access to 7 read-only X-API endpoints without any account or subscription. The mppx SDK handles HTTP 402 payment challenges automatically.

Tools

TweetClaw registers 2 tools that cover the entire Xquik API (97 endpoints):

explore (free, no network)

Search the API spec to find endpoints. No API calls are made.

Example: "What endpoints are available for tweet composition?"

The agent writes an async arrow function that filters the in-memory endpoint catalog:

async () => spec.endpoints.filter(e => e.category === 'composition')

tweetclaw (execute API calls)

Execute authenticated API calls. Auth is injected automatically.

Example: "Post a tweet saying 'Hello from TweetClaw!'"

async () => {
  const { accounts } = await xquik.request('/api/v1/x/accounts');
  return xquik.request('/api/v1/x/tweets', {
    method: 'POST',
    body: { account: accounts[0].xUsername, text: 'Hello from TweetClaw!' }
  });
}

Commands

Event Notifications

When polling is enabled (default), TweetClaw checks for new events every 60 seconds:

• Monitor alerts: new tweets, replies, quotes, retweets from monitored accounts
• Follower changes: gained or lost followers on monitored accounts

Common Workflows

Post a tweet

You: "Post a tweet saying 'Hello from TweetClaw!'"
Agent uses tweetclaw -> finds connected account, posts tweet

Reply to a tweet

You: "Reply 'Great thread!' to this tweet: https://x.com/user/status/123"
Agent uses tweetclaw -> posts reply with reply_to_tweet_id

Like, retweet, follow

You: "Like and retweet this tweet, then follow the author"
Agent uses tweetclaw -> likes tweet, retweets, looks up user ID, follows

Send a DM

You: "DM @username saying 'Hey, let's collaborate!'"
Agent uses tweetclaw -> looks up user ID, sends DM

Update profile

You: "Change my bio to 'Building cool stuff' and update my avatar"
Agent uses tweetclaw -> PATCH /api/v1/x/profile, PATCH /api/v1/x/profile/avatar

Upload media and tweet with image

You: "Tweet 'Check this out!' with this image: https://example.com/photo.jpg"
Agent uses tweetclaw -> uploads media, posts tweet with media_ids

Search tweets

You: "Search tweets about AI agents"
Agent uses tweetclaw -> calls search endpoint with query

Run a giveaway draw

You: "Pick 3 random winners from replies to this tweet: https://x.com/..."
Agent uses tweetclaw -> creates draw with filters

Extract bulk data

You: "Extract the last 1000 followers of @elonmusk"
Agent uses tweetclaw -> estimates cost, creates extraction job

Monitor an account

You: "Monitor @elonmusk for new tweets and follower changes"
Agent uses tweetclaw -> creates monitor with event types

Download tweet media

You: "Download all media from this tweet"
Agent uses tweetclaw -> returns gallery URL with all media

Compose an optimized tweet (free)

You: "Help me write a tweet about our product launch"
Agent uses tweetclaw -> 3-step compose/refine/score workflow

Analyze writing style (free)

You: "Analyze @username's tweet style"
Agent uses tweetclaw -> returns style analysis with tone, patterns, metrics

Browse trending topics (free)

You: "What's trending on X right now?"
Agent uses tweetclaw -> returns curated trending topics from 7 sources

Create an automation flow (free)

You: "Create an automation that sends a DM when I get a new follower"
Agent uses tweetclaw -> creates flow with monitor_event trigger, adds send_dm step, tests it

Read an X Article

You: "Get the full article from this tweet: https://x.com/user/status/123"
Agent uses tweetclaw -> calls /api/v1/x/articles/:tweetId, returns title, body, images

Open a support ticket (free)

You: "Open a support ticket about my monitor not working"
Agent uses tweetclaw -> creates ticket with subject and description

API Categories

Pricing

MPP pay-per-use (no account): 7 read-only X-API endpoints via Tempo (USDC) - tweet lookup ($0.0003), tweet search ($0.0003/tweet), user lookup ($0.00036), follower check ($0.002), article ($0.002), media download ($0.0003/media), trends ($0.0009).

Free tier (API key, no subscription): tweet composition, style analysis, drafts, curated radar, account management, integrations, automations (create/test), support tickets.

Subscription ($20/month): write actions, search, article lookup, media, extractions, draws, monitors, X trending, flow activation (2 free, 10 subscriber).

When a paid endpoint returns 402, TweetClaw provides a checkout URL.

Tips

• Use explore first to discover endpoints before calling tweetclaw - saves tokens and avoids guessing
• Free endpoints (compose, styles, radar, drafts) work without a subscription - always try them first
• Never combine free and paid API calls in the same Promise.all - a 402 on one call kills all results
• For write actions (post, like, follow, DM), always pass the account parameter with the X username
• Follow/unfollow/DM require a numeric user ID - look up the user first via /api/v1/x/users/:username
• On 402 errors, call POST /api/v1/subscribe to get a checkout URL instead of giving up
• Use /xstatus to quickly check subscription and usage without invoking the AI agent
• The compose workflow (compose/refine/score) is free and helps draft high-engagement tweets