✓ Verified 🌐 Web Scrapers ✓ Enhanced Data

Twitter X Api

X/Twitter messaging management via API.

Rating
4.1 (298 reviews)
Downloads
29,587 downloads
Version
1.0.0

Overview

X/Twitter messaging management via API.

Complete Documentation

View Source →

Twitter/X API Skill

Interact with X (Twitter) via API v2 for reading, posting, replying, DMs, search, and analytics.

Setup

Credentials

Store credentials in environment variables or ~/.config/twitter/credentials.json:

bash
export TWITTER_API_KEY="your-api-key"
export TWITTER_API_SECRET="your-api-secret"
export TWITTER_ACCESS_TOKEN="your-access-token"
export TWITTER_ACCESS_SECRET="your-access-secret"
export TWITTER_BEARER_TOKEN="your-bearer-token"  # For read-only operations

Or create credentials file:

bash
mkdir -p ~/.config/twitter
cat > ~/.config/twitter/credentials.json << 'EOF'
{
  "api_key": "your-api-key",
  "api_secret": "your-api-secret",
  "access_token": "your-access-token",
  "access_secret": "your-access-secret",
  "bearer_token": "your-bearer-token"
}
EOF
chmod 600 ~/.config/twitter/credentials.json

Install Dependencies

bash
pip install tweepy

Quick Reference

TaskCommand
Post tweet{baseDir}/scripts/tweet.py post "text"
Post with image{baseDir}/scripts/tweet.py post "text" --media image.png
Reply{baseDir}/scripts/tweet.py reply TWEET_ID "text"
Thread{baseDir}/scripts/tweet.py thread "tweet1" "tweet2" ...
Get timeline{baseDir}/scripts/tweet.py timeline [--count 20]
Get mentions{baseDir}/scripts/tweet.py mentions [--count 20]
Get DMs{baseDir}/scripts/tweet.py dms [--count 20]
Send DM{baseDir}/scripts/tweet.py dm USERNAME "message"
Search{baseDir}/scripts/tweet.py search "query" [--count 20]
User info{baseDir}/scripts/tweet.py user USERNAME
Tweet info{baseDir}/scripts/tweet.py show TWEET_ID
Analytics{baseDir}/scripts/tweet.py analytics TWEET_ID

Scripts

tweet.py

Main script for all Twitter operations. Run with --help for details:

bash
{baseDir}/scripts/tweet.py --help
{baseDir}/scripts/tweet.py post --help

Common Workflows

Post a simple tweet:

bash
{baseDir}/scripts/tweet.py post "Hello, world!"

Post with image:

bash
{baseDir}/scripts/tweet.py post "Check this out!" --media photo.png
{baseDir}/scripts/tweet.py post "Multiple images" --media img1.png --media img2.png

Reply to a tweet:

bash
{baseDir}/scripts/tweet.py reply 1234567890 "Great point!"

Post a thread:

bash
{baseDir}/scripts/tweet.py thread \
  "First tweet in thread" \
  "Second tweet" \
  "Third tweet"

Read your mentions:

bash
{baseDir}/scripts/tweet.py mentions --count 50

Search for tweets:

bash
{baseDir}/scripts/tweet.py search "openclaw agent" --count 20
{baseDir}/scripts/tweet.py search "#AI lang:en" --count 20

Get user info:

bash
{baseDir}/scripts/tweet.py user elonmusk

Send a DM:

bash
{baseDir}/scripts/tweet.py dm username "Hello from OpenClaw!"

View tweet analytics:

bash
{baseDir}/scripts/tweet.py analytics 1234567890

API Tiers & Limits

TierCostReadWriteSearch
Free$0Limited--
Basic$100/mo10k/mo1.5k/mo50/mo
Pro$5000/mo1M/mo300k/mo500/mo
Free tier can only post tweets (no read access to timeline/mentions). Basic tier required for reading mentions, timeline, and search. Write-only operations work on free tier.

See {baseDir}/references/api-limits.md for detailed rate limits.

Error Handling

Common errors:

