search-x 是通过 Grok 的 x_search 工具实现的实时 X/Twitter 搜索技能,可获取真实推文并附引用,用于查找特定话题的讨论、趋势和账号发言。
主要能力:支持按时间范围筛选(--days)、按账号包含或排除(--handles、--exclude),并提供多种输出选项:--json 输出完整 JSON、--compact 仅输出推文、--links-only 仅输出 X 链接。每条结果包含用户名与显示名、推文内容、日期时间和推文直达链接。
使用方式:先配置 xAI API 密钥,可执行 clawdbot config set skills.entries.search-x.apiKey "xai-YOUR-KEY",或设置环境变量 export XAI_API_KEY="xai-YOUR-KEY"。密钥在 https://console.x.ai 获取。基本搜索命令为 node {baseDir}/scripts/search.js "查询内容",可叠加时间、账号和输出参数。
底层原理:调用 xAI 的 Responses API(/v1/responses)并使用 x_search 工具,默认模型为 grok-4-1-fast。相关环境变量包括 XAI_API_KEY(必需)、SEARCH_X_MODEL(模型覆盖,默认 grok-4-1-fast)、SEARCH_X_DAYS(默认搜索天数,默认 30)。
适用场景:在对话中查询 X 上的实时讨论、追踪某话题近期趋势、检索指定账号一周内的推文等。
限制:必须提供 xAI API 密钥,搜索能力依赖 xAI 服务与所用模型;其余收费、配额与平台限制暂未提供。