Discrawl

Use local Discord archives first. For recent/current questions, check
discrawl status --json; use discrawl doctor for source/config readiness.
Refresh only when stale, missing the requested scope, or explicitly requested.

discrawl sync --source wiretap  # local Discord Desktop artifacts
discrawl sync                   # configured source; bot API requires credentials

Use --full only for deliberate historical backfills. Do not interrupt another
archive writer to resolve a busy/locked database. Resolve configured paths
instead of assuming default macOS, XDG, or legacy locations.

Read Bounded Slices

DISCRAWL_NO_AUTO_UPDATE=1 discrawl search --limit 20 "query"
discrawl messages --channel '<channel>' --days 7 --all
discrawl dms --last 20
DISCRAWL_NO_AUTO_UPDATE=1 discrawl --json sql "select count(*) as messages from messages;"

DISCRAWL_NO_AUTO_UPDATE=1 suppresses git-share updates during read smokes.
discrawl sql is read-only by default and accepts SQL arguments or stdin. Use
it for exact counts/joins when normal reads are too coarse; never use
--unsafe --confirm without an explicitly requested and reviewed database
mutation. Consult subcommand help for filters. Report absolute date spans,
channel/DM names, counts, freshness, and source gaps.

Source Boundaries

Desktop wiretap reads local artifacts; it must not extract credentials, use
user tokens, call Discord as the user, or write Discord application storage.
Bot sync needs configured bot credentials; never infer availability. Desktop
DMs are local-only, not part of the published Git snapshot. Git-share snapshots
must exclude secrets and @me DM rows.

For implementation work or a genuinely missing CLI feature, verify the checkout
remote is openclaw/discrawl and follow its instructions. Do not assume a
machine-specific historical checkout path.

ClawSweeper Sandbox

Use the sandbox reader only:

discrawl-sandbox search --limit 20 "query"
discrawl-sandbox messages --channel clawtributors --days 7 --all
discrawl-sandbox status --json

This reader imports https://github.com/openclaw/discord-store.git into
/root/clawsweeper-sandbox-workspace/.discrawl/discrawl.db with
discord.token_source = "none". The published Git snapshot is public-channel
filtered; do not use /root/.discrawl/config.toml or the rich writer DB from
sandboxed public Discord sessions.