twitter-openclaw

What This Skill Does

The twitter-openclaw skill enables seamless interaction with the Twitter/X platform directly from your OpenClaw environment. It allows you to perform a wide range of actions, including reading individual tweets, entire conversation threads, and user mentions. You can also retrieve user profiles, view their recent tweets, and explore their liked content. The skill provides functionalities to access your home timeline and mentions, and to search for tweets using various keywords and operators. Trending topics, both globally and in specific locations, are also accessible. For content creation, you can post new tweets, reply to existing ones, quote tweets, and even include media attachments. Engagement actions like liking, retweeting, bookmarking, and their respective un-actions are supported. Furthermore, you can manage your social network by following and unfollowing users, and viewing their follower/following lists. Advanced list management allows you to view your lists, get tweets from a specific list, and add or remove users from your lists. The skill offers flexible output options, including JSON, plain text, and disabling colors, along with controls for the number of results and pagination.

Installation

To install the twitter-openclaw skill, use the following command in your OpenClaw environment:

clawhub install openclaw/skills/skills/annettemekuro30/x-twitter2

This command downloads and installs the skill from its source repository.

Use Cases

• Content Curation: Monitor specific hashtags or keywords to gather trending information or insights for research.
• Social Media Management: Schedule or automate posting updates, replying to customers, or engaging with your audience on Twitter/X.
• Market Research: Analyze public sentiment by searching for specific keywords and phrases related to your industry or products.
• Brand Monitoring: Track mentions of your brand or competitors to stay informed about online conversations.
• Information Gathering: Quickly retrieve information about a specific tweet, user, or conversation thread.
• Personal Feed Management: Keep up with your home timeline and mentions without leaving your OpenClaw interface.

Example Prompts

1. "Show me the latest 10 tweets from @elonmusk about AI development."
2. "Post this article to my Twitter: [link to article] #tech"
3. "What are the top trending topics in the UK right now?"

Tips & Limitations

• Authentication is crucial: Ensure your TWITTER_BEARER_TOKEN is correctly set for read operations, and TWITTER_API_KEY and TWITTER_API_SECRET for write operations. Use twclaw auth-check to verify.
• Rate Limits: Be mindful of Twitter's API rate limits to avoid getting temporarily blocked. Use the -n or --all options judiciously.
• --all option: While convenient for fetching all available data, using --all can be resource-intensive and may hit rate limits quickly. Use with caution, especially for search queries that might return a vast number of results.
• Location Trending: To get trending topics for a specific location, you'll need to find the corresponding woeid. A quick web search can help you find these IDs (e.g., "Twitter WOEID for New York City").
• Media Uploads: Ensure your media files are in a compatible format and accessible by the system where OpenClaw is running.
• Error Handling: The skill provides basic output, but for complex workflows, consider wrapping these commands in scripts that include more robust error handling.
• API Changes: Twitter's API can change. If you encounter issues, check the skill's documentation or repository for updates.