Grok Swarm Tool
Dual-Platform: OpenClaw + Claude Code
Give any AI coding agent access to Grok 4.20's 4-agent swarm with ~2M token context.
The Story
You've been building with AI coding agents for a while now. They're great — they can write features, refactor modules, analyze codebases. But there's always been this ceiling. The models they run on are designed for single-turn conversations.
Enter Grok 4.20 Multi-Agent Beta.
It's different. Instead of one model responding, it's four agents coordinating in real-time. An orchestrator, specialists, critics — all working together to break down your request and reason through it from multiple angles. It can hold ~2M tokens of context — that's entire codebases in a single request.
The Problem:
Grok 4.20 is groundbreaking, but it doesn't play nicely with current coding tools. Claude Code doesn't have a Grok integration. OpenClaw's tooling system doesn't support multi-agent swarms. If you wanted to use Grok, you'd have to hack together custom scripts or modify your platform's core components. Not ideal.
The Solution:
This plugin bridges that gap. It makes Grok 4.20 available as a tool that any agent in Claude Code or OpenClaw can call. No core modifications, no hacking — just install and go.
Now when your agent needs deep codebase analysis, large-scale refactoring, or complex reasoning, it can delegate to Grok's swarm and get back the kind of coordinated, multi-perspective thinking that single models can't deliver.
Features
- 4-Agent Swarm — Grok 4.20 coordinates multiple agents for deeper analysis
- Massive Context — ~2M token window, handles entire codebases
- Native MCP Server — Grok appears as a first-class tool in Claude Code
- Multi-Turn Sessions — Stateful conversations with Grok across multiple calls
- 5 Modes — Analyze, Refactor, Code, Reason, Orchestrate
- Tool Passthrough — Pass OpenAI-format tool schemas for function calling
- File Writing — Write annotated code blocks directly to disk
- Dual Platform — Works with both Claude Code and OpenClaw
File Writing
When write_files=true, Grok parses code blocks for filename annotations and writes them directly to disk, returning only a compact summary instead of the full response.
Supported Patterns
Fenced code blocks with path in the language tag:
```typescript:src/auth/login.ts
export function login() { ... }
```
Fenced code blocks with // FILE: marker:
```typescript
// FILE: src/auth/login.ts
export function login() { ... }
```
Example
const result = await tools.grok_swarm({
prompt: "Write a FastAPI auth module with JWT",
mode: "code",
write_files: true,
output_dir: "./src"
});
// Returns: "Wrote 3 files to ./src
// src/auth.py (1,234 bytes)
// src/jwt_utils.py (567 bytes)
// src/middleware.py (890 bytes)"
Why This Matters
Grok can generate ~350K token responses. Without file writing, that floods your orchestrator's context window. With file writing, you get a brief summary and the files on disk.
Requirements
- OpenClaw v2026.3.0+ (for OpenClaw integration)
- Python 3.8+
- Node.js 18+
- OpenRouter API key with Grok 4.20 access
Installation
Choose the method that fits your platform:
Option 1: NPM (Recommended — CLI Tool)
npm install -g @openclaw/grok-swarm
# Set up API key
./scripts/setup.sh
Option 2: Claude Code Marketplace
# Add the marketplace
/plugin marketplace add https://github.com/KHAEntertainment/grok-multiagent-plugin
# Install the plugin
/plugin install grok-swarm@khaentertainment
Then run /grok-swarm:setup inside Claude Code — an OAuth browser flow will
authorize your OpenRouter account without exposing your API key in-context.
Option 3: ClawHub (OpenClaw)
clawhub install grok-swarm
Option 4: Git Clone
git clone https://github.com/KHAEntertainment/grok-multiagent-plugin.git
cd grok-multiagent-plugin
# Auto-detect and install
./install.sh
# Or install for specific platform
./install.sh claude # Claude Code only
./install.sh openclaw # OpenClaw only
./install.sh both # Both platforms
For detailed instructions for each method, see INSTALL.md.
Quick Start
For Claude Code
/grok-swarm:analyze Review the security of my auth module
/grok-swarm:refactor Convert these callbacks to async/await
/grok-swarm:code Write a FastAPI endpoint for user registration
/grok-swarm:reason Compare microservices vs monolith for this project
For OpenClaw
# After ClawHub or git install, add to openclaw.json:
openclaw gateway restart
Then use in your agent:
