← 返回 Skills 市场
chuhuilove

Bird Twitter

作者 chuhuilove · GitHub ↗ · v1.0.0
cross-platform ✓ 安全检测通过
2928
总下载
9
收藏
27
当前安装
1
版本数
在 OpenClaw 中安装
/install bird-twitter
功能描述
Twitter/X CLI wrapper using bird — post tweets, reply, read, search, and manage your timeline. Fast GraphQL-based X CLI.
使用说明 (SKILL.md)

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

  1. Log in to Twitter/X in your browser
  2. Open Developer Tools (F12)
  3. Go to Application/Storage → Cookies → twitter.com
  4. Copy:
    • auth_tokenAUTH_TOKEN
    • ct0CT0

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!

安全使用建议
This skill appears coherent and small, but before installing: (1) only use a bird binary from a trusted source (verify upstream repo/releases), (2) treat AUTH_TOKEN and CT0 like full-account credentials — do not paste them into untrusted places or share them, and consider using a secondary account if you fear automation mistakes, (3) follow the SKILL.md cookie extraction instructions carefully to avoid copying unrelated cookies, (4) be aware the agent can call the skill autonomously by default (allowing it to post tweets), so consider disabling autonomous invocation or restricting the agent if you want manual control.
功能分析
Type: OpenClaw Skill Name: bird-twitter Version: 1.0.0 The skill bundle is a transparent wrapper for the `bird` CLI tool, designed to interact with the Twitter/X API. It explicitly declares its need for `AUTH_TOKEN` and `CT0` environment variables in `SKILL.md` and `_meta.json`, and the `lib/bird-helper.sh` script validates their presence before executing the `bird` command. The script safely passes arguments using `bird "$@"`, preventing simple shell injection. There is no evidence of data exfiltration, persistence mechanisms, obfuscation, or malicious prompt injection attempts in the `SKILL.md` file. The skill's functionality aligns with its stated purpose of providing a Twitter CLI interface.
能力评估
Purpose & Capability
Name/description, required binary (bird), and required env vars (AUTH_TOKEN, CT0) all align: a CLI wrapper for Twitter/X legitimately needs a bird binary and Twitter auth cookies.
Instruction Scope
SKILL.md instructs the user to extract auth_token and ct0 from browser cookies — this is coherent with the declared env vars, but copying browser cookies is sensitive and could lead non-technical users to expose credentials if done carelessly. The included helper script only validates env vars and forwards arguments to bird; it does not access other files or external endpoints.
Install Mechanism
No install spec; this is an instruction-only skill that assumes a preinstalled 'bird' binary. The small included shell wrapper is harmless and merely checks environment variables then invokes bird.
Credentials
The skill requires only AUTH_TOKEN and CT0, which are exactly the credentials needed to authenticate to Twitter via the bird CLI. Those cookies grant full account capabilities (posting, following, etc.), so they should be treated as highly sensitive.
Persistence & Privilege
always is false and there is no install that persists code beyond the included script; the skill does not modify other skills or system config. Note: disable-model-invocation is false (platform default), so the agent could call the skill autonomously unless you change that setting.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install bird-twitter
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /bird-twitter 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release - Twitter/X CLI wrapper using bird
元数据
Slug bird-twitter
版本 1.0.0
许可证
累计安装 27
当前安装数 27
历史版本数 1
常见问题

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。

💬 留言讨论