steipete/whatsapp

WhatsApp-Router: Verlauf/Suche/Lesen/Senden; wacrawl lesen, wacli live.

Was ist whatsapp?

Dieses Skill fungiert als zentraler Router für die Arbeit mit WhatsApp über zwei komplementäre Werkzeuge: `wacrawl` und `wacli`. `wacrawl` ist das primäre, schreibgeschützte Archiv des WhatsApp Desktop-Clients, das sich ideal für lokale Verlaufsabfragen, Suche und Sicherung eignet, ohne Netzwerkzugriff oder Sendeoperationen. `wacrawl` liefert Chat-ungelesene-Zähler und ermöglicht das direkte Durchsuchen von Nachrichten, Medien und Backups. `wacli` hingegen stellt verknüpfte Geräte-Konten dar und wird für Live-Synchronisation, Authentifizierung, Senden, Reaktionen, Gruppen-/Kanalverwaltung und alles, was Echtzeit-Netzwerkzugriff erfordert, verwendet. Das Skill definiert klare Sicherheitsregeln: Kein Senden oder Mutieren von WhatsApp-Zustand ohne explizite Aufforderung, bevorzugt schreibgeschützte `wacli`-Befehle mit `--read-only` oder der Umgebungsvariablen `WACLI_READONLY=1`, keine direkten Bearbeitungen von Datenbanken oder Containern. Es ist für Entwickler und Power-User konzipiert, die mit lokalen WhatsApp-Archiven oder mehreren verknüpften Konten arbeiten, und unterstützt sowohl macOS- (Desktop) als auch plattformübergreifende (wacli) Umgebungen. Die bereitgestellten Befehle decken Statusprüfungen, Suche, Chat-Auflistungen, Medienexport, Senden und Vergleiche zwischen den beiden Quellen ab, wobei die Integrität und Sicherheit der WhatsApp-Daten stets gewahrt bleibt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/whatsapp

Installed? Explore more Produktivität & Zusammenarbeit skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht whatsapp?

Verwenden Sie dies als erste Anlaufstelle für WhatsApp-Arbeiten. Halten Sie die Quellengrenze scharf:

  • wacrawl: primäres WhatsApp Desktop-Archiv. Schreibgeschützt, bester lokaler Verlauf, kein Netzwerk, kein Senden.
  • wacli: verknüpfte Gerätekonten. Verwenden für alternative Konten, Live-Sync, Authentifizierung, Senden, Chat-/Gruppen-Modifikation und Fragen zum WhatsApp-Web-Protokoll.

Falls der Benutzer konkret wacrawl- oder wacli-Repo-Arbeiten erwähnt, lesen Sie auch das Skill des jeweiligen Tools.

Routing

  • Primäre WhatsApp-Lese-/Such-/Verlaufsaufgaben: wacrawl verwenden.
  • Gelesene/ungelesene Zähler aus WhatsApp Desktop: wacrawl verwenden; es hat Chat-Ebene-Ungelesene-Zähler, nicht den Einzelnachricht-Lesestatus.
  • Frische-empfindliche Primär-Lesevorgänge: wacrawl status prüfen; bei Bedarf oder wenn aktuelle Daten wichtig sind, wacrawl sync ausführen.
  • Alternative Konten wie me, molty oder benannte Speicher: wacli --account NAME verwenden.
  • Senden, Reaktionen, Anwesenheit, Archivieren/Pinnen/Stummschalten/Markieren-als-gelesen, Gruppen-/Kanal-Mutationen: wacli nur nach explizitem Benutzerwunsch verwenden.
  • Vergleich der Abdeckung zwischen Quellen: wacrawl als Wahrheit für den primären Desktop-Verlauf behandeln und wacli als verknüpfte Geräte-/Live-Abdeckung mit Protokollbeschränkungen.

Sicherheit

  • Niemals WhatsApp-Zustand senden oder mutieren, es sei denn, es wird ausdrücklich angefordert.
  • Für Überprüfungen vorzugsweise schreibgeschützte wacli-Befehle verwenden: --read-only übergeben oder WACLI_READONLY=1 setzen.
  • Nicht in den App-Container von WhatsApp Desktop schreiben.
  • wacli session.db nicht direkt bearbeiten.
  • Benannte wacli-Konten isoliert halten; keine Speicher zusammenführen.
  • Bei Antworten aus lokalen Speichern die Quellenfrische, den Kontonamen und bekannte Lücken angeben.

Übliche Befehle

Primäres Archiv

Frische und Status:

wacrawl status
wacrawl doctor
wacrawl sync

Ungelesene Priorisierung:

wacrawl chats --limit 20
wacrawl unread --limit 20
wacrawl --json unread --limit 100

Nachrichten durchsuchen und filtern:

wacrawl messages --after 2026-01-01 --limit 50
wacrawl messages --chat JID --asc --limit 100
wacrawl messages --has-media --limit 50
wacrawl --json search "query"
wacrawl search "query" --after 2026-01-01 --from-them

Medien oder Backups archivieren, nur wenn gefragt:

wacrawl import --copy-media
wacrawl backup status
wacrawl --sync never backup push

Alternative/Live-Konten

Kontoerkennung und schreibgeschützte Überprüfung:

wacli accounts list --json
wacli --account me auth status --read-only --json
wacli --account me chats list --read-only --json
wacli --account me messages list --read-only --json --limit 50
wacli --account me messages search --read-only --json "query"

Hintergrund-Live-Sync, nur wenn angefordert. Für Follow-Modus tmux bevorzugen:

wacli --account me sync --follow --events
wacli --account me sync --once --events

Medien, Senden und Live-Mutationen, nur wenn explizit angefordert:

wacli --account me media download --chat JID --id MESSAGE_ID
wacli --account me send text --to JID_OR_NAME --message "message"
wacli --account me send file --to JID_OR_NAME --file ./file.jpg --caption "caption"
wacli --account me send text --to JID --reply-to MESSAGE_ID --message "reply"

Vergleiche

Beim Vergleich von wacrawl und wacli beide Zählungen und Überschneidungen vergleichen:

  • Nachrichtenanzahl und Datumsbereiche
  • Chat-Anzahl
  • Zeitstempel der neuesten Nachricht
  • Überschneidung via msg_id
  • Überschneidung via chat_jid + msg_id wenn JIDs ausreichend normalisiert sind
  • Offensichtliche Lücken, die durch Verlaufsbeschränkungen verknüpfter Geräte im Vergleich zur Desktop-Archiv-Abdeckung erklärt werden

Repo-Verweise

  • ~/Projects/wacrawl: Desktop-Archiv-Import/Suche/Backup.
  • ~/Projects/wacli: Verknüpfter-Geräte-Client/Sync/Senden.
  • Globale Skil-Kopien: ~/Projects/agent-scripts/skills/wacrawl und ~/Projects/agent-scripts/skills/wacli.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Verwandte Skills