install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/bubblyjove/falcon" ~/.claude/skills/openclaw-skills-falcon && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/bubblyjove/falcon" ~/.openclaw/skills/openclaw-skills-falcon && rm -rf "$T"
manifest:
skills/bubblyjove/falcon/SKILL.mdsource content
falcon
Use falcon to read, search, and interact with Twitter/X.
Quick start
falcon check falcon user elonmusk falcon tweets elonmusk 5 falcon read <url-or-id> falcon search "bitcoin" 10
Reading users
falcon user <username> Profile info for a single user falcon users <u1,u2,...> Look up multiple users (comma-separated) falcon find <keyword> [count] Search for users by keyword (default: 5) falcon followers <username> [count] List followers (default: 20) falcon following <username> [count] List following (default: 20)
Reading tweets
falcon tweets <username> [count] User's tweets and replies (default: 20) falcon read <id-or-url> [...] Read one or more tweets by ID or URL falcon replies <id-or-url> [count] Replies to a tweet (default: 20) falcon similar <id-or-url> Find similar tweets falcon retweeters <id-or-url> [cnt] Who retweeted a tweet (default: 20)
Searching
falcon search <query> [count] Advanced search (default: 10) falcon hashtag <tag> [count] Search by hashtag (default: 20) falcon cashtag <tag> [count] Search by cashtag (default: 20) falcon trending [country] Trending topics (default: worldwide)
Posting (confirm with user first)
falcon tweet "text" falcon reply <id-or-url> "text" falcon quote <tweet-url> "text"
Engagement (confirm with user first)
falcon like <id-or-url> falcon unlike <id-or-url> falcon retweet <id-or-url> falcon bookmark <id-or-url> falcon follow <username> falcon unfollow <username>
Account
falcon check Verify API key and cookie are set falcon balance Check remaining API credits
Auth sources
TWEXAPI_KEY env var: TwexAPI bearer token (required for all commands) TWITTER_COOKIE env var: Twitter auth cookie (required for write/engagement commands)
Important notes
- The falcon script lives at {baseDir}/falcon.sh - All commands accept tweet URLs (x.com or twitter.com) or bare tweet IDs - Always confirm with the user before executing any write or engagement command - Search accepts any Twitter advanced search syntax - Hashtags can be passed with or without the # prefix - Cashtags can be passed with or without the $ prefix - Country for trending uses slug format: united-states, united-kingdom, japan, etc.