什么是 Grok T@witter 搜索？

Grok T@witter 搜索是专为 Openclaw Skills 生态系统设计的先进检索技能，利用了 xAI 的 grok-4-1-fast 和 reasoning 模型。它通过使用原生的 x_search 工具执行语义搜索而非简单的关键词匹配，弥合了原始社交数据与可操作情报之间的鸿沟。这种方法允许用户找到高度相关的内容，有效过滤噪音，并理解趋势背后的背景。

该技能在设计时考虑了开发人员的效率，内置了对 SOCKS5 和 WARP 代理的支持，确保无论区域网络限制如何都能保持可靠连接。通过集成此技能，开发人员可以以每千次调用约 2.8 美元的价格访问实时 T@witter 数据，与传统 API 级别相比具有显著的成本优势，同时获得更出色的自然语言理解能力。

下载入口:https://github.com/openclaw/skills/tree/main/skills/tech-melon/grok-twitter-search

安装与下载

1. ClawHub CLI

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

2. 手动安装

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

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

3. 提示词安装

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

Grok T@witter 搜索 应用场景

• 实时舆情坚控和品牌提及跟踪。
• 市场研究和情感分析的自动化数据收集。
• 使用自然语言查询而非复杂的布尔运算符对特定推文进行语义发现。
• 坚控特定技术或利基社区内的热门话题和趋势讨论。

1. 用户通过命令行或智能体界面提供自然语言搜索查询。
2. 技能根据需求在追求速度的 Fast 引擎或追求深度分析的 Reasoning 引擎之间动态选择。
3. 执行连接检查，自动检测本地 WARP 服务或配置的 SOCKS5 代理。
4. 请求发送至 xAI 的 Grok 模型，模型执行 x_search 工具扫描 T@witter 的实时索引。
5. 解析原始 LLM 输出以提取纯 JSON 数据，去除对话赘余以便于集成。

Grok T@witter 搜索 配置指南

在 Openclaw Skills 环境中开始使用此技能的最简单方法是通过交互式安装脚本：

uv run scripts/setup_interactive.py

或者，您可以通过设置 xAI API 密钥和可选的代理设置来手动配置环境：

export GROK_API_KEY="your_api_key_here"
# 可选：针对访问受限环境的代理
export SOCKS5_PROXY="socks5://127.0.0.1:40000"

Grok T@witter 搜索 数据架构与分类体系

该技能返回包含推文元数据和使用统计信息的结构化 JSON 对象。这使其非常适合将数据通过管道传输到其他 Openclaw Skills 进行进一步处理。

name: grok-twitter-search description: 使用 xAI Grok 模型的 x_search 工具智能搜索 T@witter 内容。首创 Fast/Reasoning 双引擎动态路由，支持 SOCKS5 代理（WARP）精准流量分流。相比官方 X API 成本呈断崖式下降（实测约 $2.8/千次），语义理解更强、结果更智能。当用户需要搜索X、坚控舆情、分析热点话题、获取实时推文数据时使用此技能。 metadata: { "openclaw": { "emoji": "??", "homepage": "https://github.com/your-repo/grok-twitter-search", "requires": { "bins": ["uv", "curl"], "env": ["GROK_API_KEY"] }, "primaryEnv": "GROK_API_KEY", }, }

Grok T@witter Search Skill

基于 xAI grok-4-1-fast 与 grok-4-1-fast-reasoning 双擎驱动的X原生数据检索引擎。

核心优势

快速开始

方式 1: 交互式配置（推荐首次使用）

uv run {baseDir}/scripts/setup_interactive.py

这个向导会引导你完成：

• ? 检查系统依赖 (uv, curl)
• ? 检测 WARP 代理状态
• ? 配置 Grok API Key
• ? 选择代理模式
• ? 测试连接
• ? 自动保存配置到 openclaw.json

方式 2: 手动配置

如果你更喜欢手动配置，可以继续阅读下面的详细说明。

使用方法

建议使用 uv 运行以保证依赖隔离与环境纯净：

极速检索模式（默认，超低成本）

uv run {baseDir}/scripts/search_twitter.py --query "{搜索内容}" --max-results 10

深度舆情分析模式（调用 Reasoning 模型）

uv run {baseDir}/scripts/search_twitter.py --query "{搜索内容}" --max-results 10 --analyze

参数说明

代理配置（WARP 智能检测）

本技能支持三种代理配置方式，优先级从高到低：

1. 显式配置（最高优先级）

在 ~/.openclaw/openclaw.json 中设置：

{
  skills: {
    entries: {
      "grok-twitter-search": {
        enabled: true,
        env: {
          SOCKS5_PROXY: "socks5://127.0.0.1:40000",
          GROK_API_KEY: "your_api_key_here"
        }
      }
    }
  }
}

2. 环境变量

export SOCKS5_PROXY="socks5://127.0.0.1:40000"
export GROK_API_KEY="your_api_key_here"

3. 自动检测（默认行为）

脚本会自动检测 WARP 代理：

• 检查 warp-svc 进程是否在运行
• 检查端口 40000 是否在
• 如果检测到 WARP，自动使用 socks5://127.0.0.1:40000
• 如果未检测到代理但直连可用，则直连访问

检查 WARP 状态

bash {baseDir}/scripts/check_warp.sh

输出格式 (纯净提取)

引擎剥离了冗余的 LLM 文本，直接返回原生 Tool Call 拦截数据：

{
  "status": "success",
  "query": "elon musk",
  "tweets": [
    {
      "author": "@elonmusk",
      "content": "推文内容...",
      "timestamp": "2026-02-26T10:00:00Z",
      "likes": 1234,
      "retweets": 567,
      "url": "https://x.com/elonmusk/status/123..."
    }
  ],
  "model_used": "grok-4-1-fast-reasoning",
  "x_search_calls": 1,
  "usage": {
    "input_tokens": 1250,
    "output_tokens": 45,
    "total_tokens": 1295
  }
}

真实成本估算 (实测数据)

基于实测数据：200 次调用耗费 $0.56，即约 $2.8/千次

故障排查

检查环境配置

bash {baseDir}/scripts/check_warp.sh

常见问题

Q: 提示 "缺少 API Key"

• 确保已设置 GROK_API_KEY 环境变量或在 openclaw.json 中配置

Q: 连接超时或无法访问 api.x.ai

• 检查 WARP 是否运行：sudo systemctl status warp-svc
• 手动测试代理：curl --socks5 127.0.0.1:40000 https://api.x.ai/v1
• 如在中国大陆，必须使用 WARP 或其他出海代理

Q: 返回空结果

• 检查查询词是否过于具体或敏感
• 尝试简化查询或使用英文关键词