Loading...
Loading...
X/Twitter messaging management via API. Read tweets, post tweets, reply, send DMs, search, and view analytics. Use when the user wants to interact with X/Twitter: (1) posting or scheduling tweets, (2) reading timeline/mentions/DMs, (3) replying to tweets, (4) searching tweets/users/hashtags, (5) checking engagement analytics. Requires Twitter API credentials (API key, API secret, access token, access secret) or Bearer token.
npx skill4agent add ljt-520/openclaw-backup twitter~/.config/twitter/credentials.jsonexport 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 operationsmkdir -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.jsonpip install tweepy| Task | Command |
|---|---|
| Post tweet | |
| Post with image | |
| Reply | |
| Thread | |
| Get timeline | |
| Get mentions | |
| Get DMs | |
| Send DM | |
| Search | |
| User info | |
| Tweet info | |
| Analytics | |
--help{baseDir}/scripts/tweet.py --help
{baseDir}/scripts/tweet.py post --help{baseDir}/scripts/tweet.py post "Hello, world!"{baseDir}/scripts/tweet.py post "Check this out!" --media photo.png
{baseDir}/scripts/tweet.py post "Multiple images" --media img1.png --media img2.png{baseDir}/scripts/tweet.py reply 1234567890 "Great point!"{baseDir}/scripts/tweet.py thread \
"First tweet in thread" \
"Second tweet" \
"Third tweet"{baseDir}/scripts/tweet.py mentions --count 50{baseDir}/scripts/tweet.py search "openclaw agent" --count 20
{baseDir}/scripts/tweet.py search "#AI lang:en" --count 20{baseDir}/scripts/tweet.py user elonmusk{baseDir}/scripts/tweet.py dm username "Hello from OpenClaw!"{baseDir}/scripts/tweet.py analytics 1234567890| Tier | Cost | Read | Write | Search |
|---|---|---|---|---|
| Free | $0 | Limited | - | - |
| Basic | $100/mo | 10k/mo | 1.5k/mo | 50/mo |
| Pro | $5000/mo | 1M/mo | 300k/mo | 500/mo |
{baseDir}/references/api-limits.md| Error | Cause | Solution |
|---|---|---|
| 403 Forbidden | Insufficient tier | Upgrade API tier or check endpoint access |
| 429 Too Many Requests | Rate limit hit | Wait and retry; check rate limit headers |
| 401 Unauthorized | Invalid credentials | Verify API keys and tokens |
| 404 Not Found | Tweet/user deleted | Handle gracefully, inform user |
| 422 Unprocessable | Duplicate tweet | Wait before posting same content |
{baseDir}/references/search-operators.md{baseDir}/scripts/tweet.py{baseDir}/references/api-limits.md{baseDir}/references/search-operators.md