X (Twitter) Integration
Connect your AI agent to the X API with OAuth 1.0a. Post tweets, reply to mentions, manage DMs, and pull analytics, all from your agent's secure sandbox.
What your agent can do
Once connected, your agent has full read and write access to your X account through the API.
Post tweets
Compose and publish tweets on your behalf. Schedule threads, add media, and manage your posting cadence automatically.
Reply to mentions
Monitor your @mentions and reply in real time. Your agent can filter by relevance and respond with context-aware messages.
DM management
Read and respond to direct messages. Triage incoming DMs, answer FAQs, and escalate conversations that need a human.
Analytics
Pull engagement metrics, follower growth, and tweet performance data. Generate reports and surface trending content.
Timeline reading
Read your home timeline, lists, and search results. Stay on top of industry conversations and competitor activity.
Account protection
All API calls go through your agent's sandboxed environment. Rate limits are respected automatically, and credentials never leave the encrypted vault.
Prerequisites
- An active X (Twitter) account
- X Developer account (free tier works for basic access)
- An app created in the X Developer Portal with Read + Write permissions
- API Key, API Key Secret, Access Token, and Access Token Secret
X rate limits vary by API tier. Free tier allows 1,500 tweets/month. Basic ($100/mo) allows 3,000 tweets/month. Check your tier limits before configuring automated posting schedules.
Step-by-step setup
Connect your X account to ClawTrust in about 5 minutes.
Create an X Developer account
Go to developer.x.com and sign up for a developer account. You will need an active X account to apply. Approval is typically instant for basic access.
Create an app in the Developer Portal
In the Developer Portal, create a new project and app. Set the app permissions to Read and Write (and Direct Messages if you want DM capabilities).
Generate your API keys
Under your app settings, generate your API Key, API Key Secret, Access Token, and Access Token Secret. Save all four values securely. You will not be able to see them again.
Add credentials in ClawTrust
Open your agent's dashboard, go to Credentials, and click Add Credential. Select "X (Twitter)" and paste your four keys. ClawTrust encrypts them with AES-256-GCM before storage.
Your agent is live on X
Your agent can now post tweets, reply to mentions, and manage DMs. Test it by asking your agent to post a tweet from the chat interface.
Credential details
X uses OAuth 1.0a, which requires four separate keys to sign each API request.
API Key
Also called Consumer Key. Identifies your app to the X API.
API Key Secret
Also called Consumer Secret. Used to sign API requests.
Access Token
Grants your agent permission to act on behalf of your X account.
Access Token Secret
Used together with the Access Token to sign each request.
All credentials are encrypted with AES-256-GCM and stored in ClawTrust's secrets vault. They never touch the tenant VPS directly.
Example actions
Once connected, try asking your agent any of these:
"Post a tweet announcing our new product launch"
"Reply to all mentions from today with a thank-you message"
"Check my DMs for any unanswered messages"
"Pull my tweet engagement stats for the past week"
"Search for tweets about [topic] and summarize the sentiment"
Ready to automate your X presence?
Connect your X account in minutes. Secure OAuth 1.0a on every plan.