// readme

slacrawl ๐Ÿ’พ โ€” Your Slack history, on your terms.

slacrawl mirrors Slack workspace data into local SQLite for full-text search, terminal browsing, reporting, and read-only SQL. It is for people who want a queryable Slack archive that stays under their control.

Install

Homebrew is the shortest path on macOS or Linux:

brew install openclaw/tap/slacrawl

The tap can trail the newest release. GitHub Releases provides signed and notarized macOS archives, Linux archives, and Debian/RPM packages for AMD64 and ARM64.

To build the latest source, install Go 1.27.0 or newer, then run:

git clone https://github.com/openclaw/slacrawl.git
cd slacrawl
make build
./bin/slacrawl --help

macOS binaries require macOS 13 or newer.

The repository also includes a Dockerfile for container builds.

Quick start

Set SLACK_BOT_TOKEN, or SLACK_USER_TOKEN for user-only API sync, to a token that can read the workspace. Then replace the example workspace and channel IDs:

slacrawl init --workspace T01234567
slacrawl doctor
slacrawl sync --source botโ€ฆ