Skills xai

Name: xai
Author: openclaw

Chat with Grok models via xAI API. Supports Grok-3, Grok-3-mini, vision, and more.

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/blueberrywoodsym/x-ai" ~/.claude/skills/openclaw-skills-xai && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/blueberrywoodsym/x-ai" ~/.openclaw/skills/openclaw-skills-xai && rm -rf "$T"

manifest: skills/blueberrywoodsym/x-ai/SKILL.md

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.