✓ Verified 📡 Monitoring ✓ Enhanced Data

X Oauth Api

Post to X (Twitter) using the official OAuth 1.0a API.

Rating
4.5 (330 reviews)
Downloads
3,379 downloads
Version
1.0.0

Overview

Post to X (Twitter) using the official OAuth 1.0a API.

Complete Documentation

View Source →

X OAuth API Skill

Post to X (formerly Twitter) using the official X API with OAuth 1.0a authentication.

Overview

This skill provides direct access to X API v2 for posting tweets, managing threads, and monitoring mentions. No proxy or third-party service required — uses your X API credentials directly.

Use when:

  • User says "post to X", "tweet this", "post on Twitter"
  • Need to create threads or media posts
  • Want to check mentions or engage with replies

Quick Start

1. Configure X API Credentials

Store these environment variables (from your X Developer Account):

text
X_API_KEY              # Consumer Key (API Key)
X_API_SECRET           # Consumer Secret
X_ACCESS_TOKEN         # Access Token
X_ACCESS_TOKEN_SECRET  # Access Token Secret
X_USER_ID              # Optional: Your numeric user ID (speeds up mentions)

Free Tier vs Paid Tier

Free tier supports:

  • ✅ Posting tweets and threads
  • ✅ Deleting tweets
  • ✅ Account info lookup (x me)
Requires Basic+ tier:
  • 🔒 Search tweets
  • 🔒 Fetch mentions
  • 🔒 Media uploads

2. Basic Usage

bash
# Post a simple tweet
x post "Hello from X API"

# Post a thread
x thread "First tweet" "Second tweet" "Third tweet"

# Check mentions
x mentions --limit 10

# Search recent tweets
x search "AI agents" --limit 5

Commands

x post

Post a single tweet.

Options:

  • --reply-to - Reply to a specific tweet
  • --quote - Quote tweet
  • --media - Attach image/video
Example:
bash
x post "Check this out" --media image.jpg

x thread ...

Post a tweet thread.

Example:

bash
x thread \
  "Thread about AI" \
  "Here's what I learned" \
  "Most important takeaway"

x mentions [options]

Get recent mentions of your account.

Options:

  • --limit - Number of mentions (default: 10, max: 100)
  • --since - Only mentions after this ID
  • --format json - Output as JSON
Note: Requires X_USER_ID env var OR will fetch it automatically (slower).

x search [options]

Search recent tweets.

Options:

  • --limit - Number of results (default: 10, max: 100)
  • --format json - Output as JSON

x delete

Delete a tweet.

x me

Show current account info (name, username, follower counts, user ID).

API Rate Limits

X API v2 has rate limits per endpoint:

EndpointLimitWindow
POST /2/tweets20015 min (Free tier)
GET /2/tweets/search/recent10015 min (Free tier)
GET /2/users/:id/mentions10015 min (Free tier)
Rate limits vary by access tier. See X API documentation for details.

Authentication

OAuth 1.0a is handled transparently. Just provide your credentials via environment variables. The skill will sign all requests automatically.

Examples

Post with media

bash
x post "Check out this screenshot" --media screenshot.png

Reply to a tweet

bash
x post "Great point!" --reply-to 1234567890123456789

Create a 3-tweet thread

bash
x thread \
  "Just launched x-oauth-api skill" \
  "It lets you post to X directly from your agent" \
  "No proxies, direct OAuth 1.0a authentication"

Search and reply

bash
# Find interesting tweets
x search "agent framework"

# Reply to one
x post "Have you tried this?" --reply-to 1234567890123456789

Troubleshooting

"Unauthorized" error

  • Check X API credentials are correct
  • Verify credentials are set in environment
  • Ensure your app has write permissions in X Developer Portal
"Rate limit exceeded"
  • Wait 15 minutes for limit to reset
  • Reduce request frequency
  • Check your tier limits at https://developer.twitter.com/en/portal/dashboard
