TweetClaw

[image: npm] [image: License: MIT]

Post tweets, reply, like, retweet, follow, DM & more - directly from your chat. Full X/Twitter automation for OpenClaw.

Powered by Xquik, the all-in-one X automation platform. Reads from $0.00015/call - 33x cheaper than the official X API.

Pricing

TweetClaw uses Xquik's credit-based pricing. 1 credit = $0.00015.

vs Official X API

Per-Operation Costs

Pay-Per-Use (No Subscription)

Two options:

• Credits: Top up credits via the API ($10 minimum). 1 credit = $0.00015. Works with all 120 endpoints.
• MPP: 16 read-only X-API endpoints accept anonymous on-chain payments via Machine Payments Protocol. No account needed. SDK: npm i mppx viem.

Free Operations

Tweet composition, style analysis, drafts, curated radar (7 sources), account management, integrations, automations, support tickets - all free, no credits consumed.

Install

openclaw plugins install @xquik/tweetclaw

Configure

Option A: API key (full access, 120 endpoints)

Get an API key at dashboard.xquik.com. Store it in an environment variable and configure TweetClaw to use it:

openclaw config set plugins.entries.tweetclaw.config.apiKey "$XQUIK_API_KEY"

Security: Always reference your key via an environment variable — never paste raw keys into shell commands or config files.

Option B: Credits (pay-per-use, no subscription)

Top up credits from the Xquik dashboard or via POST /credits/topup. All 120 endpoints available. 1 credit = $0.00015.

Option C: MPP pay-per-use (no account needed, 16 read-only endpoints)

MPP (Machine Payments Protocol) lets agents pay per API call without an account, API key, or subscription. 16 read-only endpoints. Create an MPP account with mppx account create. The signing key stays local and is only used to sign payment proofs.

npm i mppx viem
openclaw config set plugins.entries.tweetclaw.config.tempoSigningKey "$MPP_SIGNING_KEY"

Security: Always store your signing key in an environment variable — never paste raw keys into shell commands or config files.

MPP-eligible endpoints: tweet lookup ($0.00015), tweet search ($0.00015/tweet), user lookup ($0.00015), user tweets ($0.00015/tweet), follower check ($0.00105), article lookup ($0.00105), media download ($0.00015/media), trends ($0.00045), X trends ($0.00045), quotes ($0.00015/tweet), replies ($0.00015/tweet), retweeters ($0.00015/user), favoriters ($0.00015/user), thread ($0.00015/tweet), user likes ($0.00015/tweet), user media ($0.00015/tweet).

Optional settings

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

Tools

TweetClaw uses Xquik's 2-tool approach to cover the entire API:

explore (free, no network)

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

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

AI uses explore → filters spec by category "composition"
→ Returns matching endpoints with parameters and response shapes

tweetclaw (execute API calls)

Execute authenticated API calls. Auth is injected automatically - the LLM never sees your API key.

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

AI uses tweetclaw → finds connected account, posts tweet
→ Returns { tweetId, success: true }

You: "Search tweets about AI agents"

AI uses explore → finds /api/v1/x/tweets/search
AI uses tweetclaw → calls the endpoint with auth
→ Returns tweet results

Commands

Instant responses, no LLM needed:

Event Notifications

When polling is enabled (default), TweetClaw checks for new events every 60 seconds and delivers them to your chat:

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

Set up a monitor first:

You: "Monitor @elonmusk for new tweets and follower changes"

API Coverage

120 endpoints across 12 categories:

Links

• Xquik Platform
• API Documentation
• Billing & Pricing
• npm Package
• OpenClaw

License

MIT