A powerful add-on for the Bird tool that enables AI agents to list, read, and manage X/Twitter direct message conversations.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install bird-dms
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-dms 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 DM?
Bird DM is a dedicated extension for the bird utility, specifically engineered to provide programmatic access to X/Twitter direct messages. This skill empowers AI agents to interact with a user's DM inbox, making it possible to fetch conversation lists and retrieve detailed message histories. By integrating this into Openclaw Skills, developers can create automated workflows that monitor social communications without manual browser intervention.
The tool focuses on efficiency and developer experience, offering both human-readable terminal output and structured data formats. It relies on existing authentication sessions, ensuring that security and session management are handled consistently with the base bird ecosystem.
Bird DM Use Cases
- Monitoring X/Twitter inboxes for urgent client or community direct messages.
- Automating the retrieval of conversation history for specific user threads.
- Exporting DM data into JSON for integration with external analysis tools using Openclaw Skills.
- Summarizing recent social media interactions within a unified developer dashboard.
How Bird DM Works
- The skill leverages the browser cookies and session data already established via the base bird installation.
- Users or agents invoke the
bird-dm inboxcommand to pull a list of recent conversation threads and their unique identifiers. - Individual message content is accessed by passing a specific conversation ID to the
bird-dm readcommand. - Parameters such as
-ncan be used to control the volume of data retrieved per request. - Structured JSON output can be requested for seamless integration with other Openclaw Skills.
Bird DM Setup
First, ensure you have Node.js installed on your system. Install the package globally using npm:
npm install -g bird-dm
Because this skill shares authentication with bird, you must verify your session before use:
bird check
Bird DM Data Schema & Taxonomy
Bird DM organizes Twitter data into two primary structures: Conversations and Messages.
| Component | Data Type | Description |
|---|---|---|
| ID | String | The unique hyphenated identifier for a DM thread |
| Participants | Array | Handles of the users involved in the conversation |
| Snippet | String | The most recent message text in a conversation list |
| Timestamp | Date | The localized date and time of the message |
| JSON Output | Object | Detailed schema including sender IDs and full message metadata |
All commands support the --json flag to facilitate machine-readable workflows within Openclaw Skills.
Bird DM Advanced Features
- Support for high-volume message retrieval with custom limits up to 100 messages.
- Full JSON output support for every command to enable advanced parsing.
- Multi-user group chat compatibility for reading complex threads.
- Native session synchronization with bird to maintain persistent authentication without re-logging.
- Seamless integration capabilities for larger automated agents powered by Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Google Video URL Analysis
Analyze public video URLs directly with Google Gemini models for instant summarization and data extraction.
Exa MCP Web Search
A powerful research skill that integrates Exa MCP for targeted web discovery and person-centric data retrieval.
SwiftScholar Skill
A comprehensive research integration for searching academic databases, parsing PDFs, and generating structured markdown analyses of scientific papers.
OPC (One-Person Company) Framework
A comprehensive 14-skill AI agent framework designed to help solo entrepreneurs manage the entire business lifecycle from ideation to operations.
Promptify
Promptify is an advanced prompt engineering skill that transforms unstructured user input into clear, structured, and context-aware prompts.
Promptify
Promptify is an intelligent prompt engineering utility that transforms unstructured user input into clear, structured, and effective AI instructions.
Featured*
