grok-search

通过捆绑脚本本地运行 xAI Grok（搜索 + 聊天 + 模型列表）。搜索的默认输出是美观的 JSON（对代理友好）并带有引用。

API 密钥

脚本按以下顺序查找 xAI API 密钥：

• XAI_API_KEY环境变量
• ~/.clawdbot/clawdbot.json→env.XAI_API_KEY
• ~/.clawdbot/clawdbot.json→skills.entries["grok-search"].apiKey
• 备选方案：skills.entries["search-x"].apiKey或skills.entries.xai.apiKey

运行

使用{baseDir}这样无论工作空间布局如何，命令都能正常运行。

搜索

• 网络搜索（JSON）：

  • 执行 node {baseDir}/scripts/grok_search.mjs "<查询内容>" --web 命令进行网页搜索

• X/Twitter 搜索（JSON格式）：

  • 执行 node {baseDir}/scripts/grok_search.mjs "<查询内容>" --x 命令

聊天

• 聊天（纯文本）：

  • 执行 node {baseDir}/scripts/chat.mjs "<提示词>" 命令

• 聊天（视觉识别）：

  • 执行 node {baseDir}/scripts/chat.mjs --image /图像文件路径/图像文件.jpg "<提示词>" 命令

模型

• 列出模型：
  • 执行 node {baseDir}/scripts/models.mjs 命令

常用标志

输出：

• --links-only仅打印引用URL
• --text在美化输出中隐藏引用部分
• --raw在标准错误输出中包含原始Responses API负载（用于调试）

通用标志：

• --max <数量>限制结果数量（默认值 8）
• --model <模型ID>（默认grok-4-1-fast）

仅限X平台的筛选器（通过x_search工具参数在服务器端实现）：

• --days <n>（例如：7）
• --from 年-月-日/--to 年-月-日
• --handles @a,@b（限定于这些用户账号）
• --exclude @bots,@spam（排除这些用户账号）

输出格式（JSON）

{
  "query": "...",
  "mode": "web" | "x",
  "results": [
    {
      "title": "...",
      "url": "...",
      "snippet": "...",
      "author": "...",
      "posted_at": "..."
    }
  ],
  "citations": ["https://..."]
}

备注

• 引用信息在可能的情况下，会从xAI响应注释中合并/验证（这比盲目信任模型的JSON更可靠）。
• 对于推文/帖子串，建议使用--x，对于一般性研究，建议使用--web。