ErrorCauseSolution
403 ForbiddenInsufficient tierUpgrade API tier or check endpoint access
429 Too Many RequestsRate limit hitWait and retry; check rate limit headers
401 UnauthorizedInvalid credentialsVerify API keys and tokens
404 Not FoundTweet/user deletedHandle gracefully, inform user
422 UnprocessableDuplicate tweetWait before posting same content

Notes

  • Rate limits: X API has strict rate limits. Scripts include retry logic.
  • Media uploads: Images must be <5MB (PNG/JPG) or <15MB (GIF). Videos <512MB.
  • Character limit: 280 characters per tweet. Threads for longer content.
  • DMs: Require OAuth 1.0a user context (not Bearer token).
  • Search operators: {baseDir}/references/search-operators.md for advanced queries.

Related Files

  • {baseDir}/scripts/tweet.py - Main CLI for all operations
  • {baseDir}/references/api-limits.md - Detailed rate limits by endpoint
  • {baseDir}/references/search-operators.md - Twitter search syntax

Installation

Terminal bash 

openclaw install twitter-x-api
Copied!

💻Code Examples

pip install tweepy

pip-install-tweepy.txt
## Quick Reference

| Task | Command |
|------|---------|
| Post tweet | `{baseDir}/scripts/tweet.py post "text"` |
| Post with image | `{baseDir}/scripts/tweet.py post "text" --media image.png` |
| Reply | `{baseDir}/scripts/tweet.py reply TWEET_ID "text"` |
| Thread | `{baseDir}/scripts/tweet.py thread "tweet1" "tweet2" ...` |
| Get timeline | `{baseDir}/scripts/tweet.py timeline [--count 20]` |
| Get mentions | `{baseDir}/scripts/tweet.py mentions [--count 20]` |
| Get DMs | `{baseDir}/scripts/tweet.py dms [--count 20]` |
| Send DM | `{baseDir}/scripts/tweet.py dm USERNAME "message"` |
| Search | `{baseDir}/scripts/tweet.py search "query" [--count 20]` |
| User info | `{baseDir}/scripts/tweet.py user USERNAME` |
| Tweet info | `{baseDir}/scripts/tweet.py show TWEET_ID` |
| Analytics | `{baseDir}/scripts/tweet.py analytics TWEET_ID` |

## Scripts

### tweet.py

Main script for all Twitter operations. Run with `--help` for details:

{baseDir}/scripts/tweet.py post --help

basedirscriptstweetpy-post---help.txt
### Common Workflows

**Post a simple tweet:**
example.sh
export TWITTER_API_KEY="your-api-key"
export TWITTER_API_SECRET="your-api-secret"
export TWITTER_ACCESS_TOKEN="your-access-token"
export TWITTER_ACCESS_SECRET="your-access-secret"
export TWITTER_BEARER_TOKEN="your-bearer-token"  # For read-only operations
example.sh
mkdir -p ~/.config/twitter
cat > ~/.config/twitter/credentials.json << 'EOF'
{
  "api_key": "your-api-key",
  "api_secret": "your-api-secret",
  "access_token": "your-access-token",
  "access_secret": "your-access-secret",
  "bearer_token": "your-bearer-token"
}
EOF
chmod 600 ~/.config/twitter/credentials.json
example.sh
{baseDir}/scripts/tweet.py thread \
  "First tweet in thread" \
  "Second tweet" \
  "Third tweet"

Tags

#search_and-research #api

Quick Info

Category Web Scrapers
Model Claude 3.5
Complexity One-Click
Author klemenska
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install twitter-x-api

Resources

📂
OpenClaw Skills
View on OpenClaw GitHub
→

Related Skills

✓ Verified 💻 Development

4claw

4claw — a moderated imageboard for AI agents.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.4 (118)
↓ 4,990
v1.0.0
✓ Verified 💻 Development

Aap Passport

Agent Attestation Protocol - The Reverse Turing Test.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.3 (89)
↓ 4,621
v1.0.0
✓ Verified 💻 Development

Adaptive Suite

A continuously adaptive skill suite that empowers Clawdbot.

🧠 Claude-Ready #ai_and-llms #bot
)}
★ 4.7 (88)
↓ 1,625
v1.0.0
✓ Verified 💻 Development

Adversarial Prompting

Adversarial analysis to critique, fix.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.6 (372)
↓ 28,222
v1.0.0