什么是 xAI Grok 集成？

此技能在您的本地环境与 xAI 的 Grok 系列模型之间搭建了桥梁。通过利用 Openclaw Skills，开发者可以利用 Grok-3 进行复杂推理，使用视觉模型进行图像分析，并使用独特的实时搜索功能直接从 X（原 Twitter）提取带引用的数据。它专为效率和速度而设计，提供多种模型变体以平衡性能和成本。

该集成专为需要的不止是静态 LLM 响应的开发者打造，在通过 Node.js 脚本保持轻量化占用的同时，确保能够访问最新的前沿模型。无论您是在自动化技术研究还是构建具备视觉能力的智能体，此工具都提供了连接到 xAI API 生态系统的必要挂钩。

下载入口:https://github.com/openclaw/skills/tree/main/skills/blueberrywoodsym/x-ai

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

xAI Grok 集成 应用场景

• 调用 Grok-3 执行复杂的技术或哲学推理任务。
• 使用专门的视觉模型分析视觉内容以进行图像理解。
• 利用实时 X 数据对时事或技术框架进行实时研究。
• 使用 mini 和 fast 模型变体将快速、高效的 AI 聊天集成到本地自动化流水线中。

1. 用户通过 CLI 或 AI 智能体界面，使用 grok 或 ask grok 等 Openclaw Skills 触发器提供提示或命令。
2. 技能识别请求的模型，如果在环境变量中未定义特定变体，则默认为 grok-3。
3. 对于搜索查询，专用搜索脚本利用 xAI Responses API 和 x_search 工具从 X 获取实时社交数据。
4. 对于视觉任务，本地图像经过验证并安全传输到 xAI 端点进行处理。
5. 响应（包括实时帖子的引用）以简洁、技术化的格式返回给用户。

xAI Grok 集成 配置指南

要在您的 Openclaw Skills 中开始使用此功能，请从 xAI 控制台获取 API 密钥并将其设置在您的环境中。

export XAI_API_KEY="xai-YOUR-KEY"

确保已安装 Node。您还可以选择设置默认模型：

export XAI_MODEL="grok-3"

xAI Grok 集成 数据架构与分类体系

name: xai
description: Chat with Grok models via xAI API. Supports Grok-3, Grok-3-mini, vision, and more.
homepage: https://docs.x.ai
user-invocable: true
disable-model-invocation: true
triggers:
  - grok
  - xai
  - ask grok
metadata:
  clawdbot:
    emoji: "??"
    primaryEnv: XAI_API_KEY
    requires:
      bins: [node]
      env: [XAI_API_KEY]

xAI / Grok

Chat with xAI's Grok models. Supports text and vision.

Setup

INSTALLATION AND USE INSTRUCTIONS

export XAI_API_KEY="xai-YOUR-KEY"

Get your API key at: https://console.x.ai

Commands

Chat with Grok

node {baseDir}/scripts/chat.js "What is the meaning of life?"

Use a specific model

node {baseDir}/scripts/chat.js --model grok-3-mini "Quick question: 2+2?"

Vision (analyze images)

node {baseDir}/scripts/chat.js --image /path/to/image.jpg "What's in this image?"

?? Search X/Twitter (Real-time!)

node {baseDir}/scripts/search-x.js "Remotion video framework"
node {baseDir}/scripts/search-x.js --days 7 "Claude AI tips"
node {baseDir}/scripts/search-x.js --handles @remotion_dev "updates"

Uses xAI Responses API with x_search tool for real X posts with citations.

List available models

node {baseDir}/scripts/models.js

Available Models

• grok-3 - Most capable, best for complex tasks
• grok-3-mini - Fast and efficient
• grok-3-fast - Optimized for speed
• grok-2-vision-1212 - Vision model for image understanding

Example Usage

User: "Ask Grok what it thinks about AI safety" Action: Run chat.js with the prompt

User: "Use Grok to analyze this image" (with attached image) Action: Run chat.js with --image flag

User: "What Grok models are available?" Action: Run models.js

API Reference

xAI API Docs: https://docs.x.ai/api

Environment Variables

• XAI_API_KEY - Your xAI API key (required)
• XAI_MODEL - Default model (optional, defaults to grok-3)

Security & Permissions

What this skill does:

• Sends chat prompts to xAI's API at api.x.ai
• Vision mode sends images to xAI for analysis
• scripts/models.js lists available models (read-only)

What this skill does NOT do:

• Does not read arbitrary local files — --image only accepts files with image extensions (.jpg, .jpeg, .png, .gif, .webp)
• Does not read config files or access the filesystem beyond the specified image path
• Does not store conversation history or logs
• Does not send credentials to any endpoint other than api.x.ai
• Cannot be invoked autonomously by the agent (disable-model-invocation: true)

Bundled scripts: scripts/chat.js (chat), scripts/models.js (list models), scripts/search-x.js (X search)

Review scripts before first use to verify behavior.