falcon

What This Skill Does

The falcon skill provides a comprehensive bridge between the OpenClaw AI agent and the Twitter/X platform via the TwexAPI. It serves as a multifunctional tool capable of reading user profiles, searching through global tweet data, engaging with content through likes and retweets, and composing new posts. By utilizing the TwexAPI backend, falcon enables seamless integration of social media workflows into your automated agent tasks. Whether you need to monitor market trends, scrape user-specific interaction data, or manage an account's social presence programmatically, this skill provides the necessary command-line interface to interact with the platform safely and efficiently.

Installation

To integrate falcon into your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/bubblyjove/falcon

Ensure that you have set the necessary environment variables for functionality. The TWEXAPI_KEY is mandatory for all read and search operations, while the TWITTER_COOKIE is required for write and engagement operations such as posting, liking, or following. The script is located at {baseDir}/falcon.sh.

Use Cases

• Market Intelligence: Monitor cashtags like '$BTC' or '$ETH' to aggregate sentiment and recent posts for financial analysis.
• Social Listening: Track specific keywords or hashtags to identify community trends or respond to mentions.
• Account Management: Automate the organization of bookmarks or maintain engagement through programmatic liking and retweeting.
• Content Curation: Extract lists of followers or following for specific accounts to map network influence.
• Automated Updates: Post recurring updates or reply to specific threads automatically after user confirmation.

Example Prompts

1. "Falcon, search for the latest tweets about 'artificial intelligence' and summarize the top 10 results for me."
2. "Can you check the follower count for elonmusk and list his 5 most recent tweets?"
3. "Please reply to this tweet [URL] saying: 'This is a great perspective on current tech trends.'"

Tips & Limitations

• Confirmation Requirement: Always confirm with the user before performing write or engagement actions (like, retweet, post, follow). The agent is designed to prioritize safety by requiring explicit consent for sensitive actions.
• Advanced Search: The search function supports native Twitter advanced search syntax, allowing for highly granular queries.
• API Credits: Use the 'falcon balance' command frequently to ensure you have enough remaining API credits to complete your tasks.
• ID/URL Flexibility: Most commands accept either a direct URL (x.com or twitter.com) or a bare tweet ID, simplifying your workflow.