X Search for Openclaw

A powerful search tool that leverages the xAI Grok API to query and summarize real-time X (Twitter) posts with full citation support.

blueworldmarketing
v1.0.0
Apr 17, 2026
0
722
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install x-search-bwm

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install x-search-bwm 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 X Search?

X Search is a specialized tool designed to bridge the gap between AI agents and real-time social media data. By utilizing the xAI API, this skill allows users to perform deep searches across X (Twitter), retrieving not just raw data but summarized insights powered by Grok. It is a vital addition to the library of Openclaw Skills for developers needing live public sentiment, news, or trend analysis.

This skill is engineered for precision, allowing for complex filtering by user handles, date ranges, and media types. It ensures that any data retrieved is actionable and verifiable by providing direct citations and links to the original posts on X.

X Search Use Cases

  • Monitoring real-time trends and public sentiment regarding specific AI or technology launches.
  • Tracking mentions and updates from specific industry leaders or competitors using handle-based filtering.
  • Conducting historical research on social media discourse within specific date windows.
  • Gathering visual content or product demos by specifically searching for posts containing images or video.

How X Search Works

  1. The user provides a search query and optional parameters such as date ranges or handle filters.
  2. The skill authenticates with the xAI console using the provided XAI_API_KEY.
  3. The Grok-powered search engine processes the query to identify relevant posts and visual content.
  4. Results are summarized and formatted into a readable structure including post text, author metadata, and source URLs.
  5. The final output is returned to the agent or user with full citations for verification.

X Search Setup

To integrate this tool with your Openclaw Skills environment, follow these steps:

  1. Obtain an API key from the xAI Console.
  2. Configure your environment using one of the following methods:

Option A: Environment Variable

export XAI_API_KEY="xai-your-key-here"

Option B: Configuration File Update your ~/.openclaw/openclaw.json to include your credentials:

{
  "skills": {
    "x-search": {
      "env": { "XAI_API_KEY": "your-key" }
    }
  }
}
  1. Ensure Python 3 is installed as it is the required runtime for the search scripts.

X Search Data Schema & Taxonomy

The skill organizes its output to prioritize readability and attribution. Data is typically structured as follows:

Field Description
Content The summarized or raw text of the found posts.
Author Metadata regarding the X user who created the post.
Citations Direct links to the original X.com URL for each result.
Media Flags Status indicators for attached images or video content.

X Search Advanced Features

  • Targeted Filtering: Use --handles or --exclude to narrow down results to specific accounts or remove noise from the feed.
  • Temporal Precision: Narrow searches to exact timeframes using --from and --to YYYY-MM-DD parameters.
  • Multimedia Understanding: Enable the --images and --video flags to utilize Grok's vision capabilities for analyzing social media media.
  • Seamless Integration: Designed to work within the Openclaw Skills ecosystem as a standard tool for multi-agent workflows.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*