Discrawl 用于在本地建立并查询 Discord 归档，资料给出的使用路径是先查本地归档，仅在陈旧、缺少所需范围或明确要求时才刷新。
主要能力与用法：用 discrawl status --json 检查新鲜度，用 discrawl doctor 检查来源与配置就绪情况。同步命令：discrawl sync --source wiretap 读取本地 Discord Desktop 产物；discrawl sync 使用已配置来源，bot API 需要凭据。--full 只用于刻意的历史回填；当数据库忙/锁定时不要中断其他归档写入。应按配置的路径处理，而不是假定 macOS、XDG 或旧版默认位置。
读取与查询：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 可抑制读取冒烟期间的 git-share 更新。discrawl sql 默认只读，接受 SQL 参数或标准输入，适合精确计数/连接；未明确要求并审查数据库变更时，绝不要用 --unsafe --confirm。具体过滤条件见子命令帮助。报告应包含绝对日期范围、频道/私信名称、计数、新鲜度与来源缺口。
来源边界：Desktop wiretap 仅读本地产物，不得提取凭据、使用用户令牌、以用户身份调用 Discord 或写入 Discord 应用存储；bot 同步需要已配置的 bot 凭据，不可推断可用性。桌面私信仅本地，不进入已发布的 Git 快照；Git 快照必须排除密钥与 @me 私信行。实现工作或确实缺失的 CLI 功能，需先确认检出远端为 openclaw/discrawl 并按说明操作，不要假定机器特定的历史检出路径。
ClawSweeper 沙箱仅用沙箱读取器：discrawl-sandbox search --limit 20 "query"；discrawl-sandbox messages --channel clawtributors --days 7 --all；discrawl-sandbox status --json。该读取器会把 https://github.com/openclaw/discord-store.git 导入 /root/clawsweeper-sandbox-workspace/.discrawl/discrawl.db，并设置 discord.token_source = "none"。已发布的 Git 快照仅含已过滤的公开频道；在沙箱化的公开 Discord 会话中不要使用 /root/.discrawl/config.toml 或富写入器数据库。
限制：资料未提供安装方式、价格、平台支持与图形界面细节；TUI、摘要、仓库/发布工作的具体命令参数暂未提供。