Skip to content
Xquik-devPublic

Latest commit

 

History

2,343 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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. That cost $0.15 per 1,000. The fastest of 4 rival Actors read 12.5 per second. The cheapest cost $0.173 per 1,000. 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

@xquik/tweetclaw downloads on npm tweetclaw downloads on ClawHub tweetclaw Skill installs on skills.sh OpenSSF Best Practices

  • 12,000+ downloads of @xquik/tweetclaw on npm (source)
  • 2,800+ 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-09. 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. explore is a safe local catalog search that OpenClaw always loads. tweetclaw can read private data, spend credits or change X (Twitter) accounts. It stays off until you add it to tools.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

License

MIT

Xquik is an independent third-party service. Not affiliated with X Corp. "Twitter" and "X" are trademarks of X Corp.

Releases

Packages

Used by

Contributors

Languages