Discrawl
Supercharge Your OpenClaw Discord Agent
Local SQLite mirror for instant server-wide search
The Problem
- Discord's built-in search is slow and limited
- API rate limits restrict automation
- No support for complex queries
- Poor context retrieval for AI agents
What is Discrawl?
- CLI tool by Peter Steinberger (OpenClaw creator)
- Mirrors entire Discord server into SQLite
- FTS5 full-text search for instant queries
- Offline access to complete server history
Key Features
- Fast local search with no API limits
- SQL-powered analytics and reporting
- Full support for threads, attachments, mentions
- Real-time sync via Discord Gateway tail
- Incremental updates for efficiency
Benefits for OpenClaw Users
- Faster context retrieval for agent responses
- Richer, more accurate answers from historical data
- Offline access when Discord API is unavailable
- Complex queries: trends, analytics, patterns
- No rate limit worries
Real-World Use Case
OpenClaw Discord Analysis
- 660,000+ messages crawled
- ~4GB SQLite database
- Analyze user pain points and feature requests
- Identify common issues and patterns
- Prioritize fixes based on real community data
Built by the creator to understand his own community better.
How It Works
- Use your Discord bot token (same as OpenClaw)
- Crawl server history → SQLite database
- FTS5 indexing for instant full-text search
- Live Gateway tail keeps database in sync
discrawl crawl --guild-id YOUR_GUILD_ID
discrawl tail --guild-id YOUR_GUILD_ID
Setup Steps
- Install Discrawl CLI
- Crawl your Discord server
- Connect SQLite database to OpenClaw agent
- Run periodic syncs (or live tail)
npm install -g discrawl
discrawl crawl --guild-id 123456789
# Point OpenClaw to ./discord.db
Architecture
Real-Time
Live Discord ↔ OpenClaw
Instant responses, current state
Historical
Discrawl SQLite ↔ OpenClaw
Deep context, analytics, trends
Best of both worlds
Use Cases
- Answer questions about past discussions
- Analyze community trends and sentiment
- Extract structured data from conversations
- Feed rich historical context to agents
- Generate reports and insights
- Track feature requests over time
Getting Started
- GitHub:
github.com/steipete/discrawl
- Requirements: Discord bot token, Message Content Intent
- Output: SQLite database with FTS5 search
- Integration: Point OpenClaw to the database path
# Install
npm install -g discrawl
# Crawl
discrawl crawl --guild-id YOUR_GUILD_ID
# Tail (live sync)
discrawl tail --guild-id YOUR_GUILD_ID
Summary
- Local SQLite = faster, more powerful queries
- No API rate limits or throttling
- Better historical context for agents
- Built by OpenClaw creator for OpenClaw users
- Open source and actively maintained
github.com/steipete/discrawl