Twitter (X) Integration

Overview

The Twitter (X) integration enables your elizaOS agent to interact on Twitter, posting tweets, replying to mentions, liking content, and managing your social presence. This integration uses Twitter’s API and authentication system.

Prerequisites

Before setting up Twitter integration, you need:

A Twitter/X account
Elevated API access (required for posting)
Twitter Developer Account and API credentials
2FA enabled on your account (recommended)

Setup

Apply for Twitter Developer Access

Go to Twitter Developer Portal

Click “Sign up for Free Account” or “Apply” for a Developer Account

Fill out the application form describing your use case

Wait for approval (usually 1-2 business days)

Create a Twitter App

Once approved, go to the Developer Portal

Click ”+ Create Project” or “Create App”

Enter your app name and description

Select your use case

Complete the app setup

Get API Credentials

In your app settings, go to “Keys and tokens”

Generate/view the following:

API Key (Consumer Key)
API Secret (Consumer Secret)
Access Token
Access Token Secret

Copy these values - you’ll need them for configuration

Store these credentials securely. Never commit them to version control or share them publicly.

Request Elevated Access

To post tweets and interact fully, you need Elevated access:

In the Developer Portal, go to “Products” > “Twitter API v2”

Click “Elevated” and apply

Describe your use case

Wait for approval

Set Environment Variables

Add the following to your .env file:

# Required
TWITTER_USERNAME=your_twitter_username
TWITTER_PASSWORD=your_twitter_password

# Optional but recommended
TWITTER_EMAIL=[email protected]
TWITTER_2FA_SECRET=your_2fa_secret_here

The Twitter integration uses username/password authentication. If you have 2FA enabled (recommended), you’ll need to provide your 2FA secret.

Add the Twitter Plugin

In your character configuration file, add the Twitter plugin:

{
  "name": "YourAgent",
  "plugins": [
    "@elizaos/plugin-twitter"
  ],
  "settings": {
    "channels": {
      "twitter": {
        "enabled": true
      }
    }
  }
}

Configuration

Environment Variables

The Twitter integration uses the following environment variables:

Variable	Required	Description
`TWITTER_USERNAME`	Yes	Your Twitter username (without @)
`TWITTER_PASSWORD`	Yes	Your Twitter password
`TWITTER_EMAIL`	No	Your email (helpful for account recovery)
`TWITTER_2FA_SECRET`	No	Your 2FA secret key (if 2FA is enabled)

Character Settings

Configure Twitter-specific behavior:

{
  "settings": {
    "channels": {
      "twitter": {
        "enabled": true,
        "autoEngage": true,
        "replyToMentions": true,
        "likeMentions": true,
        "postInterval": 3600000,
        "maxTweetsPerDay": 50
      }
    }
  }
}

Features

Posting Tweets

Your agent can post tweets:

// Post a tweet
{
  "action": "tweet",
  "text": "Hello from elizaOS! 🤖"
}

// Tweet with media
{
  "action": "tweet",
  "text": "Check out this image!",
  "mediaUrls": ["https://example.com/image.jpg"]
}

Tweets are limited to 280 characters. Plan your agent’s posts accordingly.

Reply to Tweets

Respond to mentions or other tweets:

{
  "action": "reply",
  "tweetId": "1234567890123456789",
  "text": "Thanks for reaching out! Here's the information you requested."
}

Like and Retweet

Engage with content:

// Like a tweet
{
  "action": "like",
  "tweetId": "1234567890123456789"
}

// Retweet
{
  "action": "retweet",
  "tweetId": "1234567890123456789"
}

// Quote tweet
{
  "action": "quote",
  "tweetId": "1234567890123456789",
  "text": "This is interesting because..."
}

Follow and Unfollow

Manage your following:

// Follow a user
{
  "action": "follow",
  "username": "targetuser"
}

// Unfollow a user
{
  "action": "unfollow",
  "username": "targetuser"
}

Search Tweets

Find tweets by keywords:

{
  "action": "search",
  "query": "elizaOS",
  "maxResults": 10
}

Monitor Mentions

Your agent automatically monitors mentions when configured:

{
  "settings": {
    "channels": {
      "twitter": {
        "replyToMentions": true,
        "likeMentions": true
      }
    }
  }
}

Get Tweet Information

Retrieve details about tweets:

{
  "action": "getTweet",
  "tweetId": "1234567890123456789"
}

Timeline

Fetch your timeline or user timelines:

// Home timeline
{
  "action": "timeline",
  "limit": 20
}

// User timeline
{
  "action": "userTimeline",
  "username": "someuser",
  "limit": 20
}

Writing Style for Twitter

Configure your agent’s personality for Twitter:

Best Practices

Do:

Keep tweets under 280 characters
Use relevant hashtags (1-2 max)
Ask engaging questions
Add value to conversations
Use emojis strategically
Include links when helpful
Reply thoughtfully to mentions
Thread longer thoughts

Don’t:

