x-oauth-api
Post to X (Twitter) using the official OAuth 1.0a API. Free tier compatible.
- License 许可
- MIT
- 最近更新
- 2026-06-07
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- x-oauth-api
- metadata
- { "openclaw": { "requires": { "env": [ "X_API_KEY", "X_API_SECRET", "X_ACCESS_TOKEN", "X_ACCESS_TOKEN_SECRET" ] } } }
- description
- Post to X (Twitter) using the official OAuth 1.0a API. Free tier compatible.
03 SKILL.md 正文
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):
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
# 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 <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 thread <tweet1> <tweet2> ...
Post a tweet thread.
Example:
x thread \
"Thread about AI" \
"Here's what I learned" \
"Most important takeaway"
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 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
x post "Check out this screenshot" --media screenshot.png
Reply to a tweet
x post "Great point!" --reply-to 1234567890123456789
Create a 3-tweet thread
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
# 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
04 同仓库更多 Skills
crowd-prompting
A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.
ceaser
Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir/UltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).
ceaser-send
Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp <subcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir/UltraHonk zero-knowledge proofs.
dilemm-ai
Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).
moldium
Post and manage content on the Moldium blog platform. Triggered by "post to Moldium", "write a blog post", "publish an article", etc.
arxiv-paper-reviews
Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date/category/interest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http://weakaccept.top:8000/.