什么是 Search X？

Search X 利用 xAI API 和 Grok-4 模型，在 Openclaw Skills 生态系统内直接提供智能体搜索功能。它使用户能够从 X 平台获取实时数据，包括推文文本、用户账号、时间戳和用于引用的直接 URL。对于正在构建需要从社交媒体获取当前信息或进行情感分析的智能体的开发者来说，这项技能非常有价值。

通过集成 x_search 工具，Search X 超越了简单的 API 调用，提供细致的搜索结果，包括图像结果和结构化引用。这使得它成为任何使用 Openclaw Skills 监控社交趋势或研究特定主题的开发者工具包中不可或缺的补充。

下载入口:https://github.com/openclaw/skills/tree/main/skills/mvanhorn/search-x

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

Search X 应用场景

• 监控 X 上的突发新闻和实时趋势。
• 研究特定的用户账号或官方公告。
• 使用最近的推文数据对主题进行情感分析。
• 按日期范围或特定用户群过滤社交讨论。
• 通过直接引用和推文链接验证信息。

1. 用户提供查询或触发词，如“搜索 twitter”或“查找推文”。
2. 该技能使用 grok-4-1-fast 模型调用 xAI Responses API。
3. x_search 工具处理请求以查找相关的实时推文。
4. 根据时间（天数）或命令中提供的特定账号等参数过滤结果。
5. 该技能返回包含推文内容、作者信息和验证链接的结构化响应。

Search X 配置指南

要在 Openclaw Skills 框架中使用此技能，您需要配置您的 xAI API 密钥。

openclaw config set skills.entries.search-x.apiKey "xai-YOUR-KEY"

或者，您可以设置环境变量：

export XAI_API_KEY="xai-YOUR-KEY"

您可以在 xAI 控制台获取您的凭据。

Search X 数据架构与分类体系

该技能以结构化格式返回数据，主要关注推文对象。

name: search-x
version: "1.1.0"
description: Real-time X/Twitter search powered by Grok-4. Find tweets, trends, and discussions with citations. Grok-4.20 also returns image results alongside tweet citations.
author: mvanhorn
license: MIT
repository: https://github.com/mvanhorn/clawdbot-skill-search-x
homepage: https://docs.x.ai
triggers:
  - search x
  - search twitter
  - find tweets
  - what's on x about
  - x search
  - twitter search
metadata:
  openclaw:
    emoji: "??"
    requires:
      env:
        - XAI_API_KEY
    primaryEnv: XAI_API_KEY
    tags:
      - x
      - twitter
      - search
      - grok
      - real-time

Search X

Real-time X/Twitter search powered by Grok's x_search tool. Get actual tweets with citations.

Setup

Set your xAI API key:

openclaw config set skills.entries.search-x.apiKey "xai-YOUR-KEY"

Or use environment variable:

export XAI_API_KEY="xai-YOUR-KEY"

Get your API key at: https://console.x.ai

Commands

Basic Search

node {baseDir}/scripts/search.js "AI video editing"

Filter by Time

node {baseDir}/scripts/search.js --days 7 "breaking news"
node {baseDir}/scripts/search.js --days 1 "trending today"

Filter by Handles

node {baseDir}/scripts/search.js --handles @elonmusk,@OpenAI "AI announcements"
node {baseDir}/scripts/search.js --exclude @bots "real discussions"

Output Options

node {baseDir}/scripts/search.js --json "topic"        # Full JSON response
node {baseDir}/scripts/search.js --compact "topic"     # Just tweets, no fluff
node {baseDir}/scripts/search.js --links-only "topic"  # Just X links

Example Usage in Chat

User: "Search X for what people are saying about Claude Code" Action: Run search with query "Claude Code"

User: "Find tweets from @remotion_dev in the last week" Action: Run search with --handles @remotion_dev --days 7

User: "What's trending about AI on Twitter today?" Action: Run search with --days 1 "AI trending"

User: "Search X for Remotion best practices, last 30 days" Action: Run search with --days 30 "Remotion best practices"

How It Works

Uses xAI's Responses API (/v1/responses) with the x_search tool:

• Model: grok-4-1-fast (optimized for agentic search)
• Returns real tweets with URLs
• Includes citations for verification
• Supports date and handle filtering

Response Format

Each result includes:

• @username (display name)
• Tweet content
• Date/time
• Direct link to tweet

Environment Variables

• XAI_API_KEY - Your xAI API key (required)
• SEARCH_X_MODEL - Model override (default: grok-4-1-fast)
• SEARCH_X_DAYS - Default days to search (default: 30)