Twitter bot plugin for OpenClaw. Post, reply, search tweets, export followers & monitor accounts through Xquik. Not affiliated with X Corp.
TweetClaw, the OpenClaw X (Twitter) Bot Plugin
Use this OpenClaw Twitter plugin by Xquik to search tweets, export followers & post. Every write waits for your approval.
Xquik is the world's fastest and cheapest X (Twitter) scraper service with the most complete X (Twitter) data. Most other Apify Actors charge before filtering or deduplication. Xquik charges only for delivered, unique, filter-matching results and never pads rows. Xquik is independent and not affiliated with X Corp.
The Xquik REST API read 45 tweets per second on 2026-10-15, 3.6 times the 12.5 per second of the fastest of 4 rival Actors. It cost 13% less per 1,000 tweets than the cheapest of them. Compare each run.
Install the OpenClaw Twitter plugin
openclaw plugins install clawhub:@xquik/tweetclaw
OpenClaw records the verified ClawHub publisher scope and package as the update source.
Create an API key for account-backed X (Twitter) automation at dashboard.xquik.com. Then store it through OpenClaw.
openclaw config set plugins.entries.tweetclaw.config.apiKey "$XQUIK_API_KEY"
Add both tools without replacing the current profile.
openclaw config set tools.alsoAllow '["explore", "tweetclaw"]'
Run a Twitter bot & X (Twitter) automation from OpenClaw
Ask your agent in plain words. The bot posts only what you approve.
Reply to my latest post with a thank-you note
Post "Launch day" from my connected X account
Next, read the TweetClaw guide or the OpenClaw setup guide.
Benchmarks & usage
- 11,000+ downloads of @xquik/tweetclaw on npm (source)
- 2,700+ downloads of tweetclaw on ClawHub (source)
- 83 installs of this repo's Skills on skills.sh (source)
- This repo meets the OpenSSF Best Practices passing criteria (source)
Checked on 2026-11-08. See each number with its date & source on xquik.com/benchmarks or as JSON.
Scrape tweets & export followers
Reads run through the same tweetclaw tool.
Extractions export followers and following accounts.
Search tweets about "AI agents" from the last day
Export the followers of @NASA
Common OpenClaw tasks
Use explore before every live call.
It returns the current supported route.
| Customer question | Catalog query | Next step |
|---|---|---|
| How can I search tweets? | search tweets by query | Call the listed read route. |
| How can I read an X (Twitter) timeline? | list recent tweets posted by a user | Approve private timelines. |
| How can I export followers? | run extraction | Choose followers, then approve. |
| How can I scrape following accounts? | run extraction | Choose following, then approve. |
| How can I monitor an account or keyword? | create monitor | Approve recurring usage. |
| How can I post or reply? | create tweet | Approve each write. |
See the agent workflow guide for longer jobs.
Install options
Use openclaw plugins install npm:@xquik/tweetclaw when you need the npm fallback.
For normal upgrades, reuse the tracked install source.
openclaw plugins update tweetclaw
Pin a published npm version for reproducible production installs.
openclaw plugins install npm:@xquik/tweetclaw@<version> --pin
Pinned installs stay pinned during updates.
Run openclaw plugins update @xquik/tweetclaw to return to the stable release line.
Source builds require OpenClaw 2026.7.1 or newer.
OPENCLAW_NIX_MODE=1 turns off the plugin install and update commands.
Install or update TweetClaw through your Nix OpenClaw source instead.
Install TweetClaw before you add credentials if you want.
The free explore catalog works at once.
Live calls return setup guidance.
Agents with skill directories can install the packaged SKILL.md through Skills.sh.
Use the OpenClaw command above for the plugin runtime.
npx skills add xquik-dev/tweetclaw
TweetClaw is an OpenClaw plugin, not an MCP server.
For remote MCP clients, add https://xquik.com/mcp.
Then follow the client compatibility guide.
Configure
Keep API keys out of chats, documentation, logs & shell history.
Credits for pay per use without a subscription
Top up credits from the Xquik dashboard. An API key can spend prepaid credits on public paid reads without a subscription. TweetClaw does not create checkout sessions or charge saved payment methods from the agent.
Direct MPP for accountless pay per use
Machine Payments Protocol (MPP) pays for single lookups with no account or API key.
Create an MPP account with mppx account create.
npm i mppx@0.13.4 viem@2.57.5
openclaw config set plugins.entries.tweetclaw.config.tempoSigningKey "$MPP_SIGNING_KEY"
Keep the signing key in local OpenClaw config. Never put it in prompts or logs.
explore marks each MPP route with its price per call.
API coverage counts them.
Other paid reads use prepaid credits.
Media downloads and galleries require account-backed access.
Optional settings
openclaw config set plugins.entries.tweetclaw.config.baseUrl "https://xquik.com"
openclaw config set plugins.entries.tweetclaw.config.pollingEnabled true
openclaw config set plugins.entries.tweetclaw.config.pollingInterval 60
Change baseUrl only for a self-hosted Xquik-compatible API.
TweetClaw requires an HTTPS base URL with no embedded credentials.
OpenClaw trust model
TweetClaw uses 2 OpenClaw gates, which stop unattended publishing.
- Optional tool exposure.
exploreis a safe local catalog search that OpenClaw always loads.tweetclawcan read private data, spend credits or change X (Twitter) accounts. It stays off until you add it totools.alsoAllow. - Per-call approval. Writes, private reads, paid calls & account-scoped calls trigger a plugin approval prompt. Recurring jobs do too. TweetClaw offers one-time approval or deny for those calls.
Tools
explore (free, no network)
Search the bundled API catalog without a network request.
tweetclaw (invoke API endpoints)
Invoke catalog-listed endpoints with structured fields.
The runtime injects authentication.
X (Twitter) writes also require idempotencyKey.
Can your agent see the skill but not call TweetClaw tools?
Add explore and tweetclaw to tools.alsoAllow.
OpenClaw shows an approval prompt before each write-like tweetclaw call.
Review the structured request before you approve a post, DM, monitor, extraction or webhook.
Commands
These commands answer at once, without the LLM.
| Command | Description |
|---|---|
/xstatus | Account info, subscription status, usage & credit balance |
/xtrends | Curated topics with an API key. Worldwide X (Twitter) trends with MPP. |
/xtrends tech | API-key mode shows curated topics in 1 category. |
/xtrends 23424977 | MPP mode shows X (Twitter) trends for 1 WOEID. |
Event notifications
With polling on, TweetClaw checks your monitors every 60 seconds. It delivers new tweet, reply, quote & retweet events.
Set up a monitor first. Ask your agent in plain words.
Monitor @elonmusk for new tweets, replies, and retweets
Read response fields
TweetClaw keeps every allowed Xquik response field.
Optional fields stay absent when X (Twitter) omits them.
Request next_cursor while has_next_page is true.
Bookmark, like, follow, block, mute & notification state of the fetching account stays private.
See Read Data Richness for exact tweet, profile & media fields.
Pricing & access
TweetClaw uses Xquik billing for account-backed automation and optional MPP reads. See Billing & Pricing for current plans, eligible endpoints, and live prices.
API coverage
The live Xquik OpenAPI spec lists 223 operations. An operation is 1 method on 1 path.
Agents can call 192 of them through tweetclaw. TweetClaw leaves out the other 31.
| Left out | Operations |
|---|---|
| API keys, checkout & X account connection, which stay in the dashboard | 13 |
| X account connection, guest wallet checkout & support file downloads | 10 |
Documentation search outside /api/v1 | 8 |
21 of the 192 accept MPP. Run explore with mpp set to true to list them.
| Category | Examples | Access |
|---|---|---|
| Account | Account status | Account-backed |
| Analysis | Sentiment, brand, news, market signals, viral score, custom questions | Account-backed |
| Composition | Compose, drafts, writing styles, radar | Account-backed |
| Credits | Check balance | Account-backed |
| Extraction | Extraction tools, giveaway draws, exports | Account-backed |
| Media | Authenticated media download, gallery links | Account-backed |
| Monitoring | Create monitors, view events, manage webhooks, Telegram links | Account-backed |
| X (Twitter) | Search, lookups, timelines, articles, trends, lists, communities, Spaces, jobs, bookmarks, notifications | Account-backed or MPP where eligible |
| X (Twitter) accounts | List connected account handles for explicit user-selected actions | Account-backed |
| X (Twitter) write | Post, reply, like, retweet, follow, remove follower, DM, upload media, profile, communities | Account-backed with approval |
Questions
Do I need an X (Twitter) developer account?
No. Public reads need only an Xquik API key. Private reads & X (Twitter) account actions need a connected account.
Is TweetClaw the official X API?
No. Xquik runs its own REST API. TweetClaw calls that API, not the official X API.
More Xquik tools
- X (Twitter) scraper API & X (Twitter) MCP server with REST, MCP & Skill setup.
- X (Twitter) API SDKs for TypeScript, Python, Go & Ruby.
- X (Twitter) API SDKs for Java, Kotlin, C# & PHP.
- Twitter CLI & X CLI for terminal workflows.
- Twitter advanced search operators with tested examples.
- Hermes Agent Twitter plugin and the X (Twitter) API documentation source.
- Twitter integrations for n8n, Prefect, Haystack & Paperclip.
- Twitter integrations for Terraform, Convex, Supabase & Strapi.
- X (Twitter) MCP for AI agents, VS Code & Raycast.
- Xquik X API & Twitter scraper and the X (Twitter) API documentation.
License
Xquik is an independent third-party service. Not affiliated with X Corp. "Twitter" and "X" are trademarks of X Corp.