"This endpoint requires a paid X API tier"
  • Search and mentions require Basic+ tier on X API
  • Free tier only supports posting, deleting, and account lookup
  • Upgrade at https://developer.twitter.com/en/portal/products
Tweet not posting
  • Check tweet is < 280 characters (or < 4000 with X Premium)
  • Verify no special formatting issues
  • Check X API status at https://api.twitterstat.us/

Requirements

  • X Developer Account with API access
  • OAuth 1.0a credentials configured
  • Network access to api.twitter.com

Cost

Free. X API is free for basic usage. Check your app's rate limits in X Developer Portal.

Support

For X API issues, see: https://developer.twitter.com/en/docs/twitter-api

Installation

Terminal bash 

openclaw install x-oauth-api
Copied!

💻Code Examples

Store these environment variables (from your X Developer Account):

store-these-environment-variables-from-your-x-developer-account.txt
X_API_KEY              # Consumer Key (API Key)
X_API_SECRET           # Consumer Secret
X_ACCESS_TOKEN         # Access Token
X_ACCESS_TOKEN_SECRET  # Access Token Secret
X_USER_ID              # Optional: Your numeric user ID (speeds up mentions)

x search "AI agents" --limit 5

x-search-ai-agents---limit-5.txt
## Commands

### `x post <text>`
Post a single tweet.

**Options:**
- `--reply-to <tweet-id>` - Reply to a specific tweet
- `--quote <tweet-id>` - Quote tweet
- `--media <file>` - Attach image/video

**Example:**

x post "Check this out" --media image.jpg

x-post-check-this-out---media-imagejpg.txt
### `x thread <tweet1> <tweet2> ...`
Post a tweet thread.

**Example:**

"Most important takeaway"

-most-important-takeaway.txt
### `x mentions [options]`
Get recent mentions of your account.

**Options:**
- `--limit <n>` - Number of mentions (default: 10, max: 100)
- `--since <tweet-id>` - Only mentions after this ID
- `--format json` - Output as JSON

**Note:** Requires `X_USER_ID` env var OR will fetch it automatically (slower).

### `x search <query> [options]`
Search recent tweets.

**Options:**
- `--limit <n>` - Number of results (default: 10, max: 100)
- `--format json` - Output as JSON

### `x delete <tweet-id>`
Delete a tweet.

### `x me`
Show current account info (name, username, follower counts, user ID).

## API Rate Limits

X API v2 has rate limits per endpoint:

| Endpoint | Limit | Window |
|----------|-------|--------|
| POST /2/tweets | 200 | 15 min (Free tier) |
| GET /2/tweets/search/recent | 100 | 15 min (Free tier) |
| GET /2/users/:id/mentions | 100 | 15 min (Free tier) |

Rate limits vary by access tier. See [X API documentation](https://developer.twitter.com/en/docs/twitter-api/rate-limits) for details.

## Authentication

OAuth 1.0a is handled transparently. Just provide your credentials via environment variables. The skill will sign all requests automatically.

## Examples

### Post with media
example.sh
# Post a simple tweet
x post "Hello from X API"

# Post a thread
x thread "First tweet" "Second tweet" "Third tweet"

# Check mentions
x mentions --limit 10

# Search recent tweets
x search "AI agents" --limit 5
example.sh
x thread \
  "Thread about AI" \
  "Here's what I learned" \
  "Most important takeaway"
example.sh
x thread \
  "Just launched x-oauth-api skill" \
  "It lets you post to X directly from your agent" \
  "No proxies, direct OAuth 1.0a authentication"
example.sh
# Find interesting tweets
x search "agent framework"

# Reply to one
x post "Have you tried this?" --reply-to 1234567890123456789

Tags

#security_and-passwords #api

Quick Info

Category Monitoring
Model Claude 3.5
Complexity One-Click
Author ngmeyer
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install x-oauth-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