Documentation Index
Fetch the complete documentation index at: https://docs.xquik.com/llms.txt
Use this file to discover all available pages before exploring further.
TweetClaw is the official OpenClaw plugin for using Xquik from an OpenClaw agent. It gives your agent a safe endpoint catalog, account-backed X automation, optional read-only MPP access, slash commands, and monitor notifications without exposing API keys to the model.
Use it when your OpenClaw workflow needs X search, user lookups, tweet posting, replies, likes, retweets, follows, DMs, monitors, webhooks, giveaway draws, extraction jobs, media actions, or trend reads.
Prerequisites
- OpenClaw
2026.5.4 or newer
- Node.js
22 or newer
- Xquik API key for account-backed automation
- Optional MPP setup for anonymous read-only pay-per-use calls
Install agent plugins only from trusted sources. OpenClaw plugin installs run code, and the official OpenClaw plugin CLI docs recommend pinned versions for production installs.
Install
Install the official OpenClaw package. Current OpenClaw checks ClawHub first, then npm:
openclaw plugins install @xquik/tweetclaw
openclaw plugins install @xquik/tweetclaw@1.6.20 --pin
@xquik/tweetclaw is the official package. The plugin id is tweetclaw. The current source-truth version is 1.6.20.
Create an API key from the Xquik dashboard, then configure TweetClaw:
export XQUIK_API_KEY="xq_..."
openclaw config set plugins.entries.tweetclaw.config.apiKey "$XQUIK_API_KEY"
npm i mppx viem
export MPP_SIGNING_KEY="0x..."
openclaw config set plugins.entries.tweetclaw.config.tempoSigningKey "$MPP_SIGNING_KEY"
Optional Settings
TweetClaw can poll Xquik events and surface monitor notifications in chat.
openclaw config set plugins.entries.tweetclaw.config.pollingEnabled true
openclaw config set plugins.entries.tweetclaw.config.pollingInterval 60
openclaw config set plugins.entries.tweetclaw.config.baseUrl "https://xquik.com"
| Tool | Purpose | Network Access |
|---|
explore | Search the bundled Xquik endpoint catalog and inspect parameters | No |
tweetclaw | Call catalog-listed Xquik endpoints with structured method, path, query, and body input | Yes |
explore tool is the safe first step. Ask the agent to inspect the catalog before it calls an endpoint:
Find the endpoint for searching tweets about AI agents, then show the required parameters.
tweetclaw tool is optional because it can spend credits, read private account data, or perform write-like actions. If OpenClaw hides optional tools, allow it explicitly:
openclaw config set tools.alsoAllow '["explore", "tweetclaw"]'
Slash Commands
| Command | Purpose |
|---|
/xstatus | Show Xquik account, subscription, usage, and credit balance |
/xtrends | Show current trending topics from curated sources |
/xtrends tech | Show trending topics filtered to the tech category |
Safety Model
TweetClaw keeps credentials in plugin config and injects auth at request time. The model does not receive your API key or MPP signing key as a tool argument.
OpenClaw approval prompts apply before write-like tweetclaw calls. Review the structured request before approving any post, delete, follow, DM, monitor change, extraction, webhook change, media action, profile change, or community action.
Dashboard-only account-admin, billing, support-ticket, and raw credential flows are excluded from the agent catalog and blocked at runtime.
API Coverage
TweetClaw exposes 99 agent-callable endpoints across 9 categories.
| Category | Examples |
|---|
| Account | Account status and usage |
| Composition | Compose, drafts, writing styles, and radar |
| Credits | Credit balance reads |
| Extraction | 23 extraction tool types, giveaway draws, and exports |
| Media | Upload media by URL, download tweet media, and gallery links |
| Monitoring | Account monitors, keyword monitors, events, and webhooks |
| Twitter | Search, lookups, timelines, articles, trends, bookmarks, and notifications |
| X Accounts | Connected account selection for explicit user actions |
| X Write | Post, reply, like, retweet, follow, remove follower, DM, profile, and community actions |
Verify
After installing and configuring the plugin, run:
Then test a read-only workflow:
Search tweets about AI agents and return the top 5 results with author handles.
tweetclaw:
Draft a short launch tweet for Xquik. Do not post it until I approve the exact text.
Troubleshooting
| Symptom | Fix |
|---|
tweetclaw is not available | Add explore and tweetclaw to tools.alsoAllow, then restart OpenClaw |
| Auth fails | Regenerate the Xquik API key and update plugins.entries.tweetclaw.config.apiKey |
| MPP calls fail | Confirm the MPP signing key is funded and only call MPP-eligible read endpoints |
| Monitor alerts do not appear | Set pollingEnabled to true and keep pollingInterval at 60 seconds or higher |
| Write action needs approval | Review the structured request and approve only the exact intended action |
References
Compare