Openclaw Skills-ready Twitter/X intelligence for autonomous agents that search, read, and act on social data through one API key.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install twitter
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install twitter using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is AIsa Twitter?
AIsa Twitter is an Openclaw Skills integration that gives autonomous agents structured access to Twitter/X profiles, timelines, mentions, followers, trending topics, lists, communities, Spaces, and advanced tweet search through a single API key. It is built for Openclaw Skills workflows that need reliable social intelligence without exposing account passwords.
Use it when you need to monitor influencers, run social listening queries, research competitors, or fetch conversation context around a tweet. Read operations work without login, while posting and engagement are handled through dedicated reference workflows that require browser-based OAuth authorization.
AIsa Twitter Use Cases
- Monitor influencers and get alerts when specific accounts post about a topic.
- Run social listening and sentiment workflows against live tweet search results.
- Track competitor announcements, launches, and account activity for market intelligence.
- Pull profiles, followers, followings, verified followers, and relationship checks for research.
- Inspect replies, quotes, retweeters, and thread context to reconstruct conversations.
- Analyze Twitter/X trends, lists, communities, and Spaces for audience or niche discovery.
- Route publishing, replying, liking, unliking, following, and unfollowing through OAuth-backed action workflows when the task moves from research to engagement.
How AIsa Twitter Works
- Set your
AISA_API_KEYand, if needed, configure the Twitter relay for OAuth-backed actions. - Choose the correct workflow: read-only intelligence, search and research, or engagement/posting via the referenced action docs.
- Call the appropriate REST endpoint directly with
curlor use the provided Python CLI wrappers for faster agent orchestration. - Provide the required identifiers and filters, such as
userName,user_id,tweetId,tweet_ids,list_id,community_id,space_id,query,queryType, orwoeid. - For large result sets, follow cursor-based pagination and collect the returned JSON payloads.
- Review
usage.costandusage.credits_remainingin each response to keep Openclaw Skills automations cost-aware. - When the task requires posting or engagement, complete OAuth in the browser and use the
post_twitter.mdorengage_twitter.mdworkflow.
AIsa Twitter Setup
- Ensure
python3andcurlare available in your environment. - Sign up for an AIsa account, add credits, and copy your API key.
- Export the required environment variable:
export AISA_API_KEY="your-key"
- Optional: configure the relay used for OAuth, posting, and engagement workflows:
export TWITTER_RELAY_BASE_URL="https://api.aisa.one/apis/v1/twitter"
export TWITTER_RELAY_TIMEOUT="30"
- Verify the setup with a read endpoint:
curl "https://api.aisa.one/apis/v1/twitter/trends?woeid=1" \
-H "Authorization: Bearer $AISA_API_KEY"
- Use the Python client for common Openclaw Skills tasks:
python3 scripts/twitter_client.py search --query "AI agents"
python3 scripts/twitter_client.py user-info --username elonmusk
- For publishing or engagement, complete OAuth in the browser through the referenced workflows before running the engagement client.
AIsa Twitter Data Schema & Taxonomy
AIsa Twitter is organized around API resources and CLI entry points rather than locally generated files.
| Data Domain | Primary Identifiers | Typical Endpoints | Notes |
|---|---|---|---|
| Authentication | AISA_API_KEY, TWITTER_RELAY_BASE_URL, TWITTER_RELAY_TIMEOUT |
All requests | AISA_API_KEY is required; relay vars are optional and control OAuth-backed actions. |
| User Data | userName, user_id, cursor |
/user/info, /user_about, /user/last_tweets, /user/mentions, /user/followers, /user/followings, /user/verifiedFollowers, /user/search |
Supports profile lookup, relationship checks, and follower/following discovery. |
| Tweet Data | tweetId, tweet_ids, cursor, query, queryType |
/tweet/advanced_search, /tweets, /tweet/replies, /tweet/quotes, /tweet/retweeters, /tweet/thread_context, /article |
queryType must be Latest or Top for advanced search. |
| Trend/Discovery Data | woeid, query |
/trends, /community/get_tweets_from_all_community |
woeid=1 returns worldwide trends. |
| Lists & Communities | list_id, community_id, cursor |
/list/members, /list/followers, /community/info, /community/members, /community/moderators, /community/tweets |
Useful for audience mapping and niche research. |
| Spaces | space_id |
/spaces/detail |
Returns Space metadata for live audio discovery. |
| Usage Metadata | usage.cost, usage.credits_remaining |
All responses | Built-in billing telemetry for cost-aware automation. |
Files and runtime entry points
scripts/twitter_client.pyfor read-only research and discovery operations.scripts/twitter_engagement_client.pyfor OAuth-backed engagement tasks through the configured relay.- No local database or export files are generated by default; responses are returned as JSON over HTTP/CLI.
Metadata taxonomy
primaryEnv:AISA_API_KEYrequires.bins:python3optionalEnv:TWITTER_RELAY_BASE_URL,TWITTER_RELAY_TIMEOUTcompatibility:openclaw,claude-code,hermesuser-invocable:true
AIsa Twitter Advanced Features
- Advanced tweet search with
LatestandTopmodes for real-time discovery and ranking. - Cursor-based pagination across users, tweets, communities, lists, and mentions for scalable agent loops.
- Batch user lookup by ID for faster multi-account research.
- Conversation reconstruction via replies, quotes, retweeters, and full thread context.
- Audience intelligence with verified followers, relationship checks, list members, and list followers.
- Community and Space exploration for niche monitoring beyond standard timelines.
- OAuth-based posting and engagement through the relay without sharing account passwords.
- Built-in cost telemetry so Openclaw Skills agents can throttle or stop when credits are low.
- Compatible with Openclaw Skills, Claude Code, and Hermes workflows.
- Separate read and action paths make it easy to enforce safe automation boundaries.
SKILL.md
Loading
Related Openclaw Skills
Amazon Best Sellers Listing Scraper
Openclaw Skills turns Amazon Best Sellers pages into structured rankings, product metadata, and pagination-ready datasets for analysis.
Amazon Product Detail Scraper
Extract any open Amazon product page into a normalized 100+ field JSON record with Openclaw Skills.
Amazon Search & Category Listing Scraper
An automated utility for extracting structured product data and pagination status from Amazon search results and category browse pages.
Taobao Product Reviews
A browser automation skill designed to extract customer reviews, buyer options, and photo attachments from Taobao and Tmall product pages.
KOL Creator Discovery
Openclaw Skills turns one creator profile into a verified, outreach-ready KOL prospect list with similarity ranking, email enrichment, and evidence-backed metadata.
OSINT Personal Profiler
A legal OSINT profiling skill that turns minimal public identifiers into a confidence-scored, 12-dimensional person profile.
Featured*
