介绍
通过附带的脚本（搜索 + 聊天 + 模型列表）在本地运行 xAI Grok。默认的搜索输出为带有引用的 *JSON 格式*（适合代理使用）。
## API key
脚本按以下顺序查找 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 "<query>" --web`
- X/Twitter 搜索 (JSON)： - `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`
## 实用标志
输出： - `--links-only` 仅打印引用 URL - `--text` 在美化输出中隐藏引用部分 - `--raw` 在 stderr 上包含原始 Responses API 载荷（调试）
通用： - `--max <n>` 限制结果数量（默认 8） - `--model <id>` （默认 `grok-4-1-fast`）
X 独有筛选器（通过 x_search 工具参数在服务端执行）： - `--days <n>` （例如 7） - `--from YYYY-MM-DD` / `--to YYYY-MM-DD` - `--handles @a,@b` （限制在这些账号） - `--exclude @bots,@spam` （排除账号）
## 输出格式 (JSON)
```json { "query": "...", "mode": "web" | "x", "results": [ { "title": "...", "url": "...", "snippet": "...", "author": "...", "posted_at": "..." } ], "citations": ["https://..."] } ```
## 注意事项
- `citations` 在可能的情况下从 xAI 响应注解中合并/验证（比盲目信任模型的 JSON 更可靠）。 - 推文/帖子优先使用 `--x`，一般研究优先使用 `--web`。