x-api

What This Skill Does

The x-api skill provides a dedicated interface for interacting with X (Twitter) using the official API v2 protocol. It is specifically engineered to handle complex OAuth 1.0a authentication internally, abstracting away the cryptographic overhead required for secure API communication. By utilizing a pre-configured Node.js script located at /root/.openclaw/skills/x-api/x-api.js, the agent can execute high-level actions such as posting, threading, replying, and scheduling content directly to the platform. This skill is the exclusive method for social media interaction within the OpenClaw environment; all other attempts at manual API interaction are prohibited to ensure consistency and security.

Installation

To integrate this capability into your environment, use the command: clawhub install openclaw/skills/skills/3rdbrain/x-leads-api. Ensure that your environment variables (X_API_KEY, X_API_SECRET, X_ACCESS_TOKEN, and X_ACCESS_SECRET) are correctly populated, as the script relies on these for successful authentication.

Use Cases

• Automated Social Presence: Maintain a consistent posting schedule by using the scheduling functionality to drip-feed content throughout the day.
• Engagement & Interaction: Automatically reply to mentions or quote-tweet industry news to increase visibility and follower count.
• Content Management: Create complex threads to explain technical concepts or share long-form thought leadership without leaving the terminal.
• Monitoring: Utilize the timeline feature to retrieve recent tweets and analyze engagement or feedback loops for future strategy refinement.

Example Prompts

1. "Check my recent tweets, then draft and post a reply to the most recent one with a helpful summary of our latest documentation update."
2. "I need to launch an announcement thread. Schedule these three tweets: 'OpenClaw v2 is officially live!', 'Check out our new documentation portal at docs.openclaw.ai', and 'Stay tuned for more updates tomorrow!' for 9 AM UTC tomorrow."
3. "Find the tweet with ID 1234567890 and post a quote-tweet saying 'This is a fantastic example of AI automation in practice!'"

Tips & Limitations

• Character Limits: Every tweet is limited to 280 characters. The script will return an error if this limit is exceeded, so pre-process your content strings if necessary.
• Thread Depth: You are limited to a maximum of 25 tweets per thread request.
• Verification: Always check the JSON response object returned by the script. If success is false, inspect the summary field to determine if you hit a rate limit or provided an invalid argument.
• Security: Do not attempt to modify the underlying JavaScript file or install additional Node packages, as the environment is locked to prevent dependency conflicts.