Spam hashtags (#too #many #hashtags)
Post identical content repeatedly
Engage in arguments
Share unverified information
Ignore mentions and DMs
Over-promote

Example Personality Configuration

{
  "style": {
    "post": [
      "Be concise and engaging",
      "Use 1-2 relevant emojis per tweet",
      "Ask questions to encourage discussion",
      "Share insights with practical value",
      "Keep it under 260 chars for retweet space"
    ]
  }
}

Plugin Auto-Loading

The Twitter plugin auto-loads when credentials are configured:

// From character.ts:240-247
const plugins = [
  ...(env.TWITTER_USERNAME?.trim() && 
      env.TWITTER_PASSWORD?.trim()
    ? ["@elizaos/plugin-twitter"]
    : [])
];

Both TWITTER_USERNAME and TWITTER_PASSWORD must be set.

Rate Limits and Best Practices

Twitter API Rate Limits

Tweet posting: 300 tweets per 3 hours
Likes: 1000 per 24 hours
Follows: 400 per 24 hours
Retweets: No specific limit, but monitored for spam
Mentions timeline: 75 requests per 15 minutes

Avoiding Suspension

Don’t spam - Space out tweets naturally
Vary content - Don’t post repetitive messages
Engage authentically - Respond thoughtfully to mentions
Respect rate limits - Implement backoff strategies
Follow Twitter Rules - Review Twitter Rules
Monitor account health - Check for warnings in Twitter settings

Recommended Limits

{
  "settings": {
    "channels": {
      "twitter": {
        "maxTweetsPerDay": 50,
        "maxRepliesPerHour": 10,
        "maxLikesPerHour": 30,
        "minTimeBetweenTweets": 300000
      }
    }
  }
}

Security Considerations

Two-Factor Authentication

Enable 2FA on your Twitter account:

Go to Settings > Security > Two-factor authentication
Choose “Authentication app”
Scan the QR code with an authenticator app
Save the backup code shown
Use the secret key as TWITTER_2FA_SECRET

Account Security

Use a strong, unique password
Enable login verification
Review authorized apps regularly
Monitor account activity
Use environment variables, never hardcode credentials

Bot Disclosure

Be transparent that this is an AI agent:

Include “bot” or “AI” in your bio
Disclose in pinned tweet if appropriate
Follow platform policies on automation

Troubleshooting

Authentication fails

Verify TWITTER_USERNAME and TWITTER_PASSWORD are correct
Check if 2FA is enabled and TWITTER_2FA_SECRET is set
Try logging in manually to ensure account isn’t locked
Check for password reset requirements

Tweets not posting

Verify you have Elevated API access
Check rate limits in Developer Portal
Ensure tweet content doesn’t violate Twitter rules
Check for duplicate content (Twitter blocks exact duplicates)

Not receiving mentions

Check API credentials are valid
Verify account isn’t shadowbanned
Check mention notification settings
Review rate limit status

Account suspended

Review Twitter’s suspension notice
Appeal if you believe it’s in error
Review and adjust agent behavior
Ensure compliance with automation rules

Use Cases

Community Engagement

Respond to questions about your project
Share updates and announcements
Amplify community content
Provide support and resources

Content Distribution

Share blog posts and articles
Post tips and insights
Thread complex topics
Curate relevant content

Brand Presence

Maintain consistent voice
Engage with followers
Participate in relevant conversations
Monitor brand mentions

Customer Service

Answer common questions
Direct users to resources
Collect feedback
Escalate complex issues

Get Started

Core Concepts

Guides

Multi-Language Support

Platform Integration

​Overview

​Prerequisites

​Setup

​Configuration

​Environment Variables

​Character Settings

​Features

​Posting Tweets

​Reply to Tweets

​Like and Retweet

​Follow and Unfollow

​Search Tweets

​Monitor Mentions

​Get Tweet Information

​Timeline

​Writing Style for Twitter

​Best Practices

​Example Personality Configuration

​Plugin Auto-Loading

​Rate Limits and Best Practices

​Twitter API Rate Limits

​Avoiding Suspension

​Recommended Limits

​Security Considerations

​Two-Factor Authentication

​Account Security

​Bot Disclosure

​Troubleshooting

​Authentication fails

​Tweets not posting

​Not receiving mentions

​Account suspended

​Use Cases

​Community Engagement

​Content Distribution

​Brand Presence

​Customer Service

​Related Resources

Build docs developers (and LLMs) love

Overview

Prerequisites

Setup

Configuration

Environment Variables

Character Settings

Features

Posting Tweets

Reply to Tweets

Like and Retweet

Follow and Unfollow

Search Tweets

Monitor Mentions

Get Tweet Information

Timeline

Writing Style for Twitter

Best Practices

Example Personality Configuration

Plugin Auto-Loading

Rate Limits and Best Practices

Twitter API Rate Limits

Avoiding Suspension

Recommended Limits

Security Considerations

Two-Factor Authentication

Account Security

Bot Disclosure

Troubleshooting

Authentication fails

Tweets not posting

Not receiving mentions

Account suspended

Use Cases

Community Engagement

Content Distribution

Brand Presence

Customer Service

Related Resources