用途:通过 xAI Responses API 调用 Grok 的 web_search 与 x_search 服务端工具,进行网络搜索或 X/Twitter 检索,并附带引用来源。适用于需要获取推文、话题串和用户信息的场景。
主要能力:提供搜索、聊天、视觉聊天和模型列表四类脚本。搜索默认输出适合程序处理的 JSON,并附带 citations;聊天支持文本与图片输入;--links-only 可只输出引用链接。
API Key 读取顺序:XAI_API_KEY 环境变量;~/.clawdbot/clawdbot.json 中的 env.XAI_API_KEY;同文件 skills.entries["grok-search"].apiKey;回退到 search-x 或 xai 的 apiKey。
用法示例:搜索网络 node {baseDir}/scripts/grok_search.mjs "<query>" --web;搜索 X node {baseDir}/scripts/grok_search.mjs "<query>" --x;聊天 node {baseDir}/scripts/chat.mjs "<prompt>";视觉 node {baseDir}/scripts/chat.mjs --image /path/to/image.jpg "<prompt>";列出模型 node {baseDir}/scripts/models.mjs。常用参数:--max、--model(默认 grok-4-1-fast),以及 X 专用的 --days、--from、--to、--handles、--exclude。
限制:需配置有效的 xAI API Key;默认使用英文查询,除非用户明确要求其他语言;资料未说明收费、价格及平台支持细节。