Auto Tweet Publish

Post, search, like, retweet, bookmark, and manage a Twitter/X account via a local twikit-based API server on port 19816. Use when the user asks to tweet, search tweets, check timeline, like/retweet posts, or manage their X account. Replaces openclaw-x with fully auditable open-source Python code.

Auto-Tweet Agent — OpenClaw Skill

Safe, open-source Twitter/X automation via twikit. Replaces openclaw-x with fully auditable Python code.

Overview

This skill lets you control a Twitter/X account through natural language. The local API runs on http://localhost:19816 and wraps the open-source twikit library (4.1K+ ⭐, MIT license).

No closed-source binaries. No cookie theft risk. Fully transparent.

Prerequisites

The Auto-Tweet server must be running:

bash

cd ~/.openclaw/skills/auto-tweet
python main.py

Available Actions

Post a tweet

bash

curl -X POST http://localhost:19816/tweet \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello from OpenClaw!"}'

Post a tweet with media

bash

curl -X POST http://localhost:19816/tweet \
  -H "Content-Type: application/json" \
  -d '{"text": "Check this out!", "media_paths": ["/path/to/image.jpg"]}'

Reply to a tweet

bash

curl -X POST http://localhost:19816/tweet \
  -H "Content-Type: application/json" \
  -d '{"text": "Great point!", "reply_to": "TWEET_ID"}'

Quote tweet

bash

curl -X POST http://localhost:19816/tweet \
  -H "Content-Type: application/json" \
  -d '{"text": "This is amazing!", "quote_url": "https://x.com/user/status/TWEET_ID"}'

Search tweets

bash

curl "http://localhost:19816/search?q=AI+Agent&type=Latest&count=10"

Search users

bash

curl "http://localhost:19816/search/users?q=openai&count=5"

Get timeline (For You)

bash

curl "http://localhost:19816/timeline?count=20"

Get timeline (Following)

bash

curl "http://localhost:19816/timeline/following?count=20"

Like a tweet

bash

curl -X POST http://localhost:19816/like \
  -H "Content-Type: application/json" \
  -d '{"tweet_id": "TWEET_ID"}'

Unlike a tweet

bash

curl -X POST http://localhost:19816/unlike \
  -H "Content-Type: application/json" \
  -d '{"tweet_id": "TWEET_ID"}'

Retweet

bash

curl -X POST http://localhost:19816/retweet \
  -H "Content-Type: application/json" \
  -d '{"tweet_id": "TWEET_ID"}'

Undo retweet

bash

curl -X POST http://localhost:19816/unretweet \
  -H "Content-Type: application/json" \
  -d '{"tweet_id": "TWEET_ID"}'

Bookmark a tweet

bash

curl -X POST http://localhost:19816/bookmark \
  -H "Content-Type: application/json" \
  -d '{"tweet_id": "TWEET_ID"}'

Get bookmarks

bash

curl "http://localhost:19816/bookmarks?count=20"

Get user profile

bash

curl "http://localhost:19816/user/elonmusk"

Get user tweets

bash

curl "http://localhost:19816/user/elonmusk/tweets?type=Tweets&count=10"

Get a specific tweet

bash

curl "http://localhost:19816/tweet/TWEET_ID"

Delete a tweet

bash

curl -X DELETE "http://localhost:19816/tweet/TWEET_ID"

Get trending topics

bash

curl "http://localhost:19816/trends?category=trending"

Send a DM

bash

curl -X POST http://localhost:19816/dm \
  -H "Content-Type: application/json" \
  -d '{"user_id": "USER_ID", "text": "Hello!"}'

Follow / Unfollow

bash

curl -X POST "http://localhost:19816/follow/USER_ID"
curl -X POST "http://localhost:19816/unfollow/USER_ID"

Get notifications

bash

curl "http://localhost:19816/notifications?type=Mentions&count=20"

Schedule a tweet

bash

curl -X POST http://localhost:19816/schedule \
  -H "Content-Type: application/json" \
  -d '{"text": "Scheduled tweet!", "scheduled_at": 1735689600}'

Check rate limits

bash

curl "http://localhost:19816/rate_limits"

Health check

bash

curl "http://localhost:19816/"

Rate Limits (Built-in Safety)

Limit	Default	Purpose
API calls/hour	30	Prevent hourly burst
API calls/day	200	Match normal usage
Tweets/day	20	Conservative posting

All limits are configurable in config.json.

Error Handling

All endpoints return standard HTTP status codes:

• 200 — Success
• 400 — Bad request (invalid parameters)
• 401 — Session expired (restart server)
• 403 — Account issue (suspended/locked)
• 409 — Duplicate tweet
• 429 — Rate limit exceeded
• 500 — Twitter API error

Security Notes

• Server binds to 127.0.0.1 only (localhost) — no external access
• Credentials stay in local config.json
• Cookies saved locally in cookies.json
• All code is open-source Python — fully auditable
• No telemetry, no external callbacks
• Rate limiter protects against accidental overuse