x-oauth-api

What This Skill Does

The x-oauth-api skill provides an advanced, secure interface for managing X (formerly Twitter) operations directly from your OpenClaw environment. By utilizing OAuth 1.0a authentication, this skill ensures that your credentials remain secure while giving you full programmatic control over your account. Whether you are automating social media presence, managing threads, or monitoring engagement, this tool acts as a dedicated bridge to the official X API v2. It supports a variety of operations including posting individual tweets, structuring multi-tweet threads, deleting content, and performing account analysis. Because it communicates directly with X servers, it bypasses the need for unreliable proxies or third-party intermediary services, ensuring faster execution and higher reliability for your automated workflows.

Installation

To integrate this skill into your environment, use the OpenClaw management command: clawhub install openclaw/skills/skills/ngmeyer/x-oauth-api. After installation, ensure you have set the necessary environment variables in your configuration file: X_API_KEY, X_API_SECRET, X_ACCESS_TOKEN, and X_ACCESS_TOKEN_SECRET. Including your X_USER_ID is highly recommended to improve the latency of mention-fetching commands.

Use Cases

This skill is ideal for power users and developers who need to integrate social media into their agentic workflows. Use it for automated brand monitoring by setting up periodic checks for mentions, or for content management by scheduling complex thread publications. It is particularly useful for agents tasked with maintaining active social profiles or providing customer support via direct replies.

Example Prompts

1. "Post a thread to my account about our new AI agent update: Start with 'Just launched our latest agent!', then 'It features improved memory', and finally 'Try it now at our portal'."
2. "Check for any new mentions on my account and give me a summary of the most recent ones."
3. "Search for the latest tweets related to 'open source AI' and show me the top 5 results."

Tips & Limitations

Be mindful of the X API tier constraints. The free tier is sufficient for basic posting and deleting, but tasks like searching tweets or fetching extensive mention history may require a Basic+ tier subscription. Always verify your API rate limits to prevent temporary account suspension. Remember that media uploads require specific Basic+ access, and ensure your authentication tokens have the correct permissions configured in the X Developer Portal. If you encounter issues, verify that your X_USER_ID is correctly set to optimize API call overhead.