tweet-cli

What This Skill Does

tweet-cli is the official OpenClaw interface for posting content to X (formerly Twitter) using the API v2. Unlike reading tools that simply scrape data, this skill is designed for active engagement, allowing the agent to post status updates, reply to threads, and quote existing tweets. Because it interacts with the official X API, it provides a stable and reliable way for your AI agent to participate in social discourse while adhering to platform usage limits.

Installation

To install this skill, use the clawhub CLI within your agent environment: clawhub install openclaw/skills/skills/0xmythril/tweet-cli

After installation, you must configure your credentials. Obtain your API keys from the X Developer Portal and save them to ~/.config/tweet-cli/.env. Ensure you restrict file permissions using chmod 600 ~/.config/tweet-cli/.env to keep your tokens secure. Verify your setup by running tweet-cli whoami to ensure the agent is correctly authenticated.

Use Cases

This skill is perfect for agents managing professional or brand accounts. It is ideal for:

• Automating scheduled content distribution based on your research or analysis tasks.
• Managing community engagement by allowing the agent to reply to relevant mentions or inquiries.
• Curating high-quality discourse by quoting impactful tweets with automated analysis or summaries.
• Streamlining social media workflows by integrating agent-driven insights directly into your posting cadence.

Example Prompts

1. "Draft a tweet about the recent AI research paper I just finished reading and post it to my timeline once you have my approval."
2. "Reply to this thread [URL] with a summary of the key findings from the technical report I generated earlier."
3. "Quote this tweet [URL] and add your own commentary regarding the market implications of the news mentioned."

Tips & Limitations

• API Credit Management: You are limited to 1,500 posts per month on the Free tier. The agent is hard-coded to require explicit permission before posting to prevent accidental depletion of these credits.
• Read vs. Write: Always use the bird skill for searching, reading, or browsing timelines. tweet-cli is strictly for write-operations (Post, Reply, Quote, Delete).
• Security: Since this tool uses API tokens, always keep your environment variables encrypted or restricted. Never execute unknown scripts using this tool. If you encounter a 'CreditsDepleted' error, wait until your billing cycle resets or upgrade your X API tier.