TweetClaw, the Twitter bot plugin for OpenClaw

TweetClaw is the Twitter bot plugin for OpenClaw. It runs on Xquik.

Xquik is the world's fastest and cheapest X Twitter scraper service with the most complete X data. Xquik charges only for delivered, unique, filter-matching results and never pads rows.

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

Your agent can post, reply, search tweets, export followers & monitor accounts. Every write waits for your approval. Use Xquik MCP with remote MCP clients and an SDK in application code.

Common OpenClaw tasks

Use explore before every live call. It returns the current supported route.

Read response fields

TweetClaw keeps every allowed Xquik response field. Optional fields remain absent when X omits them. Request next_cursor while has_next_page is true.

Fetching-account bookmark, like, follow, block, mute, and notification state stays private.

See Read Data Richness for exact tweet, profile, and media fields.

Install

openclaw plugins install clawhub:@xquik/tweetclaw

OpenClaw records the verified ClawHub publisher scope and package as the update source.

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

For reproducible production installs, pin a published npm version.

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.

If your OpenClaw install runs with OPENCLAW_NIX_MODE=1, plugin lifecycle mutators are disabled. Install or update TweetClaw through your Nix OpenClaw source instead of openclaw plugins install or openclaw plugins update.

Install TweetClaw before adding credentials if needed. 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 current client compatibility path. OAuth-capable clients complete OAuth 2.1. Clients that support custom bearer headers can use an Xquik API key. ChatGPT custom apps require OAuth.

Codex OAuth compatibility. Affected Codex releases discard the RFC 9207 iss callback value even though Xquik returns it. If Codex reports Authorization server response missing required issuer: expected https://xquik.com, use XQUIK_API_KEY through the Codex bearer_token_env_var setting. Follow the Codex OAuth troubleshooting guide and track openai/codex#31573.

Pricing & access

TweetClaw uses Xquik billing for account-backed automation and optional MPP reads. See Billing & Pricing. Check it for current plans, eligible endpoints, and live prices.

Configure

API key for account-backed X automation

Create an API key at dashboard.xquik.com, then store it through OpenClaw.

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

Keep the key out of chats, documentation, logs, and shell history.

Credits for pay per use without a subscription

Top up credits from the Xquik dashboard. An API key can spend prepaid credits across public paid-read routes 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 without an account, API key, or subscription. 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.

Enable live API calls

OpenClaw always loads the local explore catalog. The tweetclaw API tool is optional because it can read private data, spend credits, or change X accounts. Add both tools without replacing the current profile.

openclaw config set tools.alsoAllow '["explore", "tweetclaw"]'

Verify runtime registration and packed releases with the OpenClaw setup guide.

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

Only change baseUrl 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.

• Optional tool exposure. explore is always safe local catalog search, while tweetclaw stays optional until the user allows it with tools.alsoAllow.
• Per-call approval. Write-like, private, paid, recurring, extraction, monitor, webhook, and account-scoped calls trigger a plugin approval prompt. TweetClaw offers one-time approval or deny for those calls so a social-account action is reviewed each time.

These gates prevent unattended publishing. Examples include Twitter search before drafting, reply review before draws, follower exports, approved media posts, user-created monitors, and reviewed webhook automation.

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 writes also require idempotencyKey.

This tool is optional in OpenClaw. If your agent can see the skill but cannot call TweetClaw tools, add explore and tweetclaw to tools.alsoAllow so your normal tool profile stays intact.

OpenClaw approval prompts are enforced before write-like tweetclaw tool calls. Review the structured request before approving any post, delete, follow, DM, monitor, extraction, webhook, or profile-change action. Risky calls offer one-time approval or deny so future social-account actions still require review.

Commands

These commands answer at once, without the LLM.

Event notifications

When polling is enabled, TweetClaw checks user-created monitors every 60 seconds and delivers new tweet, reply, quote, or retweet events.

Set up a monitor first. Ask your agent in plain words.

Monitor @elonmusk for new tweets, replies, and retweets

API coverage

The live Xquik OpenAPI spec lists 180 operations. An operation is 1 method on 1 path.

Agents can call 152 of them through tweetclaw. TweetClaw leaves out the other 28.

13 of the 152 accept MPP. Run explore with mpp set to true to list them.

References

• Xquik Platform
• API Documentation
• Billing & Pricing
• Context7 Agent Docs
• OpenClaw Setup Guide
• Agent Workflow Guide
• Framework guides for Mastra, CrewAI, LangChain, Pydantic AI, Google ADK, Microsoft Agent Framework, n8n, Zapier, Make, Pipedream, Composio migration
• npm Registry Metadata
• OpenClaw

License

MIT