Discrawl 是做什么的？
首先使用本地 Discord 存档。对于近期/当前的问题，检查 discrawl status --json；使用 discrawl doctor 检查来源/配置就绪状态。仅在数据过时、缺少请求范围或明确要求时进行刷新。
discrawl sync --source wiretap # 本地 Discord 桌面工件
discrawl sync # 配置的来源；机器人 API 需要凭据
仅在有意进行历史回填时使用 --full。不要中断其他存档写入器来解决忙碌/锁定的数据库。请解析配置路径，而不是假设默认的 macOS、XDG 或遗留位置。
读取有限切片
DISCRAWL_NO_AUTO_UPDATE=1 discrawl search --limit 20 "查询"
discrawl messages --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 共享更新。discrawl sql 默认是只读的，接受 SQL 参数或标准输入。在正常读取过于粗略时，使用它进行精确计数/联接；未经明确请求和审查的数据库变更，绝不使用 --unsafe --confirm。查阅子命令帮助以了解过滤选项。报告绝对日期范围、频道/私信名称、数量、新鲜度和来源缺口。
来源边界
桌面监听读取本地工件；不得提取凭据、使用用户令牌、以用户身份调用 Discord 或写入 Discord 应用程序存储。机器人同步需要配置的机器人凭据；切勿推断可用性。桌面私信仅在本地，不属于发布的 Git 快照的一部分。Git 共享快照必须排除密钥和 @me 私信行。
对于实施工作或真正缺少的 CLI 功能，请确认检出远程仓库为 openclaw/discrawl 并遵循其说明。不要假定特定机器的历史检出路径。
ClawSweeper 沙箱
仅使用沙箱阅读器：
discrawl-sandbox search --limit 20 "查询"
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 或丰富的写入器数据库。