A comprehensive CLI-driven skill for searching, reading, and interacting with Twitter/X via the TwexAPI.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install falcon
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install falcon using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Falcon?
Falcon is a powerful interface designed for AI agents to seamlessly interact with Twitter (now X). It bridges the gap between large language models and real-time social data, enabling tasks ranging from sentiment analysis to automated engagement. By utilizing the TwexAPI, this entry in the Openclaw Skills collection provides a robust set of tools for fetching user profiles, searching advanced queries, and monitoring trending topics globally.
Built to be developer-centric, Falcon handles the complexities of social media API calls through simple bash commands. It allows for deep data retrieval, such as threading replies and identifying similar content, while maintaining strict control over write operations like tweeting and liking. This makes it an essential tool for developers building social-aware AI agents or automated research workflows within the Openclaw Skills ecosystem.
Falcon Use Cases
- Real-time market sentiment analysis by searching specific cashtags or hashtags.
- Automated community engagement and responding to brand mentions.
- Researching user influence and networking by analyzing followers and following lists.
- Monitoring global or country-specific trending topics for news aggregation.
- Curating and bookmarking high-value content for later retrieval and analysis.
How Falcon Works
- The AI agent invokes the falcon command via the Bash tool following a user request.
- The script validates the presence of the TWEXAPI_KEY and necessary CLI utilities like curl and jq.
- For read operations, Falcon queries the TwexAPI to fetch structured JSON data about users or tweets.
- For write operations, such as posting or liking, the skill utilizes the TWITTER_COOKIE to authenticate as the authorized user.
- Structured data is returned to the agent, allowing it to interpret social contexts and perform further actions within the Openclaw Skills framework.
Falcon Setup
To use this skill, ensure you have your API credentials ready. First, set your environment variables:
export TWEXAPI_KEY="your_twexapi_key"
export TWITTER_COOKIE="your_twitter_auth_cookie" # Required for write and engagement actions
Ensure curl and jq are installed on your system. You can then verify your setup using the built-in check command:
falcon check
This confirms that your keys are active and the script is ready to interact with Openclaw Skills.
Falcon Data Schema & Taxonomy
Falcon processes and returns data structured for easy interpretation by AI models. Key data points include:
| Data Type | Attributes Captured |
|---|---|
| User Profile | ID, Username, Bio, Follower/Following counts |
| Tweet Object | Tweet ID, Text, Author, Timestamp, Engagement metrics |
| Search Results | List of relevant tweets based on advanced query syntax |
| Account Info | API key status and remaining credit balance |
All commands accept either direct IDs or full x.com or twitter.com URLs, ensuring flexibility in how data is referenced within Openclaw Skills.
Falcon Advanced Features
- Support for Twitter advanced search syntax for granular data filtering.
- Multi-user lookup capabilities using comma-separated strings.
- Regional trending topic monitoring using country-specific slugs like japan or united-states.
- Automated reply threading and similar tweet discovery for deep research.
- Seamless integration with other Openclaw Skills for multi-agent workflows and automated content strategy.
SKILL.md
Loading
Related Openclaw Skills
Sure Personal Financial Board
Integrate your Sure personal financial board to retrieve account reports and balances via API.
Stoic Quotes Skill
An AI agent skill designed to deliver curated Stoic philosophy quotes to provide wisdom, resilience, and perspective on demand.
AI Usage
A comprehensive monitoring tool to track AI quota, token consumption, and estimated costs across Anthropic and other providers.
Doubao Chat
A free AI conversational skill leveraging the Doubao large model with integrated real-time internet search capabilities.
Brave Search MCP Server
A privacy-focused Model Context Protocol server that empowers AI agents with comprehensive web, image, news, and local search capabilities without tracking.
PayRam Crypto Payments for SaaS
Enable USDC-based subscriptions, usage billing, and automated invoicing for SaaS products using the PayRam MCP server.
METADATA
Featured*
