Mirror Discord guilds into local SQLite. Search server history without depending on Discord search. Bring a bot token, or read everything offline from a Git snapshot.
- discovers every guild a bot can access and syncs channels, threads, members, and message history into SQLite
- maintains FTS5 indexes for fast literal search; optional embeddings for semantic and hybrid recall
- imports classifiable Discord Desktop cache messages with
wiretap, including proven DMs under@me - downloads attachment media into the local cache and includes cached non-DM media as gzip-compressed Git snapshot files
- tails the Gateway for live updates with periodic repair sweeps
- publishes the archive as sharded NDJSON snapshots in a private Git repo so readers can search offline with no Discord credentials
- exposes read-only SQL, channel/member directories, mention queries, digests, and trend analytics
- New here? Read Install and run
discrawl init. - Already have a bot? Jump to
syncandsearch. - Just want to read a shared archive? Use
subscribefor Git snapshots, orsubscribe-cloudfor a Worker-fronted archive - no Discord token needed. - Need DM search?
wiretapimports local Discord Desktop cache. - Need multilingual lexical search? Configure language analyzers and run
lexical rebuild. - Want semantic search? Configure Embeddings, then run
embed. - Need public server-size history without a bot?
metricsrecords approximate membership and online presence in a separate database. - Wiring an agent or launcher?
discrawl metadata --json,discrawl status --json,discrawl diagnostics --json,discrawl coverage --json,discrawl failures --json,discrawl remote status, anddiscrawl doctor --jsonexpose the read-only crawlkit control surface.
export DISCORD_BOT_TOKEN="..."
discrawl init
discrawl doctor
discrawl sync --full
discrawl search "panic: nil pointer"
discrawl taildiscrawl tui uses the shared crawlkit terminal explorer:
channel/person/thread groups on the left, message rows in the middle, and
readable message/thread detail on the right.
- Start - install, configure, set up the Discord bot, security notes, release history, contact
- Guides - maintainer archive workflows, sync sources, wiretap internals, search modes, embeddings, Git snapshots, data layout
- Commands - one page per CLI command
https://github.com/openclaw/discrawl/issues. See contact for project links.