🎁 Get the FREE AI Skills Starter Guide — Subscribe →
BytesAgainBytesAgain
BytesAgain › Skills › Discrawl
🦀 ClawHub

Discrawl

by @openclaw

Discord archive: search, sync freshness, DMs, channel slices, SQL counts, and Discrawl repo work.

Versionv1.0.0
Downloads697
Stars⭐ 1
#clawhub
TERMINAL
clawhub install discrawl

📖 About This Skill

name: discrawl description: Mirror Discord guild data into a local SQLite archive for search, inspection, and agent queries. Bot-token only, no user-token hacks. Data stays local. homepage: https://github.com/steipete/discrawl metadata: {"clawdbot":{"emoji":"🎮","os":["darwin","linux"],"requires":{"bins":["discrawl"],"env":["DISCORD_BOT_TOKEN"]},"install":[{"id":"brew","kind":"brew","tap":"steipete/tap","formula":"discrawl","bins":["discrawl"],"label":"Install discrawl (brew)"}]}}

Discrawl

Local-first Discord crawler. Pulls guild metadata, channels, and message history into ~/.discrawl/discrawl.db (SQLite) so an agent can query history without depending on Discord search.

Requirements

  • Discord bot token (not a user token). Create one at https://discord.com/developers/applications.
  • Bot must be invited to each guild you want to mirror, with permissions to read message history.
  • discrawl binary on PATH.

    • Setup

    export DISCORD_BOT_TOKEN="your-bot-token"
discrawl doctor       # verify token + permissions
discrawl init         # create local config + database
discrawl sync --full  # initial sync of all accessible guilds

    If you already use OpenClaw, discrawl can reuse ~/.openclaw/openclaw.json for shared config.

    State

  • Config: ~/.discrawl/config.toml
  • Database: ~/.discrawl/discrawl.db

    • Common Commands

    discrawl status                       # last sync, row counts
discrawl sync --incremental           # pull new messages since last run
discrawl guilds list --json
discrawl channels list --guild  --json
discrawl messages list --channel  --limit 100 --json
discrawl search "keyword" --json
discrawl sql 'SELECT count(*) FROM messages'   # raw SQL

    Integration Notes

  • Read-only against Discord; only writes to the local SQLite file.
  • Use --json on every command for agent-parseable output.
  • Schedule incremental syncs via PaperFang cron for continuous mirroring.

    • ⚙️ Configuration

    export DISCORD_BOT_TOKEN="your-bot-token"
discrawl doctor       # verify token + permissions
discrawl init         # create local config + database
discrawl sync --full  # initial sync of all accessible guilds

    If you already use OpenClaw, discrawl can reuse ~/.openclaw/openclaw.json for shared config.