Bird Twitter
/install bird-twitter
Bird Twitter Skill 🐦
Fast Twitter/X CLI wrapper using bird — post tweets, reply, read, search, and manage your timeline via Twitter's GraphQL API.
Required Environment Variables
export AUTH_TOKEN=\x3Cyour_twitter_auth_token>
export CT0=\x3Cyour_twitter_ct0_cookie>
How to Get Tokens
- Log in to Twitter/X in your browser
- Open Developer Tools (F12)
- Go to Application/Storage → Cookies → twitter.com
- Copy:
auth_token→AUTH_TOKENct0→CT0
Quick Usage
# Check login status
bird whoami
# Check credential availability
bird check
# Post a tweet
bird tweet "Hello from bird-twitter skill!"
# Reply to a tweet
bird reply \x3Ctweet-id-or-url> "Great thread!"
# Read a tweet
bird read \x3Ctweet-id-or-url>
# Read with JSON output
bird read \x3Ctweet-id-or-url> --json
# Search tweets
bird search "query"
# Get home timeline
bird home
# Get mentions
bird mentions
# Get liked tweets
bird likes
# Follow a user
bird follow \x3Cusername>
# Get user's tweets
bird user-tweets \x3Chandle>
# Get trending topics
bird news
bird trending
Commands
Posting
| Command | Description |
|---|---|
bird tweet \x3Ctext> |
Post a new tweet |
bird reply \x3Curl> \x3Ctext> |
Reply to a tweet |
bird tweet \x3Ctext> --media \x3Cpath> |
Tweet with media (up to 4 images or 1 video) |
Reading
| Command | Description |
|---|---|
bird read \x3Curl> |
Read/fetch a tweet |
bird thread \x3Curl> |
Show full conversation thread |
bird replies \x3Curl> |
List replies to a tweet |
bird user-tweets \x3Chandle> |
Get user's tweets |
Timelines
| Command | Description |
|---|---|
bird home |
Home timeline ("For You" feed) |
bird mentions |
Tweets mentioning you |
bird likes |
Your liked tweets |
bird bookmarks |
Your bookmarked tweets |
Search & Discovery
| Command | Description |
|---|---|
bird search \x3Cquery> |
Search tweets |
bird news |
AI-curated news from Explore |
bird trending |
Trending topics |
Account Management
| Command | Description |
|---|---|
bird whoami |
Show logged-in account |
bird check |
Check credential availability |
bird follow \x3Cuser> |
Follow a user |
bird unfollow \x3Cuser> |
Unfollow a user |
bird followers |
List your followers |
bird following |
List users you follow |
bird lists |
Your Twitter lists |
Output Options
| Option | Description |
|---|---|
--json |
JSON output |
--json-full |
Include raw API response |
--plain |
Plain text (no emoji, no color) |
--no-emoji |
Disable emoji |
--no-color |
Disable ANSI colors |
--timeout \x3Cms> |
Request timeout |
Configuration
Reads from:
~/.config/bird/config.json5./.birdrc.json5
Supports: chromeProfile, firefoxProfile, cookieTimeoutMs, timeoutMs, quoteDepth
Environment Variables
| Variable | Description |
|---|---|
AUTH_TOKEN |
Required — Twitter auth_token cookie |
CT0 |
Required — Twitter ct0 cookie |
NO_COLOR |
Disable colors |
BIRD_TIMEOUT_MS |
Default timeout |
BIRD_COOKIE_TIMEOUT_MS |
Cookie extraction timeout |
BIRD_QUOTE_DEPTH |
Max quoted tweet depth |
Examples
# Check who's logged in
bird whoami
# Post a simple tweet
bird tweet "Hello world from OpenClaw!"
# Post with an image
bird tweet "Check this out!" --media ./image.png
# Reply to a tweet
bird reply 1234567890123456789 "Thanks for sharing!"
# Search for tweets about AI
bird search "artificial intelligence" --json
# Get your home timeline
bird home -n 20
# Read a tweet thread
bird thread https://x.com/user/status/1234567890
# Get trending topics
bird trending
Troubleshooting
401 Unauthorized
Check that AUTH_TOKEN and CT0 are set and valid. Run bird check to verify.
Token Expired
Twitter tokens expire periodically. Re-copy from browser cookies.
Rate Limited
Twitter GraphQL API has rate limits. Wait a few minutes and retry.
TL;DR: Fast Twitter/X CLI via bird. Set AUTH_TOKEN and CT0, then tweet, read, search, and manage your timeline!
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install bird-twitter - 安装完成后,直接呼叫该 Skill 的名称或使用
/bird-twitter触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Bird Twitter 是什么?
Twitter/X CLI wrapper using bird — post tweets, reply, read, search, and manage your timeline. Fast GraphQL-based X CLI. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 2928 次。
如何安装 Bird Twitter?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install bird-twitter」即可一键安装,无需额外配置。
Bird Twitter 是免费的吗?
是的,Bird Twitter 完全免费(开源免费),可自由下载、安装和使用。
Bird Twitter 支持哪些平台?
Bird Twitter 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Bird Twitter?
由 chuhuilove(@chuhuilove)开发并维护,当前版本 v1.0.0。