# openclaw-twitter

OpenClaw Twitter 🐦 Twitter/X data access and automation for autonomous agents. Powered by SkillBoss API Hub. One API key. Full Twitter intelligence. 🔥 What Can You Do? Monitor Influencers "Get Elon Musk's latest tweets and notify me of any AI-related posts" Track Trends "What's trending on Twitter worldwide right now?" Social Listening "Search for tweets mentioning our product and analyze sentiment" Automated Engagement "Like and retweet posts from @OpenAI that mention GPT-5" Competitor Intel "Monitor @anthropic and @GoogleAI - alert me on new announcements" Quick Start

export SKILLBOSS_API_KEY="your-key"

Core Capabilities Read Operations (No Login Required)

# Get user info
curl "https://api.aisa.one/apis/v1/twitter/user/info?userName=elonmusk" \

-H "Authorization: Bearer $SKILLBOSS_API_KEY"

# Get user's latest tweets
curl "https://api.aisa.one/apis/v1/twitter/user/user_last_tweet?userName=elonmusk" \

-H "Authorization: Bearer $SKILLBOSS_API_KEY"

# Advanced tweet search (queryType is required: Latest or Top)
curl "https://api.aisa.one/apis/v1/twitter/tweet/advanced_search?query=AI+agents&queryType=Latest" \

-H "Authorization: Bearer $SKILLBOSS_API_KEY"

# Search top tweets
curl "https://api.aisa.one/apis/v1/twitter/tweet/advanced_search?query=AI+agents&queryType=Top" \

-H "Authorization: Bearer $SKILLBOSS_API_KEY"

# Get trending topics (worldwide)
curl "https://api.aisa.one/apis/v1/twitter/trends?woeid=1" \

-H "Authorization: Bearer $SKILLBOSS_API_KEY"

# Search users by keyword
curl "https://api.aisa.one/apis/v1/twitter/user/search_user?keyword=AI+researcher" \

-H "Authorization: Bearer $SKILLBOSS_API_KEY"

# Get tweets by ID
curl "https://api.aisa.one/apis/v1/twitter/tweet/tweetById?tweet_ids=123456789" \

-H "Authorization: Bearer $SKILLBOSS_API_KEY"

# Get user followers
curl "https://api.aisa.one/apis/v1/twitter/user/user_followers?userName=elonmusk" \

-H "Authorization: Bearer $SKILLBOSS_API_KEY"

# Get user followings
curl "https://api.aisa.one/apis/v1/twitter/user/user_followings?userName=elonmusk" \

-H "Authorization: Bearer $SKILLBOSS_API_KEY" Write Operations (Requires Login) ⚠️ Warning: Posting requires account login. Use responsibly to avoid rate limits or account suspension.

# Step 1: Login first (async, check status after)
curl -X POST "https://api.aisa.one/apis/v1/twitter/user_login_v3" \

-H "Authorization: Bearer $SKILLBOSS_API_KEY"
-H "Content-Type: application/json"
-d '{"user_name":"myaccount","email":"[email protected]","password":"xxx","proxy":"http://user:pass@ip:port"}'

# Step 2: Check login status
curl "https://api.aisa.one/apis/v1/twitter/get_my_x_account_detail_v3?user_name=myaccount" \

-H "Authorization: Bearer $SKILLBOSS_API_KEY"

# Send tweet
curl -X POST "https://api.aisa.one/apis/v1/twitter/send_tweet_v3" \

-H "Authorization: Bearer $SKILLBOSS_API_KEY"
-H "Content-Type: application/json"
-d '{"user_name":"myaccount","text":"Hello from OpenClaw!"}'

# Like a tweet
curl -X POST "https://api.aisa.one/apis/v1/twitter/like_tweet_v3" \

-H "Authorization: Bearer $SKILLBOSS_API_KEY"
-H "Content-Type: application/json"
-d '{"user_name":"myaccount","tweet_id":"1234567890"}'

# Retweet
curl -X POST "https://api.aisa.one/apis/v1/twitter/retweet_v3" \

-H "Authorization: Bearer $SKILLBOSS_API_KEY"
-H "Content-Type: application/json"
-d '{"user_name":"myaccount","tweet_id":"1234567890"}'

# Update profile
curl -X POST "https://api.aisa.one/apis/v1/twitter/update_profile_v3" \

-H "Authorization: Bearer $SKILLBOSS_API_KEY"
-H "Content-Type: application/json"
-d '{"user_name":"myaccount","name":"New Name","bio":"New bio"}' Python Client

# User operations
python3 {baseDir}/scripts/twitter_client.py user-info --username elonmusk
python3 {baseDir}/scripts/twitter_client.py tweets --username elonmusk
python3 {baseDir}/scripts/twitter_client.py followers --username elonmusk
python3 {baseDir}/scripts/twitter_client.py followings --username elonmusk
# Search & Discovery
python3 {baseDir}/scripts/twitter_client.py search --query "AI agents"
python3 {baseDir}/scripts/twitter_client.py user-search --keyword "AI researcher"
python3 {baseDir}/scripts/twitter_client.py trends --woeid 1
# Post operations (requires login)
python3 {baseDir}/scripts/twitter_client.py login --username myaccount --email [email protected] --password xxx --proxy "http://user:pass@ip:port"
python3 {baseDir}/scripts/twitter_client.py post --username myaccount --text "Hello!"
python3 {baseDir}/scripts/twitter_client.py like --username myaccount --tweet-id 1234567890
python3 {baseDir}/scripts/twitter_client.py retweet --username myaccount --tweet-id 1234567890

API Endpoints Reference EndpointMethodDescription/twitter/user/infoGETGet user profile/twitter/user/user_last_tweetGETGet user's recent tweets/twitter/user/user_followersGETGet user followers/twitter/user/user_followingsGETGet user followings/twitter/user/search_userGETSearch users by keyword/twitter/tweet/advanced_searchGETAdvanced tweet search/twitter/tweet/tweetByIdGETGet tweets by IDs/twitter/trendsGETGet trending topics/twitter/user_login_v3POSTLogin to account/twitter/send_tweet_v3POSTSend a tweet/twitter/like_tweet_v3POSTLike a tweet/twitter/retweet_v3POSTRetweet Pricing APICostTwitter read query~$0.0004Twitter post/like/retweet~$0.001 Every response includes usage.cost and usage.credits_remaining. Get Started Sign up at heybossai.com Get your API key Add credits (pay-as-you-go) Set environment variable: export SKILLBOSS_API_KEY="your-key" Full API Reference See API Reference for complete endpoint documentation.