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](https://claude.ai/public/artifacts/5bb1d4ca-68ef-4d74-900c-d14fefa5c094)

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

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

Security & Permissions

**What this skill does:**

**What this skill does NOT do:**

**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.