The safest way to connect AI agents to X/Twitter.
Official API writes. Free cookie reads. One endpoint.
Be first in line for the hosted SaaS version. No spam.
# Post a tweet via Official API 🔵
curl -X POST http://localhost:19816/tweet \
-H "Content-Type: application/json" \
-d '{"text": "Hello from OpenClaw X! 🦅"}'
{"success": true, "channel": "official_api", "data": {"id": "20283..."}}
# Search tweets via Cookie 🟠
curl "http://localhost:19816/search?q=AI&count=5"
{"data": [...], "count": 5, "channel": "cookie"}Post tweets, like, retweet, and bookmark through the official X API with OAuth 1.0a. No risk of account suspension.
Timeline, search, tweet details, and user profiles through cookies. Unlimited reads at zero cost.
Every request logs which channel it uses. Crystal clear debugging with 🔵 and 🟠 markers in real time.
Your AI agent calls localhost:19816 — a single FastAPI service that handles everything.
Write operations (POST) route to the official X API via tweepy. Read operations (GET) route through cookies via twikit.
Every response includes a "channel" field and every request gets logged with its routing channel.
| Endpoint | Method | Description | Channel |
|---|---|---|---|
/health |
GET | Health check + channel status | — |
/tweet |
POST | Create a tweet | 🔵 Official |
/tweet/{id}/like |
POST | Like a tweet | 🔵 Official |
/tweet/{id}/retweet |
POST | Retweet | 🔵 Official |
/tweet/{id}/bookmark |
POST | Bookmark a tweet | 🔵 Official |
/timeline |
GET | Home timeline | |
/search?q=... |
GET | Search tweets | |
/tweet/{id} |
GET | Tweet details | |
/user/{username} |
GET | User profile | |
/user/{username}/tweets |
GET | User's tweets |
Join the waitlist for the hosted SaaS version — or self-host today.