A comprehensive X/Twitter CLI and SDK leveraging GraphQL and cookie-based authentication for full platform engagement and automation.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install hume-x
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 hume-x 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 hume-x?
hume-x is a robust command-line interface and SDK designed for deep interaction with X (formerly Twitter). By utilizing GraphQL endpoints and cookie-based authentication, it bypasses traditional API limitations to provide full coverage for tweets, timelines, and social engagement. As a standout entry in the Openclaw Skills library, it allows developers to script complex social workflows, from media-rich posting to advanced thread reading, all from a terminal or automated environment.
The tool is engineered with curl-impersonate to ensure reliable requests and mimics legitimate browser behavior to maintain connection stability. Whether you are building automated bots or managing professional accounts, this skill provides the programmatic access necessary for modern social media operations.
hume-x Use Cases
- Automating content distribution and scheduled tweets for social media management.
- Building custom monitoring dashboards by searching and fetching real-time mentions.
- Developing AI-driven engagement bots that reply to or quote specific threads based on triggers.
- Archiving bookmarks, likes, or user timelines for data analysis and research.
- Managing large-scale social accounts using proxy support and multi-token configuration.
How hume-x Works
- The user provides authentication credentials via CLI flags, environment variables, or a local configuration file.
- hume-x automatically scrapes and caches GraphQL query IDs from the platform to ensure compatibility with the current X interface.
- Requests are dispatched using specialized HTTP clients to handle security layers and rate limits effectively.
- Users execute commands for posting, searching, or engagement, which are translated into optimized GraphQL queries.
- Data is returned in plain text or structured JSON format, making it easy to integrate into broader Openclaw Skills workflows.
hume-x Setup
To get started with hume-x, ensure you have Node.js installed and then install the package globally using npm:
npm install -g @humebio/hume-x
Verify your authentication status by running the check command:
hume-x check
You can configure your environment variables X_AUTH_TOKEN and X_CT0 or use the configuration file at ~/.config/hume-x/config.json to enable persistent access.
hume-x Data Schema & Taxonomy
The skill manages data through structured JSON outputs and a local configuration cache to optimize performance and reliability. Below is the primary data organization:
| Component | Description |
|---|---|
| Config File | Located at ~/.config/hume-x/config.json for persistent authentication storage. |
| Query Cache | Auto-scraped GraphQL IDs with a 24-hour expiration cycle to prevent 404 errors. |
| API Responses | Available in parsed JSON or raw response formats for downstream processing. |
| Media Handling | Supports chunked uploads for large video files, GIFs, and images with alt-text. |
hume-x Advanced Features
- Cursor-based pagination for fetching deep historical timelines and extensive search results.
- Full proxy support (HTTPS/SOCKS5) for distributed automation and privacy-conscious tasks.
- Integration-ready JSON output modes designed specifically for piping data into tools like jq.
- Multi-account management through flexible credential resolution and environment switching.
- Scheduled tweet capabilities to manage future content releases programmatically without manual intervention.
SKILL.md
Loading
Related Openclaw Skills
Raindrop Bookmark Sync
Sync and automate the ingestion of Raindrop.io bookmarks into your AI-driven knowledge base using Openclaw Skills.
PR Triage
An AI-powered pull request assistant that identifies duplicate submissions, scores contribution quality, and generates prioritized triage reports.
Interesting Finding Link Digest
An automated workflow that transforms shared Discord links into analyzed summaries and structured local knowledge base entries.
Interesting Finding
An automated workflow that transforms shared Discord links into structured, categorized knowledge base entries with AI-generated summaries.
HiDPI Mouse Click Handler
A specialized Linux automation tool that translates AI-perceived screen coordinates into precise HiDPI hardware clicks.
SearXNG Search
A privacy-focused web search skill that connects AI agents to SearXNG instances using the Model Context Protocol.
Featured*
