Grok搜索工具

技能简介

通过xAI Responses API调用Grok的服务端搜索工具（web_search、x_search），获取网页内容或X/Twitter的推文、话题和用户数据。支持结构化JSON输出并附带引用来源，可作为Brave等搜索引擎的替代方案。

能做什么

• 搜索网页内容，返回带引用的结构化结果
• 搜索X/Twitter的推文、话题串和用户信息
• 与Grok模型进行文本对话或视觉问答
• 列出可用的xAI模型列表
• 按时间范围、指定账号、排除账号等条件过滤X搜索结果

使用说明

安装准备

需安装Node.js环境，并配置xAI API密钥。密钥查找顺序：环境变量XAI_API_KEY → ~/.clawdbot/clawdbot.json中的env字段 → 同文件skills.entries配置项。

执行命令

使用{baseDir}确保命令在不同工作目录下均可运行：

• 网页搜索：node {baseDir}/scripts/grok_search.mjs "查询内容" --web
• X/Twitter搜索：node {baseDir}/scripts/grok_search.mjs "查询内容" --x
• 文本对话：node {baseDir}/scripts/chat.mjs "提示词"
• 视觉对话：node {baseDir}/scripts/chat.mjs --image /路径/图片.jpg "提示词"
• 列出模型：node {baseDir}/scripts/models.mjs

常用参数

• --max <n>：限制结果数量（默认8条）
• --model <id>：指定模型（默认grok-4-1-fast）
• --days <n>：X搜索限定近n天
• --from/--to YYYY-MM-DD：X搜索日期范围
• --handles @a,@b：X搜索限定指定账号
• --exclude @bots,@spam：X搜索排除指定账号
• --links-only：仅输出引用链接
• --raw：调试模式输出原始API响应

输入与输出

见下方输入与输出表格。

风险提示

• API密钥需妥善保管，避免泄露到版本控制或日志中
• X/Twitter搜索结果受平台政策和内容可用性影响
• 引用链接由xAI响应注解合并验证，但仍需人工复核关键信息
• 免费额度用尽后可能产生API调用费用

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/notabhay/grok-search/SKILL.md
来源类型：GitHub仓库