A specialized skill for AI agents to interact with X/Twitter by leveraging local Chrome cookies for authentication and a secure browser gateway for posting.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install bird-chrome
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 bird-chrome 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 bird-chrome?
bird-chrome is a powerful integration designed for Openclaw Skills that enables AI agents to interface with X/Twitter. By utilizing the bird CLI and existing Chrome browser sessions, it allows for seamless read-only operations like searching, reading threads, and monitoring mentions without requiring complex API keys.
To ensure account safety and bypass aggressive bot-detection algorithms, this skill employs a hybrid approach. It uses direct CLI commands for high-speed data retrieval while routing all write-actions—such as posting tweets and replies—through a dedicated browser gateway. This methodology provides a robust, human-like interaction pattern that minimizes the risk of account suspension.
bird-chrome Use Cases
- Monitoring brand mentions and community engagement in real-time.
- Researching specific topics or threads to provide summarized context to a user.
- Automating authenticated search queries to gather market intelligence.
- Safely replying to customer inquiries or engaging with specific posts via a controlled browser environment.
How bird-chrome Works
- The AI agent identifies a request related to X/Twitter and invokes the bird-chrome skill.
- For read operations, the skill executes bird CLI commands using local Chrome cookies for authentication.
- If query IDs are stale, the skill automatically refreshes them to maintain connection integrity.
- For write operations, the skill ignores direct CLI posting to avoid bot-detection and instead triggers the Openclaw Browser Gateway.
- The browser gateway opens an interactive session, navigates to the compose or reply URL, and performs the action with human-like interactions.
bird-chrome Setup
To install the core bird utility, use one of the following commands based on your environment:
# For macOS users via Homebrew
brew tap steipete/tap
brew install bird
# Or via NPM
npm install -g @steipete/bird
Ensure you are logged into X/Twitter in your Google Chrome browser using the Default profile. If you use a custom profile or a different Chromium-based browser (like Arc or Brave), identify the profile name or directory for configuration.
bird-chrome Data Schema & Taxonomy
The skill primarily processes and returns data in JSON or plain text formats. Below is how the output is typically structured for the agent:
| Command Type | Output Format | Purpose |
|---|---|---|
| read/thread | JSON | Detailed tweet metadata, author info, and content. |
| search | JSON | Array of tweet objects matching the query. |
| mentions | JSON | List of recent interactions involving the authenticated user. |
| whoami | Plain Text | Verification of current account and session validity. |
bird-chrome Advanced Features
- Multi-profile support for targeting specific Chrome, Arc, or Brave browser environments.
- Automated Query ID refreshing via the bird query-ids --fresh command to handle API changes.
- Interactive snapshotting through the Openclaw Browser Gateway for complex UI navigation.
- Built-in safety protocols that strictly prevent high-risk CLI write actions.
- Sandboxed session support with host browser control for secure, isolated environments.
SKILL.md
Loading
Related Openclaw Skills
Heikinashi Reference Tool
A comprehensive CLI-based reference tool for mastering Heikinashi charting, formulas, and financial compliance standards.
Candlestick Finance Reference
A comprehensive CLI-based reference tool for mastering financial candlestick patterns, strategies, and regulatory compliance.
Ultimate Horizontal Timeline Architect
An AI agent skill that detects project dates and milestones within text, automatically rendering them as highly polished, interactive HTML horizontal timelines.
Kling AI Video Assistant
An advanced AI video generation assistant specializing in Kuaishou's Kling AI platform for professional-grade video creation and cinematic effects.
VWAP Reference Tool
A specialized technical reference tool for implementing and analyzing Volume Weighted Average Price (VWAP) within financial workflows.
Einstein Research — Market Bubble Risk Detector
A quantitative, data-driven analysis tool that evaluates market bubble risk using the Minsky/Kindleberger framework to support objective investment decisions.
Featured*
