Connect Twitter to OpenClaw on Operator.io
Twitter is a social media platform for sharing real-time updates, conversations, and news. Stay connected, informed, and engaged with communities worldwide.
Automate Twitter with AI
Operator puts an OpenClaw agent in front of Twitter. You describe the job from Telegram or Discord and it handles the rest inside Twitter, picking the right calls from the 78 Twitter actions and checking its own work as it goes.
Your agent reaches Twitter directly or through connectors like Composio MCP and Pipedream MCP, which handle the sign in and token refresh for you, so there is nothing to wire up and no API keys to paste.
What your agent can do with Twitter
Your agent can call any of these Twitter actions by name as part of a larger task. Ask for the outcome you want and it picks the right ones.
Add a list member
Adds a user to a specified Twitter List; the list must be owned by the authenticated user.
Add post to bookmarks
Adds a specified, existing, and accessible Tweet to a user's bookmarks, with success indicated by the 'bookmarked' field in the response.
Append Media Upload
Append data chunk to an ongoing media upload session on X/Twitter. Use this action during chunked media uploads to append each segment of media data in sequence.
Get bookmarks by user
Retrieves Tweets bookmarked by the authenticated user, where the provided User ID must match the authenticated user's ID.
Create activity subscription
Tool to create a subscription for an X activity event. Use when you need to monitor specific user activities like profile updates, follows, or spaces events.
Create compliance job
Creates a new compliance job to check the status of Tweet or user IDs; upload IDs as a plain text file (one ID per line) to the `upload_url` received in the response.
Create group DM conversation
Creates a new group Direct Message (DM) conversation on Twitter. REQUIRED PARAMETERS: - conversation_type: Must be 'Group' - participant_ids: List of Twitter user IDs to include in the conversation - message: JSON object with the initial...
Create a list
Creates a new, empty List on X (formerly Twitter), for which the provided name must be unique for the authenticated user; accounts are added separately.
Create a post
Creates a Tweet on Twitter; `text` is required unless `card_uri`, `media_media_ids`, `poll_options`, or `quote_tweet_id` is provided. Example - Creating a tweet with media and location: { "text": "Check out our latest product update! 🚀"...
Delete direct message
Permanently deletes a specific Twitter Direct Message (DM) event using its `event_id` if the authenticated user sent it; this action is irreversible and does not delete entire conversations.
Delete list
Permanently deletes a specified Twitter List using its ID, which must be owned by the authenticated user; this action is irreversible and the list must already exist.
Get followers by user id
Retrieves a list of users who follow a specified public Twitter user ID.
Get following by user ID
Retrieves users followed by a specific Twitter user, allowing pagination and customization of returned user and tweet data fields via expansions.
Follow a list
Allows the authenticated user (`id`) to follow a specific Twitter List (`list_id`) they are permitted to access, subscribing them to the list's timeline; this does not automatically follow individual list members.
Follow a user
Allows an authenticated user (path `id`) to follow another user (`target_user_id`), which results in a pending request if the target user's tweets are protected.
Search full archive of tweets
Searches the full archive of public Tweets from March 2006 onwards; use 'start_time' and 'end_time' together for a defined time window.
Get users blocked by user ID
Retrieves the authenticated user's own block list. IMPORTANT: You can only retrieve YOUR OWN block list - the `id` parameter must be the authenticated user's ID. Use the 'Get authenticated user' action first to obtain your user ID.
Retrieve compliance job by id
Retrieves status, download/upload URLs, and other details for an existing Twitter compliance job specified by its unique ID.
Retrieve compliance jobs
Returns a list of recent compliance jobs, filtered by type (tweets or users) and optionally by status.
Get DM events for a DM conversation
Fetches Direct Message (DM) events for a one-on-one conversation with a specified participant ID, ordered chronologically newest to oldest; does not support group DMs.
Get DM events by ID
Fetches a specific Direct Message (DM) event by its unique ID, allowing optional expansion of related data like users or tweets; ensure the `event_id` refers to an existing DM event accessible to the authenticated user.
Lookup list by ID
Returns metadata for a specific Twitter List, identified by its ID; does not return list members but can expand the owner's User object via the `expansions` parameter.
Get list followers
Fetches a list of users who follow a specific Twitter List, identified by its ID; ensure the authenticated user has access if the list is private.
Fetch list members by id
Fetches members of a specific Twitter List, identified by its unique ID.
Get Media Upload Status
Get the processing status of uploaded media (videos/GIFs) on X/Twitter. Only call this when the FINALIZE command returned a processing_info field. Poll every 3–5 seconds with a 60–120 second maximum timeout to avoid HTTP 429 errors. Resp...
Get muted users
Returns user objects muted by the X user identified by the `id` path parameter.
Fetch OpenAPI specification
Fetches the OpenAPI specification (JSON) for Twitter's API v2, used to programmatically understand the API's structure for developing client libraries or tools.
Get Post analytics
Tool to retrieve analytics data for specified Posts within a defined time range. Use when you need engagement metrics, impressions, or other analytics for one or more Posts. Requires OAuth 2.0 with tweet.read and users.read scopes.
Get post retweeters
Retrieves users who publicly retweeted a specified public Post ID, excluding Quote Tweets and retweets from private accounts.
Retrieve retweets of a post
Retrieves Tweets that Retweeted a specified public or authenticated-user-accessible Tweet ID, optionally customizing the response with fields and expansions.
Fetch tweet usage data
Fetches Tweet usage statistics for a Project (e.g., consumption, caps, daily breakdowns for Project & Client Apps) to monitor API limits; data can be retrieved for 1 to 90 days.
Get recent direct message events
Returns recent Direct Message events for the authenticated user, such as new messages or changes in conversation participants.
Look up space by ID
Retrieves details for a Twitter Space by its ID, allowing for customization and expansion of related data, provided the Space ID is valid and accessible.
Retrieve posts from a space
Retrieves Tweets that were shared/posted during a Twitter Space broadcast. IMPORTANT: This endpoint returns Tweets that participants explicitly shared during the Space session, NOT audio transcripts, comments, or reactions. Most Spaces h...
Get spaces by creator IDs
Retrieves Twitter Spaces created by a list of specified User IDs, with options to customize returned data fields.
Get space information by IDs
Fetches detailed information for one or more Twitter Spaces (live, scheduled, or ended) by their unique IDs; at least one Space ID must be provided.
Fetch space ticket buyers list
Retrieves a list of users who purchased tickets for a specific, valid, and ticketed Twitter Space.
Look up user by ID
Retrieves detailed public information for a Twitter user by their ID, optionally expanding related data (e.g., pinned tweets) and specifying particular user or tweet fields to return.
Get user's followed lists
Returns metadata (not Tweets) for lists a specific Twitter user follows, optionally including expanded owner details.
Get a user's list memberships
Retrieves all Twitter Lists a specified user is a member of, including public Lists and private Lists the authenticated user is authorized to view.
Get a user's owned lists
Call this action to retrieve Lists created (owned) by a specific Twitter user, not Lists they follow or are subscribed to.
Get a user's pinned lists
Retrieves the Lists a specific, existing Twitter user has pinned to their profile to highlight them.
Look up users by IDs
Retrieves detailed information for specified X (formerly Twitter) user IDs, optionally customizing returned fields and expanding related entities.
Set reply visibility
Hides or unhides an existing reply Tweet. This action allows the authenticated user to hide or unhide a reply to a conversation they own (started). You can only hide replies to posts you authored. Note: Requires the tweet.moderate.write...
Initialize Media Upload
Initialize a media upload session for X/Twitter. Use this to start a chunked media upload process, which returns a media_id for subsequent APPEND and FINALIZE commands. Required for uploading large files or when using the chunked upload...
List post likers
Retrieves users who have liked the Post (Tweet) identified by the provided ID.
List posts timeline by list ID
Fetches the most recent Tweets posted by members of a specified Twitter List.
Mute user by ID
Mutes a target user on behalf of an authenticated user, preventing the target's Tweets and Retweets from appearing in the authenticated user's home timeline without notifying the target.
Plus 30 more Twitter actions your agent can call.
How to connect Twitter
You authorize Twitter once from your dashboard. Operator holds the connection and refreshes the access tokens on its own, so your agent keeps working with Twitter without you signing in again. The same setup unlocks every other app your agent can reach, so you only do it once.
When you are ready, the get started guide walks through standing up your OpenClaw agent.
Common questions about Twitter
- How do I connect Twitter to Operator?
- You authorize Twitter once from your Operator dashboard. Operator holds the connection and refreshes the access token for you, so your agent keeps working with Twitter without you signing in again.
- Can my agent publish and schedule content in Twitter?
- Yes. It can draft posts, schedule them, and read back how they did once they are live. A common loop is draft, review, schedule, and publish, where you approve the copy and the agent handles the timing and the posting in Twitter.
- Do I need to write code or manage Twitter API keys?
- No code and no API keys. You authorize Twitter through a normal sign in and Operator handles the connection, so there is nothing to wire up or host.
- Can my agent use Twitter together with my other apps?
- Yes. The same agent reaches every app you connect, so it can move between Twitter and tools like Strava, Instagram, Dotsimple in one job, reading from one and acting in another without you wiring anything between them.
Twitter integrations
Pick an app to see what your agent does across Twitter and it, or browse all integrations.
Put your agent on Twitter
Sign in, connect Twitter, and hand your agent the work. Your first week is free.
Get started