名称： xai
描述： 通过 xAI API 与 Grok 模型对话。支持 Grok-3、Grok-3-mini、视觉模型等。
主页： https://docs.x.ai
user-invocable: true
disable-model-invocation: true
触发器：
- grok
- xai
- ask grok
元数据：
clawdbot:
emoji: "🤖"
primaryEnv: XAI_API_KEY
requires:
bins: [node]
env: [XAI_API_KEY]

xAI / Grok

与 xAI 的 Grok 模型进行对话。支持文本和视觉输入。

设置

export XAI_API_KEY="xai-YOUR-KEY"

获取 API 密钥：https://console.x.ai

命令

与 Grok 对话

node {baseDir}/scripts/chat.js "生命的意义是什么？"

使用指定模型

node {baseDir}/scripts/chat.js --model grok-3-mini "快速提问：2+2等于几？"

视觉分析（解析图片）

node {baseDir}/scripts/chat.js --image /path/to/image.jpg "这张图片里有什么？"

🔍 搜索 X/Twitter（实时！）

node {baseDir}/scripts/search-x.js "Remotion 视频框架"
node {baseDir}/scripts/search-x.js --days 7 "Claude AI 使用技巧"
node {baseDir}/scripts/search-x.js --handles @remotion_dev "最新动态"

使用 xAI Responses API 的 x_search 工具，获取带引用的真实 X 帖子。

列出可用模型

node {baseDir}/scripts/models.js

可用模型

• grok-3 - 能力最强，最适合复杂任务
• grok-3-mini - 快速高效
• grok-3-fast - 速度优化版
• grok-2-vision-1212 - 视觉模型，用于图像理解

使用示例

用户： “问问 Grok 对 AI 安全的看法”
操作： 使用提示词运行 chat.js

用户： “用 Grok 分析这张图片”（附带图片）
操作： 使用 --image 参数运行 chat.js

用户： “有哪些 Grok 模型可用？”
操作： 运行 models.js

API 参考

xAI API 文档：https://docs.x.ai/api

环境变量

• XAI_API_KEY - 你的 xAI API 密钥（必需）
• XAI_MODEL - 默认模型（可选，默认为 grok-3）

安全与权限

本技能的功能：
- 将聊天提示发送至 xAI 的 API 端点 api.x.ai
- 视觉模式会将图片发送至 xAI 进行分析
- scripts/models.js 列出可用模型（只读操作）

本技能不会执行的操作：
- 不会读取任意本地文件——--image 仅接受图片扩展名文件（.jpg、.jpeg、.png、.gif、.webp）
- 不会读取配置文件或访问指定图片路径之外的文件系统
- 不会存储对话历史或日志
- 不会将凭据发送至 api.x.ai 以外的任何端点
- 无法由代理自主调用（disable-model-invocation: true）

包含的脚本： scripts/chat.js（聊天）、scripts/models.js（列出模型）、scripts/search-x.js（X 搜索）

首次使用前请检查脚本以确认其行为。