@xquik/tweetclaw 1.2.0 → 1.3.0

package/README.md

@@ -12,14 +12,26 @@ openclaw plugins install @xquik/tweetclaw
 
 ## Configure
 
-1. Get an API key at [xquik.com/account-manager](https://xquik.com/account-manager)
-2. Set it in OpenClaw:
+### Option A: API key (full access, 97 endpoints)
 
 ```bash
 openclaw config set plugins.entries.tweetclaw.config.apiKey 'xq_YOUR_KEY'
 ```
 
-Optional settings:
+Get a key at [dashboard.xquik.com/en/account?tab=x-accounts](https://dashboard.xquik.com/en/account?tab=x-accounts).
+
+### Option B: MPP pay-per-use (no account needed, 7 read-only endpoints)
+
+```bash
+npm i mppx viem
+openclaw config set plugins.entries.tweetclaw.config.tempoPrivateKey '0xYOUR_TEMPO_KEY'
+```
+
+MPP (Machine Payments Protocol) lets agents pay per API call via Tempo (USDC). No account, no API key, no subscription. Get a Tempo wallet at [tempo.xyz](https://tempo.xyz).
+
+MPP-eligible endpoints: tweet lookup ($0.0003), tweet search ($0.0003/tweet), user lookup ($0.00036), follower check ($0.002), article lookup ($0.002), media download ($0.0003/media), trends ($0.0009).
+
+### Optional settings
 
 ```bash
 openclaw config set plugins.entries.tweetclaw.config.pollingEnabled true
@@ -85,36 +97,45 @@ You: "Monitor @elonmusk for new tweets and follower changes"
 
 ## API Coverage
 
-40+ endpoints across these categories:
+97 endpoints across these categories:
 
 | Category | Examples |
 |----------|---------|
 | **Write Actions** | Post tweets, reply, like, retweet, follow, unfollow, DM, update profile & avatar |
 | **Media** | Upload media via URL, download tweet media, get gallery links |
-| **Twitter** | Search tweets, look up users, check follow relationships |
+| **Twitter** | Search tweets, look up users, check follow relationships, get articles |
 | **Composition** | Compose, refine, score tweets; manage drafts; analyze writing styles |
 | **Extraction** | Run extraction jobs (reply-extractor, community-explorer, etc.) |
 | **Draws** | Run giveaway draws on tweets, export results |
 | **Monitoring** | Create monitors, view events, manage webhooks |
+| **Automations** | Create flows, add steps, test runs, inbound webhooks |
 | **Account** | Manage API keys, subscription, connected X accounts |
 | **Trends** | X trending topics, curated radar from multiple sources |
+| **Support** | Create tickets, reply, track status |
 
 ## Pricing
 
-**Free tier** (no subscription needed):
+**MPP pay-per-use** (no account needed):
+- 7 read-only X-API endpoints via Tempo (USDC)
+- Tweet/user/article lookup, search, follower check, media download, trends
+
+**Free tier** (API key, no subscription needed):
 - Tweet composition, style analysis, drafts
 - Curated trending radar
 - Account management, API keys
 - Integrations management
+- Flow automations (create, test, inbound webhooks)
+- Support tickets
 
 **Subscription ($20/month)** for full access:
 - Write actions (post, reply, like, retweet, follow, DM, update profile)
-- Tweet search, user lookup, media download
+- Tweet search, user lookup, article lookup, media download
 - Extractions, giveaway draws
 - Account monitors, events, webhooks
 - X trending topics
+- Flow activation (free: 2 flows, subscriber: 10)
 
-When a paid endpoint returns 402, TweetClaw automatically provides a checkout URL.
+When a paid endpoint returns 402, TweetClaw provides a checkout URL (API key mode) or auto-pays via Tempo (MPP mode).
 
 ## License
 

package/openclaw.plugin.json

@@ -1,21 +1,26 @@
 {
   "id": "tweetclaw",
   "name": "TweetClaw",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Post tweets, reply, like, retweet, follow, DM from your chat - full X/Twitter automation powered by Xquik",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
     "properties": {
-      "apiKey": { "type": "string", "minLength": 1, "description": "Xquik API key (get one at xquik.com/account-manager)" },
+      "apiKey": { "type": "string", "minLength": 1, "description": "Xquik API key (get one at dashboard.xquik.com/en/account?tab=x-accounts). Required for full access." },
+      "tempoPrivateKey": { "type": "string", "minLength": 1, "description": "Tempo wallet private key for MPP pay-per-use mode. No account needed. Only 7 read-only X-API endpoints." },
       "baseUrl": { "type": "string", "default": "https://xquik.com" },
       "pollingInterval": { "type": "number", "default": 60, "description": "Event polling interval in seconds" },
       "pollingEnabled": { "type": "boolean", "default": true }
     },
-    "required": ["apiKey"]
+    "anyOf": [
+      { "required": ["apiKey"] },
+      { "required": ["tempoPrivateKey"] }
+    ]
   },
   "uiHints": {
-    "apiKey": { "label": "Xquik API Key", "sensitive": true, "placeholder": "xq_...", "help": "Generate at xquik.com/account-manager. Required for all API calls." },
+    "apiKey": { "label": "Xquik API Key", "sensitive": true, "placeholder": "xq_...", "help": "Full access to all 97 endpoints. Generate at dashboard.xquik.com/en/account?tab=x-accounts." },
+    "tempoPrivateKey": { "label": "Tempo Private Key (MPP)", "sensitive": true, "placeholder": "0x...", "help": "Pay-per-use mode via Machine Payments Protocol. No account needed. 7 read-only X-API endpoints only. Requires mppx and viem packages." },
     "baseUrl": { "label": "API Base URL", "placeholder": "https://xquik.com", "advanced": true, "help": "Only change if using a self-hosted Xquik instance." },
     "pollingInterval": { "label": "Event Poll Interval (seconds)", "advanced": true, "help": "How often to check for new monitor events. Default: 60 seconds." },
     "pollingEnabled": { "label": "Enable Event Notifications", "advanced": true, "help": "Deliver monitor alerts and extraction completions to your chat." }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xquik/tweetclaw",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Post tweets, reply, like, retweet, follow, DM & more from OpenClaw - full X/Twitter automation via Xquik",
   "license": "MIT",
   "type": "module",
@@ -45,7 +45,13 @@
     "check:all": "npm run typecheck && npm run lint && npm run cpd && npm run knip && npm run check-suppressions && npm run check-em-dash && npm run test:coverage"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.2.0"
+    "mppx": ">=0.1.0",
+    "openclaw": ">=2026.2.0",
+    "viem": ">=2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "mppx": { "optional": true },
+    "viem": { "optional": true }
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",

package/skills/tweetclaw/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: tweetclaw
-description: "OpenClaw plugin for X/Twitter automation. Post tweets, reply, like, retweet, follow, DM, search, extract data, run giveaways, monitor accounts via Xquik. 40+ endpoints, 2 tools (explore + tweetclaw), 2 commands (/xstatus, /xtrends), background event poller."
+description: "OpenClaw plugin for X/Twitter automation. Post tweets, reply, like, retweet, follow, DM, search, extract data, run giveaways, monitor accounts, automate flows via Xquik. 97 endpoints, 2 tools (explore + tweetclaw), 2 commands (/xstatus, /xtrends), background event poller."
 homepage: https://xquik.com
 read_when:
   - Posting, replying, liking, retweeting, or following on X/Twitter
@@ -11,7 +11,7 @@ read_when:
   - Extracting bulk data from X/Twitter (followers, replies, communities)
   - Downloading tweet media or uploading images
   - Sending DMs or updating X/Twitter profile
-metadata: {"openclaw":{"emoji":"🐦","primaryEnv":"XQUIK_API_KEY","requires":{"env":["XQUIK_API_KEY"]}}}
+metadata: {"openclaw":{"emoji":"🐦","primaryEnv":"XQUIK_API_KEY","requires":{"env":["XQUIK_API_KEY"]},"tags":["twitter","x","automation","social-media","tweets","scraping","giveaway","monitoring","rest-api"]}}
 ---
 
 # TweetClaw
@@ -22,17 +22,52 @@ OpenClaw plugin for X/Twitter automation powered by Xquik. Install via:
 openclaw plugins install @xquik/tweetclaw
 ```
 
+## When to Use
+
+Use TweetClaw when the user wants to:
+
+- Post tweets, reply to tweets, or delete tweets
+- Like, retweet, or follow/unfollow users
+- Send DMs on X/Twitter
+- Update their X profile, avatar, or banner
+- Upload media and tweet with images
+- Search tweets or look up user profiles
+- Extract bulk data (followers, replies, communities, spaces)
+- Run giveaway draws from tweet replies
+- Monitor X accounts for new activity
+- Compose algorithm-optimized tweets
+- Analyze a user's writing style
+- Check trending topics on X
+- Download tweet media (images, videos, GIFs)
+- Set up Telegram alerts for monitor events
+- Create and manage automation flows (triggers, steps, test runs)
+- Open and manage support tickets
+- Read X Articles (long-form posts)
+
+Do NOT use TweetClaw for browsing X in a browser, analytics dashboards, scheduling future posts, or managing X ads.
+
 ## Configuration
 
-Set your Xquik API key (get one at [xquik.com/account-manager](https://xquik.com/account-manager)):
+### API key mode (full access)
 
 ```bash
 openclaw config set plugins.entries.tweetclaw.config.apiKey 'xq_YOUR_KEY'
 ```
 
+Get a key at [dashboard.xquik.com/en/account?tab=x-accounts](https://dashboard.xquik.com/en/account?tab=x-accounts).
+
+### MPP mode (no account, pay-per-use via Tempo/USDC)
+
+```bash
+npm i mppx viem
+openclaw config set plugins.entries.tweetclaw.config.tempoPrivateKey '0xYOUR_KEY'
+```
+
+MPP gives agents access to 7 read-only X-API endpoints without any account or subscription. The mppx SDK handles HTTP 402 payment challenges automatically.
+
 ## Tools
 
-TweetClaw registers 2 tools that cover the entire Xquik API (40+ endpoints):
+TweetClaw registers 2 tools that cover the entire Xquik API (97 endpoints):
 
 ### `explore` (free, no network)
 
@@ -177,6 +212,27 @@ You: "What's trending on X right now?"
 Agent uses tweetclaw -> returns curated trending topics from 7 sources
 ```
 
+### Create an automation flow (free)
+
+```
+You: "Create an automation that sends a DM when I get a new follower"
+Agent uses tweetclaw -> creates flow with monitor_event trigger, adds send_dm step, tests it
+```
+
+### Read an X Article
+
+```
+You: "Get the full article from this tweet: https://x.com/user/status/123"
+Agent uses tweetclaw -> calls /api/v1/x/articles/:tweetId, returns title, body, images
+```
+
+### Open a support ticket (free)
+
+```
+You: "Open a support ticket about my monitor not working"
+Agent uses tweetclaw -> creates ticket with subject and description
+```
+
 ## API Categories
 
 | Category | Examples | Free |
@@ -189,20 +245,28 @@ Agent uses tweetclaw -> returns curated trending topics from 7 sources
 | Extraction | Reply/follower/community extraction (20 tools) | No |
 | Draws | Giveaway draws, export results | No |
 | Monitoring | Create monitors, view events, webhooks | No |
+| Automations | Create flows, add steps, test runs, inbound webhooks | Yes |
 | Account | API keys, subscription, connected X accounts | Yes |
 | Trends | X trending topics, curated radar from 7 sources | Mixed |
+| Support | Create tickets, reply, track status | Yes |
 
 ## Pricing
 
-Free tier (no subscription): tweet composition, style analysis, drafts, curated radar, account management, integrations.
+MPP pay-per-use (no account): 7 read-only X-API endpoints via Tempo (USDC) - tweet lookup ($0.0003), tweet search ($0.0003/tweet), user lookup ($0.00036), follower check ($0.002), article ($0.002), media download ($0.0003/media), trends ($0.0009).
+
+Free tier (API key, no subscription): tweet composition, style analysis, drafts, curated radar, account management, integrations, automations (create/test), support tickets.
 
-Subscription ($20/month): write actions, search, media, extractions, draws, monitors, X trending.
+Subscription ($20/month): write actions, search, article lookup, media, extractions, draws, monitors, X trending, flow activation (2 free, 10 subscriber).
 
 When a paid endpoint returns 402, TweetClaw provides a checkout URL.
 
-## When NOT to Use
+## Tips
 
-- Reading tweets in a browser or basic browsing (use a browser skill instead)
-- X/Twitter analytics dashboards (TweetClaw returns raw data, not visualizations)
-- Scheduling tweets for future posting (Xquik posts immediately)
-- Managing X/Twitter ads or promoted content (not supported)
+- Use `explore` first to discover endpoints before calling `tweetclaw` - saves tokens and avoids guessing
+- Free endpoints (compose, styles, radar, drafts) work without a subscription - always try them first
+- Never combine free and paid API calls in the same `Promise.all` - a 402 on one call kills all results
+- For write actions (post, like, follow, DM), always pass the `account` parameter with the X username
+- Follow/unfollow/DM require a numeric user ID - look up the user first via `/api/v1/x/users/:username`
+- On 402 errors, call `POST /api/v1/subscribe` to get a checkout URL instead of giving up
+- Use `/xstatus` to quickly check subscription and usage without invoking the AI agent
+- The compose workflow (compose/refine/score) is free and helps draft high-engagement tweets

package/src/api-spec.ts

@@ -21,13 +21,16 @@ const EXTRACTION_SEARCH_PARAMS: readonly EndpointParameter[] = [
   { description: 'Language code filter, e.g. en, tr (tweet_search_extractor)', in: 'body', name: 'language', required: false, type: 'string' },
   { description: 'Start date YYYY-MM-DD (tweet_search_extractor)', in: 'body', name: 'sinceDate', required: false, type: 'string' },
   { description: 'End date YYYY-MM-DD (tweet_search_extractor)', in: 'body', name: 'untilDate', required: false, type: 'string' },
-  { description: 'Filter by media type: images, videos, links (tweet_search_extractor)', in: 'body', name: 'mediaType', required: false, type: 'string' },
+  { description: 'Filter by media type: images, videos, gifs, media (tweet_search_extractor)', in: 'body', name: 'mediaType', required: false, type: 'string' },
   { description: 'Minimum likes threshold (tweet_search_extractor)', in: 'body', name: 'minFaves', required: false, type: 'number' },
   { description: 'Minimum retweets threshold (tweet_search_extractor)', in: 'body', name: 'minRetweets', required: false, type: 'number' },
   { description: 'Minimum replies threshold (tweet_search_extractor)', in: 'body', name: 'minReplies', required: false, type: 'number' },
   { description: 'Only verified authors (tweet_search_extractor)', in: 'body', name: 'verifiedOnly', required: false, type: 'boolean' },
-  { description: 'Include or exclude replies (tweet_search_extractor): include, exclude', in: 'body', name: 'replies', required: false, type: 'string' },
-  { description: 'Include or exclude retweets (tweet_search_extractor): include, exclude', in: 'body', name: 'retweets', required: false, type: 'string' },
+  { description: 'Control reply inclusion (tweet_search_extractor): include, exclude, only', in: 'body', name: 'replies', required: false, type: 'string' },
+  { description: 'Control retweet inclusion (tweet_search_extractor): include, exclude, only', in: 'body', name: 'retweets', required: false, type: 'string' },
+  { description: 'Exact phrase match (tweet_search_extractor)', in: 'body', name: 'exactPhrase', required: false, type: 'string' },
+  { description: 'Comma-separated words to exclude (tweet_search_extractor)', in: 'body', name: 'excludeWords', required: false, type: 'string' },
+  { description: 'Raw X search operators (tweet_search_extractor)', in: 'body', name: 'advancedQuery', required: false, type: 'string' },
 ];
 
 const PARAM_STYLE_USERNAME: EndpointParameter =
@@ -84,8 +87,16 @@ const PARAM_MEDIA_URL: EndpointParameter =
   { description: 'URL to download media from (alternative to file, HTTPS only)', in: 'body', name: 'url', required: false, type: 'string' };
 
 const RESPONSE_COMMUNITY_ACTION = '{ communityId, communityName, success: true }';
+const CATEGORY_AUTOMATIONS = 'automations';
+const CATEGORY_SUPPORT = 'support';
 const CATEGORY_X_WRITE = 'x-write';
 
+const PARAM_AUTOMATION_SLUG: EndpointParameter =
+  { description: 'Flow slug', in: 'path', name: 'slug', required: true, type: 'string' };
+
+const PARAM_TICKET_ID: EndpointParameter =
+  { description: 'Ticket public ID', in: 'path', name: 'id', required: true, type: 'string' };
+
 const API_SPEC: readonly EndpointInfo[] = [
   // --- Account ---
   {
@@ -305,13 +316,14 @@ const API_SPEC: readonly EndpointInfo[] = [
     method: 'GET',
     parameters: [
       { description: 'Filter by category (general, tech, dev, etc.)', in: 'query', name: 'category', required: false, type: 'string' },
-      { description: 'Number of items to return', in: 'query', name: 'count', required: false, type: 'number' },
-      { description: 'Lookback window in hours', in: 'query', name: 'hours', required: false, type: 'number' },
-      { description: 'Region filter (us, global, etc.)', in: 'query', name: 'region', required: false, type: 'string' },
-      { description: 'Source filter (google, hackernews, reddit, etc.)', in: 'query', name: 'source', required: false, type: 'string' },
+      { description: 'Max items to return (1-100, default 50)', in: 'query', name: 'limit', required: false, type: 'number' },
+      { description: 'Lookback window in hours (1-72, default 6)', in: 'query', name: 'hours', required: false, type: 'number' },
+      { description: 'Region filter (US, GB, TR, ES, DE, FR, JP, IN, BR, CA, MX, global)', in: 'query', name: 'region', required: false, type: 'string' },
+      { description: 'Source filter (github, google_trends, hacker_news, polymarket, reddit, trustmrr, wikipedia)', in: 'query', name: 'source', required: false, type: 'string' },
+      { description: DESCRIPTION_PAGINATION_CURSOR, in: 'query', name: 'after', required: false, type: 'string' },
     ],
     path: '/api/v1/radar',
-    responseShape: '{ items: [{ title, url?, score, category, source, region, publishedAt }], total }',
+    responseShape: '{ items: [{ title, url?, score, category, source, region, publishedAt }], hasMore, nextCursor? }',
     summary: 'Get trending topics from curated radar sources',
   },
 
@@ -374,10 +386,13 @@ const API_SPEC: readonly EndpointInfo[] = [
     free: false,
     method: 'POST',
     parameters: [
-      { description: 'Extraction tool type (reply-extractor, community-explorer, etc.)', in: 'body', name: 'toolType', required: true, type: 'string' },
+      { description: 'Extraction tool type (reply_extractor, community_extractor, etc.)', in: 'body', name: 'toolType', required: true, type: 'string' },
       { description: 'Target X username', in: 'body', name: 'targetUsername', required: false, type: 'string' },
       { description: 'Target tweet ID', in: 'body', name: 'targetTweetId', required: false, type: 'string' },
-      { description: 'Search query for tweet search tools', in: 'body', name: 'searchQuery', required: false, type: 'string' },
+      { description: 'Search query for search tools', in: 'body', name: 'searchQuery', required: false, type: 'string' },
+      { description: 'Community ID for community tools', in: 'body', name: 'targetCommunityId', required: false, type: 'string' },
+      { description: 'List ID for list tools', in: 'body', name: 'targetListId', required: false, type: 'string' },
+      { description: 'Space ID for space_explorer', in: 'body', name: 'targetSpaceId', required: false, type: 'string' },
       { description: 'Max results to return', in: 'body', name: 'resultsLimit', required: false, type: 'number' },
       ...EXTRACTION_SEARCH_PARAMS,
     ],
@@ -393,6 +408,10 @@ const API_SPEC: readonly EndpointInfo[] = [
       { description: 'Extraction tool type', in: 'body', name: 'toolType', required: true, type: 'string' },
       { description: 'Target X username', in: 'body', name: 'targetUsername', required: false, type: 'string' },
       { description: 'Target tweet ID', in: 'body', name: 'targetTweetId', required: false, type: 'string' },
+      { description: 'Search query for search tools', in: 'body', name: 'searchQuery', required: false, type: 'string' },
+      { description: 'Community ID for community tools', in: 'body', name: 'targetCommunityId', required: false, type: 'string' },
+      { description: 'List ID for list tools', in: 'body', name: 'targetListId', required: false, type: 'string' },
+      { description: 'Space ID for space_explorer', in: 'body', name: 'targetSpaceId', required: false, type: 'string' },
       { description: 'Max results to return', in: 'body', name: 'resultsLimit', required: false, type: 'number' },
       ...EXTRACTION_SEARCH_PARAMS,
     ],
@@ -569,6 +588,7 @@ const API_SPEC: readonly EndpointInfo[] = [
     parameters: [
       { description: 'Tweet ID to look up', in: 'path', name: 'tweetId', required: true, type: 'string' },
     ],
+    mpp: { intent: 'charge', price: '$0.0003/call' },
     path: '/api/v1/x/tweets/:tweetId',
     responseShape: '{ tweet: { id, text, likeCount, retweetCount, replyCount, viewCount, ... }, author? }',
     summary: 'Look up a single tweet with engagement metrics',
@@ -581,6 +601,7 @@ const API_SPEC: readonly EndpointInfo[] = [
       { description: 'Search query (X search syntax)', in: 'query', name: 'q', required: true, type: 'string' },
       { description: 'Max tweets to return (default 20, max 200)', in: 'query', name: 'limit', required: false, type: 'number' },
     ],
+    mpp: { intent: 'session', price: '$0.0003/tweet' },
     path: '/api/v1/x/tweets/search',
     responseShape: '{ tweets: [{ id, text, author?, likeCount?, retweetCount?, media? }], total }',
     summary: 'Search tweets by query with optional limit for pagination',
@@ -592,6 +613,7 @@ const API_SPEC: readonly EndpointInfo[] = [
     parameters: [
       { description: 'X username to look up', in: 'path', name: 'username', required: true, type: 'string' },
     ],
+    mpp: { intent: 'charge', price: '$0.00036/call' },
     path: '/api/v1/x/users/:username',
     responseShape: '{ id, username, name, followers?, following?, verified?, description? }',
     summary: 'Get X user profile by username',
@@ -604,10 +626,23 @@ const API_SPEC: readonly EndpointInfo[] = [
       { description: 'Source username', in: 'query', name: 'source', required: true, type: 'string' },
       { description: 'Target username', in: 'query', name: 'target', required: true, type: 'string' },
     ],
+    mpp: { intent: 'charge', price: '$0.002/call' },
     path: '/api/v1/x/followers/check',
     responseShape: '{ isFollowing, isFollowedBy, sourceUsername, targetUsername }',
     summary: 'Check follow relationship between two users',
   },
+  {
+    category: 'twitter',
+    free: false,
+    method: 'GET',
+    parameters: [
+      { description: 'Tweet ID of the X Article', in: 'path', name: 'tweetId', required: true, type: 'string' },
+    ],
+    mpp: { intent: 'charge', price: '$0.002/call' },
+    path: '/api/v1/x/articles/:tweetId',
+    responseShape: '{ article: { title, previewText, coverImageUrl, contents, createdAt, likeCount, replyCount, quoteCount, viewCount }, author? }',
+    summary: 'Get full content of an X Article (long-form post) by tweet ID',
+  },
 
   // --- Media ---
   {
@@ -618,6 +653,7 @@ const API_SPEC: readonly EndpointInfo[] = [
       { description: 'Tweet URL or ID (single tweet)', in: 'body', name: 'tweetInput', required: false, type: 'string' },
       { description: 'Array of tweet URLs or IDs (bulk, max 50)', in: 'body', name: 'tweetIds', required: false, type: 'string[]' },
     ],
+    mpp: { intent: 'session', price: '$0.0003/media' },
     path: '/api/v1/x/media/download',
     responseShape: 'Single: { tweetId, galleryUrl, cacheHit }. Bulk: { galleryUrl, totalTweets, totalMedia }',
     summary: 'Download media from tweets. Single tweetInput or bulk tweetIds. Returns gallery URL.',
@@ -632,6 +668,7 @@ const API_SPEC: readonly EndpointInfo[] = [
       { description: 'WOEID location ID (1 for worldwide)', in: 'query', name: 'woeid', required: false, type: 'number' },
       { description: 'Max number of trends', in: 'query', name: 'count', required: false, type: 'number' },
     ],
+    mpp: { intent: 'charge', price: '$0.0009/call' },
     path: '/api/v1/trends',
     responseShape: '{ trends: [{ name, query?, description?, rank? }], total, woeid }',
     summary: 'Get current trending topics on X',
@@ -1019,6 +1056,201 @@ const API_SPEC: readonly EndpointInfo[] = [
     responseShape: RESPONSE_COMMUNITY_ACTION,
     summary: 'Leave community',
   },
+
+  // --- Automations ---
+  {
+    category: CATEGORY_AUTOMATIONS,
+    free: true,
+    method: 'GET',
+    path: '/api/v1/automations',
+    responseShape: '{ items: [{ id, name, slug, triggerType, triggerConfig, isActive, runCount, lastRunAt, createdAt, updatedAt }] }',
+    summary: 'List all automation flows',
+  },
+  {
+    category: CATEGORY_AUTOMATIONS,
+    free: true,
+    method: 'POST',
+    parameters: [
+      { description: 'Flow name', in: 'body', name: 'name', required: true, type: 'string' },
+      { description: 'Trigger type: monitor_event, schedule, search, webhook_inbound', in: 'body', name: 'triggerType', required: true, type: 'string' },
+      { description: 'Trigger-specific configuration', in: 'body', name: 'triggerConfig', required: true, type: 'object' },
+      { description: 'Template slug to scaffold from', in: 'body', name: 'templateSlug', required: false, type: 'string' },
+    ],
+    path: '/api/v1/automations',
+    responseShape: '{ id, name, slug, triggerType, triggerConfig, isActive, createdAt, updatedAt }',
+    summary: 'Create a new automation flow',
+  },
+  {
+    category: CATEGORY_AUTOMATIONS,
+    free: true,
+    method: 'GET',
+    parameters: [PARAM_AUTOMATION_SLUG],
+    path: '/api/v1/automations/:slug',
+    responseShape: '{ id, name, slug, triggerType, triggerConfig, isActive, steps, recentRuns, createdAt, updatedAt }',
+    summary: 'Get flow details with steps and recent runs',
+  },
+  {
+    category: CATEGORY_AUTOMATIONS,
+    free: true,
+    method: 'PATCH',
+    parameters: [
+      PARAM_AUTOMATION_SLUG,
+      { description: 'Current updatedAt for optimistic concurrency', in: 'body', name: 'expectedUpdatedAt', required: true, type: 'string' },
+      { description: 'Updated flow name', in: 'body', name: 'name', required: false, type: 'string' },
+      { description: 'Updated trigger type', in: 'body', name: 'triggerType', required: false, type: 'string' },
+      { description: 'Updated trigger config', in: 'body', name: 'triggerConfig', required: false, type: 'object' },
+      { description: 'Activate or deactivate', in: 'body', name: 'isActive', required: false, type: 'boolean' },
+    ],
+    path: '/api/v1/automations/:slug',
+    responseShape: '{ id, name, slug, triggerType, triggerConfig, isActive, createdAt, updatedAt }',
+    summary: 'Update flow name, trigger, or active status',
+  },
+  {
+    category: CATEGORY_AUTOMATIONS,
+    free: true,
+    method: 'DELETE',
+    parameters: [PARAM_AUTOMATION_SLUG],
+    path: '/api/v1/automations/:slug',
+    responseShape: RESPONSE_SUCCESS,
+    summary: 'Delete a flow and all its steps',
+  },
+  {
+    category: CATEGORY_AUTOMATIONS,
+    free: true,
+    method: 'POST',
+    parameters: [
+      PARAM_AUTOMATION_SLUG,
+      { description: 'Step type: action, condition, extraction', in: 'body', name: 'stepType', required: true, type: 'string' },
+      { description: 'Branch: main, if_true, if_false', in: 'body', name: 'branch', required: true, type: 'string' },
+      { description: 'Step-specific configuration', in: 'body', name: 'config', required: true, type: 'object' },
+      { description: 'Order position in branch', in: 'body', name: 'position', required: false, type: 'number' },
+      { description: 'Parent step ID for condition branches', in: 'body', name: 'parentStepId', required: false, type: 'string' },
+      { description: 'Action type: create_tweet, follow, like, reply_tweet, retweet, send_dm, send_email, send_telegram, unfollow', in: 'body', name: 'actionType', required: false, type: 'string' },
+      { description: 'Extraction tool type', in: 'body', name: 'extractionType', required: false, type: 'string' },
+      { description: 'Variable name for extraction output', in: 'body', name: 'outputName', required: false, type: 'string' },
+    ],
+    path: '/api/v1/automations/:slug/steps',
+    responseShape: '{ id, flowId, stepType, actionType, extractionType, branch, config, position, createdAt }',
+    summary: 'Add an action, condition, or extraction step to a flow',
+  },
+  {
+    category: CATEGORY_AUTOMATIONS,
+    free: true,
+    method: 'PATCH',
+    parameters: [
+      PARAM_AUTOMATION_SLUG,
+      { description: 'Step ID to update', in: 'body', name: 'stepId', required: true, type: 'string' },
+      { description: 'Updated step config', in: 'body', name: 'config', required: false, type: 'object' },
+      { description: 'Updated step type', in: 'body', name: 'stepType', required: false, type: 'string' },
+      { description: 'Updated branch', in: 'body', name: 'branch', required: false, type: 'string' },
+      { description: 'Updated position', in: 'body', name: 'position', required: false, type: 'number' },
+      { description: 'Updated action type', in: 'body', name: 'actionType', required: false, type: 'string' },
+      { description: 'Updated extraction type', in: 'body', name: 'extractionType', required: false, type: 'string' },
+      { description: 'Updated output variable name', in: 'body', name: 'outputName', required: false, type: 'string' },
+    ],
+    path: '/api/v1/automations/:slug/steps',
+    responseShape: '{ id, flowId, stepType, actionType, extractionType, branch, config, position, createdAt }',
+    summary: 'Update a step configuration or position',
+  },
+  {
+    category: CATEGORY_AUTOMATIONS,
+    free: true,
+    method: 'DELETE',
+    parameters: [
+      PARAM_AUTOMATION_SLUG,
+      { description: 'Step ID to delete', in: 'body', name: 'stepId', required: true, type: 'string' },
+    ],
+    path: '/api/v1/automations/:slug/steps',
+    responseShape: RESPONSE_SUCCESS,
+    summary: 'Remove a step from a flow',
+  },
+  {
+    category: CATEGORY_AUTOMATIONS,
+    free: true,
+    method: 'PATCH',
+    parameters: [
+      PARAM_AUTOMATION_SLUG,
+      { description: 'Array of { stepId, positionX, positionY } (max 10)', in: 'body', name: 'positions', required: true, type: 'array' },
+    ],
+    path: '/api/v1/automations/:slug/steps/positions',
+    responseShape: RESPONSE_SUCCESS,
+    summary: 'Batch update canvas positions for flow steps',
+  },
+  {
+    category: CATEGORY_AUTOMATIONS,
+    free: true,
+    method: 'POST',
+    parameters: [PARAM_AUTOMATION_SLUG],
+    path: '/api/v1/automations/:slug/test',
+    responseShape: '{ status, result, runId, error? }',
+    summary: 'Test run a flow with synthetic trigger data',
+  },
+  {
+    category: CATEGORY_AUTOMATIONS,
+    free: true,
+    method: 'POST',
+    parameters: [
+      { description: 'Inbound webhook token', in: 'path', name: 'token', required: true, type: 'string' },
+    ],
+    path: '/api/v1/webhooks/inbound/:token',
+    responseShape: '{ accepted: true, flowId }',
+    summary: 'Trigger a flow via inbound webhook (no auth required, token acts as auth)',
+  },
+
+  // --- Support ---
+  {
+    category: CATEGORY_SUPPORT,
+    free: true,
+    method: 'POST',
+    parameters: [
+      { description: 'Ticket subject (1-500 chars)', in: 'body', name: 'subject', required: true, type: 'string' },
+      { description: 'Initial message (1-10000 chars)', in: 'body', name: 'body', required: true, type: 'string' },
+    ],
+    path: '/api/v1/support/tickets',
+    responseShape: '{ publicId }',
+    summary: 'Open a new support ticket',
+  },
+  {
+    category: CATEGORY_SUPPORT,
+    free: true,
+    method: 'GET',
+    path: '/api/v1/support/tickets',
+    responseShape: '{ tickets: [{ publicId, subject, status, messageCount, createdAt, updatedAt }] }',
+    summary: 'List your support tickets',
+  },
+  {
+    category: CATEGORY_SUPPORT,
+    free: true,
+    method: 'GET',
+    parameters: [PARAM_TICKET_ID],
+    path: '/api/v1/support/tickets/:id',
+    responseShape: '{ publicId, subject, status, messages: [{ body, sender, createdAt }], createdAt, updatedAt }',
+    summary: 'Get a ticket with message history',
+  },
+  {
+    category: CATEGORY_SUPPORT,
+    free: true,
+    method: 'PATCH',
+    parameters: [
+      PARAM_TICKET_ID,
+      { description: 'New status: open, resolved, closed', in: 'body', name: 'status', required: true, type: 'string' },
+    ],
+    path: '/api/v1/support/tickets/:id',
+    responseShape: '{ publicId, status }',
+    summary: 'Update ticket status',
+  },
+  {
+    category: CATEGORY_SUPPORT,
+    free: true,
+    method: 'POST',
+    parameters: [
+      PARAM_TICKET_ID,
+      { description: 'Message content (1-10000 chars)', in: 'body', name: 'body', required: true, type: 'string' },
+    ],
+    path: '/api/v1/support/tickets/:id/messages',
+    responseShape: '{ publicId }',
+    summary: 'Reply to a support ticket',
+  },
 ] as const;
 
 export { API_SPEC };

package/src/index.ts

@@ -1,5 +1,6 @@
 import { handleXStatus } from './commands/xstatus.js';
 import { handleXTrends } from './commands/xtrends.js';
+import { initMpp } from './mpp.js';
 import { createProxiedRequest } from './request.js';
 import { createEventPoller } from './services/event-poller.js';
 import { handleExplore, SEARCH_DESCRIPTION } from './tools/explore.js';
@@ -16,7 +17,8 @@ function isPollerEvent(value: unknown): value is PollerEvent {
 }
 
 function isPluginConfig(value: unknown): value is PluginConfig {
-  return typeof value === 'object' && value !== null && 'apiKey' in value;
+  if (typeof value !== 'object' || value === null) return false;
+  return 'apiKey' in value || 'tempoPrivateKey' in value;
 }
 
 const DEFAULT_POLLING_INTERVAL_SECONDS = 60;
@@ -74,13 +76,28 @@ export default function register(api: OpenClawApi, fetchFunction?: FetchFunction
   const config: unknown = api.pluginConfig;
   if (!isPluginConfig(config)) {
     api.logger.warn(
-      "TweetClaw: No API key configured. Run: openclaw config set plugins.entries.tweetclaw.config.apiKey 'xq_YOUR_KEY'",
+      "TweetClaw: No API key or Tempo wallet configured. Run: openclaw config set plugins.entries.tweetclaw.config.apiKey 'xq_YOUR_KEY' or set tempoPrivateKey for MPP pay-per-use",
     );
     return;
   }
 
-  const { apiKey, baseUrl = 'https://xquik.com' } = config;
-  const request = createProxiedRequest(baseUrl, apiKey, fetchFunction);
+  const { apiKey, baseUrl = 'https://xquik.com', tempoPrivateKey } = config;
+  const isMppMode = apiKey === undefined && tempoPrivateKey !== undefined;
+  const credential = apiKey ?? '';
+
+  if (isMppMode) {
+    void (async (): Promise<void> => {
+      try {
+        await initMpp(tempoPrivateKey);
+        api.logger.info('TweetClaw: MPP initialized - Tempo wallet ready');
+      } catch (error: unknown) {
+        api.logger.error(`TweetClaw: MPP init failed - ${error instanceof Error ? error.message : String(error)}`);
+      }
+    })();
+    api.logger.info('TweetClaw: MPP mode - pay-per-use via Tempo (7 X-API endpoints, no subscription needed)');
+  }
+
+  const request = createProxiedRequest(baseUrl, credential, fetchFunction);
 
   // --- Tools (2-tool approach, execute inside tool object) ---
   api.registerTool(
@@ -96,7 +113,7 @@ export default function register(api: OpenClawApi, fetchFunction?: FetchFunction
   api.registerTool(
     {
       description: EXECUTE_DESCRIPTION,
-      execute: async (_toolCallId, { code }) => handleTweetclaw({ apiKey, baseUrl, code, fetchFunction }),
+      execute: async (_toolCallId, { code }) => handleTweetclaw({ apiKey: credential, baseUrl, code, fetchFunction }),
       name: 'tweetclaw',
       parameters: CODE_PARAMETER,
     },
@@ -104,14 +121,16 @@ export default function register(api: OpenClawApi, fetchFunction?: FetchFunction
   );
 
   // --- Commands (instant, no LLM) ---
-  api.registerCommand({
-    description: 'Show Xquik account status & usage',
-    handler: async () => {
-      const text = await handleXStatus(request);
-      return { text };
-    },
-    name: 'xstatus',
-  });
+  if (!isMppMode) {
+    api.registerCommand({
+      description: 'Show Xquik account status & usage',
+      handler: async () => {
+        const text = await handleXStatus(request);
+        return { text };
+      },
+      name: 'xstatus',
+    });
+  }
 
   api.registerCommand({
     acceptsArgs: true,
@@ -123,9 +142,9 @@ export default function register(api: OpenClawApi, fetchFunction?: FetchFunction
     name: 'xtrends',
   });
 
-  // --- Background event poller ---
+  // --- Background event poller (requires API key, not available in MPP mode) ---
   const { pollingEnabled, pollingInterval } = config;
-  if (pollingEnabled !== false) {
+  if (!isMppMode && pollingEnabled !== false) {
     const poller = createEventPoller({
       intervalSeconds: pollingInterval ?? DEFAULT_POLLING_INTERVAL_SECONDS,
       onEvents: (events) => {

package/src/mpp.ts

@@ -0,0 +1,44 @@
+import { resolveAsyncFunctionConstructor } from './tools/sandbox.js';
+
+type ModuleLoader = (name: string) => Promise<Record<string, unknown>>;
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === 'object' && value !== null;
+}
+
+function isCallable(value: unknown): value is (...args: readonly unknown[]) => unknown {
+  return typeof value === 'function';
+}
+
+function createModuleLoader(): ModuleLoader {
+  const loader = resolveAsyncFunctionConstructor();
+  const dynamicImport = new loader('n', 'return import(n)');
+  return async (name: string): Promise<Record<string, unknown>> => {
+    const mod: unknown = await dynamicImport(name);
+    if (!isRecord(mod)) {
+      throw new Error(`Failed to load ${name}`);
+    }
+    return mod;
+  };
+}
+
+async function initMpp(tempoPrivateKey: string, loadModule?: ModuleLoader): Promise<void> {
+  const load = loadModule ?? createModuleLoader();
+  const mppxMod = await load('mppx/client').catch((): never => {
+    throw new Error('MPP requires mppx package. Run: npm i mppx viem');
+  });
+  const viemMod = await load('viem/accounts').catch((): never => {
+    throw new Error('MPP requires viem package. Run: npm i mppx viem');
+  });
+  if (!isCallable(viemMod.privateKeyToAccount)) throw new Error('viem missing privateKeyToAccount');
+  if (!isCallable(mppxMod.tempo)) throw new Error('mppx missing tempo');
+  if (!isRecord(mppxMod.Mppx)) throw new Error('mppx missing Mppx');
+  const createMethod: unknown = mppxMod.Mppx.create;
+  if (!isCallable(createMethod)) throw new Error('mppx Mppx.create is not a function');
+  const account: unknown = viemMod.privateKeyToAccount(tempoPrivateKey);
+  const method: unknown = mppxMod.tempo({ account });
+  createMethod({ methods: [method] });
+}
+
+export { createModuleLoader, initMpp, isCallable, isRecord };
+export type { ModuleLoader };

package/src/request.ts

@@ -16,7 +16,7 @@ function buildAuthHeader(credential: string): Record<string, string> {
 }
 
 function buildFetchHeaders(credential: string, hasBody: boolean): Record<string, string> {
-  const auth = buildAuthHeader(credential);
+  const auth = credential === '' ? {} : buildAuthHeader(credential);
   if (hasBody) {
     return { ...auth, [CONTENT_TYPE_HEADER]: 'application/json' };
   }

package/src/tools/tweetclaw.ts

@@ -296,10 +296,12 @@ async () => {
 \`\`\`
 
 ## Cost
-- Free: /api/v1/compose, /api/v1/styles (cached lookup/save/delete/compare), /api/v1/drafts, /api/v1/radar, /api/v1/subscribe, /api/v1/account, /api/v1/api-keys, /api/v1/bot/*, /api/v1/integrations/*, /api/v1/x/accounts
-- Subscription required: /api/v1/styles (X API refresh when cache >7 days), /api/v1/x/tweets, /api/v1/x/users, /api/v1/x/followers, /api/v1/x/media, /api/v1/x/profile, /api/v1/x/communities, /api/v1/x/dm, /api/v1/extractions, /api/v1/draws, /api/v1/monitors, /api/v1/events, /api/v1/webhooks, /api/v1/styles/:username/performance, /api/v1/trends, /api/v1/trending/:source
+- Free: /api/v1/compose, /api/v1/styles (cached lookup/save/delete/compare), /api/v1/drafts, /api/v1/radar, /api/v1/subscribe, /api/v1/account, /api/v1/api-keys, /api/v1/bot/*, /api/v1/integrations/*, /api/v1/x/accounts, /api/v1/automations/*, /api/v1/support/*
+- MPP pay-per-use (no account/subscription needed, 7 endpoints): GET /api/v1/x/tweets/:id ($0.0003/call), GET /api/v1/x/tweets/search ($0.0003/tweet), GET /api/v1/x/users/:username ($0.00036/call), GET /api/v1/x/followers/check ($0.002/call), GET /api/v1/x/articles/:tweetId ($0.002/call), POST /api/v1/x/media/download ($0.0003/media), GET /api/v1/trends ($0.0009/call)
+- Subscription required: /api/v1/styles (X API refresh when cache >7 days), /api/v1/x/profile, /api/v1/x/communities, /api/v1/x/dm, /api/v1/extractions, /api/v1/draws, /api/v1/monitors, /api/v1/events, /api/v1/webhooks, /api/v1/styles/:username/performance, /api/v1/trending/:source
 - Write actions (subscription required): POST /api/v1/x/tweets, DELETE /api/v1/x/tweets/:id, POST|DELETE /api/v1/x/tweets/:id/like, POST /api/v1/x/tweets/:id/retweet, POST|DELETE /api/v1/x/users/:id/follow, POST /api/v1/x/dm/:userId, POST /api/v1/x/media, PATCH /api/v1/x/profile, PATCH /api/v1/x/profile/avatar, PATCH /api/v1/x/profile/banner, POST|DELETE /api/v1/x/communities, POST|DELETE /api/v1/x/communities/:id/join
 - IMPORTANT: Always attempt the request. Never assume subscription status. The API returns a clear error if subscription is missing.
+- MPP MODE: When configured with tempoPrivateKey (no API key), the mppx SDK auto-handles 402 challenges by paying via Tempo (USDC). Only the 7 MPP-eligible endpoints work in this mode.
 
 ## Error handling
 - If response contains "subscription is inactive" or status 402, call POST /api/v1/subscribe to get checkout URL

package/src/types.ts

@@ -10,6 +10,7 @@ interface EndpointInfo {
   readonly category: string;
   readonly free: boolean;
   readonly method: string;
+  readonly mpp?: { readonly intent: string; readonly price: string };
   readonly parameters?: readonly EndpointParameter[];
   readonly path: string;
   readonly responseShape?: string;
@@ -32,10 +33,11 @@ interface ToolResult {
 }
 
 interface PluginConfig {
-  readonly apiKey: string;
+  readonly apiKey?: string;
   readonly baseUrl?: string;
   readonly pollingEnabled?: boolean;
   readonly pollingInterval?: number;
+  readonly tempoPrivateKey?: string;
 }
 
 interface EventPollerOptions {