# Discrawl

> Mirror Discord guild history into local SQLite and query it offline with search, messages, mentions, reports, and DM wiretap import.

- Skill: `openclaw/discrawl-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add openclaw/discrawl-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/openclaw/discrawl-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: OpenClaw (https://skillmd.com/u/openclaw)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/openclaw/discrawl-2

---


# discrawl

Use `discrawl` to mirror Discord guild data into local SQLite, then query it offline.

## When to Use

Use this skill when the user wants to:

- search Discord history locally without relying on Discord search
- archive a guild into SQLite for later queries
- inspect recent messages, mentions, channels, or members from a local archive
- import local Discord Desktop cache data for DM recovery/search
- publish or subscribe to a Git-backed Discord archive snapshot

## Requirements

- Discord bot token for guild sync, or an existing OpenClaw Discord config
- local Discord Desktop cache files only if using `wiretap`
- enough local disk for SQLite archive growth

## Setup

- Default config: `~/.discrawl/config.toml`
- Default database: `~/.discrawl/discrawl.db`
- Fastest setup when OpenClaw already has Discord configured:
  - `discrawl init --from-openclaw ~/.openclaw/openclaw.json`
- Env-only setup:
  - `export DISCORD_BOT_TOKEN="..."`
  - `discrawl init`

## Common Commands

- Doctor: `discrawl doctor`
- Initial history: `discrawl sync --full`
- Incremental refresh: `discrawl sync`
- Live tail: `discrawl tail`
- Search: `discrawl search "panic nil pointer"`
- Recent channel messages: `discrawl messages --channel general --hours 24`
- Mentions: `discrawl mentions --user <user-id>`
- DM cache import: `discrawl wiretap`
- Local DM search: `discrawl dms --search "launch checklist"`
- Read-only SQL: `discrawl sql "select count(*) from messages"`
- Git-backed reader mode: `discrawl subscribe <private-repo-url>`

## Notes

- Bot-token sync reads only guilds/channels the bot can access.
- `wiretap` uses local Discord Desktop cache files only; it does not use a user token.
- Prefer `discrawl doctor` before a first sync.
- Use `sync --full` once for backfill, then plain `sync` for routine refreshes.