Telegram Crabbox E2E-Proof (Ende-zu-Ende-Nachweis)
Verwenden Sie dies für Telegram-PR-Reviews oder Bug-Reports, wenn der Bot-zu-Bot-Nachweis nicht ausreicht. Das Ziel ist es, dem Agenten zu erlauben, eine echte Telegram-Benutzersitzung offen zu halten, bis er zufrieden ist, und dann visuelle Beweise anzuhängen.
Verwenden Sie keine persönlichen Konten. Fügen Sie keine Anmeldedaten zum Repository, Prompt oder Artefaktbündel hinzu. Der Runner mietet das geteilte Burner-Konto von Convex.
Start
Führen Sie den Befehl im OpenClaw-Repository und Branch unter Test aus:
proof_cmd="${OPENCLAW_TELEGRAM_USER_PROOF_CMD:-openclaw-telegram-user-crabbox-proof}"
"$proof_cmd" start \
--tdlib-url http://artifacts.openclaw.ai/tdlib-v1.8.0-linux-x64.tgz \
--output-dir .artifacts/qa-e2e/telegram-user-crabbox/pr-review
Dies startet eine gehaltene Sitzung:
- Mietet die exklusive
telegram-user-Convex-Anmeldedaten - Stellt TDLib und Telegram Desktop mit demselben Benutzerkonto wieder her
- Startet einen Mock-OpenClaw-Telegram-SUT aus dem aktuellen Checkout
- Wählt den konfigurierten Telegram-Chat im sichtbaren Linux-Desktop aus
- Startet eine 24fps-Desktop-Aufzeichnung
- Schreibt
.artifacts/qa-e2e/telegram-user-crabbox/pr-review/session.json
Halten Sie die Sitzung während der Untersuchung am Leben. Der Agent kann minutenlang testen, mehrere Befehle ausführen, WebVNC verwenden, Transkripte inspizieren und erst dann beenden, wenn das Verhalten verstanden ist.
Für deterministische visuelle Reproduktionen legen Sie die genaue Mock-Modell-Antwort in eine Datei und übergeben Sie sie an start:
proof_cmd="${OPENCLAW_TELEGRAM_USER_PROOF_CMD:-openclaw-telegram-user-crabbox-proof}"
"$proof_cmd" start \
--tdlib-url http://artifacts.openclaw.ai/tdlib-v1.8.0-linux-x64.tgz \
--mock-response-file .artifacts/qa-e2e/telegram-user-crabbox/reply.txt \
--output-dir .artifacts/qa-e2e/telegram-user-crabbox/pr-review
Der Runner verwendet standardmäßig --class standard, --record-fps 24, --preview-fps 24 und --preview-width 1920. Behalten Sie diese Standardwerte bei, es sei denn, der Nachweis erfordert etwas anderes.
Während des Testens
Für visuelle Nachweise senden oder identifizieren Sie zunächst eine untere Markierungsnachricht, öffnen Sie dann die Gruppe/das Thema direkt per Nachrichten-ID:
proof_cmd="${OPENCLAW_TELEGRAM_USER_PROOF_CMD:-openclaw-telegram-user-crabbox-proof}"
"$proof_cmd" view \
--session .artifacts/qa-e2e/telegram-user-crabbox/pr-review/session.json \
--message-id <message-id>
Dies verwendet Telegram Desktop direkt mit tg://privatepost, nicht xdg-open. Es ändert auch Telegram auf 650x1000 an der getesteten Desktop-Position, damit der Zuschnitt den Chat-Bereich isolieren kann, selbst wenn Telegram ein geteiltes/Sidebar-Layout beibehält. Drücken Sie nach diesem Befehl nicht Escape; Escape kann den ausgewählten Chat schließen.
Das untere Verhalten ist wichtig:
- Deep-Linking zur neuesten Nachricht hält Telegram am unteren Rand fixiert, sodass spätere Nachrichten live in der Aufzeichnung erscheinen
- Deep-Linking zu einer älteren Nachricht scrollt nicht automatisch zu neuen Nachrichten; verlinken Sie erneut zur neuesten/letzten Markierung anstatt auf den Abwärtspfeil zu klicken
- Das zugeschnittene GIF verwendet absichtlich den Chat-Bereich, nicht den gesamten Desktop oder das gesamte Telegram-Fenster
Senden Sie als echter Telegram-Benutzer:
proof_cmd="${OPENCLAW_TELEGRAM_USER_PROOF_CMD:-openclaw-telegram-user-crabbox-proof}"
"$proof_cmd" send \
--session .artifacts/qa-e2e/telegram-user-crabbox/pr-review/session.json \
--text /status
Für Slash-Befehle lassen Sie den Bot-Benutzernamen weg; der Runner zielt auf den SUT-Bot.
Führen Sie beliebige Befehle auf der Crabbox aus:
proof_cmd="${OPENCLAW_TELEGRAM_USER_PROOF_CMD:-openclaw-telegram-user-crabbox-proof}"
"$proof_cmd" run \
--session .artifacts/qa-e2e/telegram-user-crabbox/pr-review/session.json \
-- bash -lc 'source /tmp/openclaw-telegram-user-crabbox/env.sh && python3 /tmp/openclaw-telegram-user-crabbox/user-driver.py transcript --limit 20 --json'
Nützliche Remote-Benutzerbefehle:
source /tmp/openclaw-telegram-user-crabbox/env.sh
python3 /tmp/openclaw-telegram-user-crabbox/user-driver.py status --json
python3 /tmp/openclaw-telegram-user-crabbox/user-driver.py chats --json
python3 /tmp/openclaw-telegram-user-crabbox/user-driver.py transcript --limit 20 --json
python3 /tmp/openclaw-telegram-user-crabbox/user-driver.py send --text '/status@{sut}'
python3 /tmp/openclaw-telegram-user-crabbox/user-driver.py probe --text '@{sut} Reply exactly: USER-E2E-{run}' --expect USER-E2E-
Erfassen Sie den aktuellen Desktop, ohne die Sitzung zu beenden:
proof_cmd="${OPENCLAW_TELEGRAM_USER_PROOF_CMD:-openclaw-telegram-user-crabbox-proof}"
"$proof_cmd" screenshot \
--session .artifacts/qa-e2e/telegram-user-crabbox/pr-review/session.json
Überprüfen Sie den Mietstatus und erhalten Sie den WebVNC-Befehl:
proof_cmd="${OPENCLAW_TELEGRAM_USER_PROOF_CMD:-openclaw-telegram-user-crabbox-proof}"
"$proof_cmd" status \
--session .artifacts/qa-e2e/telegram-user-crabbox/pr-review/session.json
Abschluss
Beenden Sie die Sitzung immer oder behalten Sie sie explizit:
proof_cmd="${OPENCLAW_TELEGRAM_USER_PROOF_CMD:-openclaw-telegram-user-crabbox-proof}"
"$proof_cmd" finish \
--session .artifacts/qa-e2e/telegram-user-crabbox/pr-review/session.json \
--preview-crop telegram-window
finish stoppt die Aufzeichnung, erstellt bewegungsgetrimmte MP4/GIF-Artefakte, erfasst einen letzten Screenshot und Logs, gibt die Convex-Anmeldedaten frei, stoppt den lokalen SUT und beendet die Crabbox-Miete. --preview-crop telegram-window erstellt zusätzlich ein GIF mit fester Geometrie aus dem getesteten Telegram-Nachweisfenster für saubere Nebeneinander-PR-Tabellen; das vollständige Desktop-Video/GIF verbleibt im Artefaktverzeichnis. Verwenden Sie --keep-box nur, wenn ein Mensch nach der Freigabe der Anmeldedaten weiter mit VNC debuggen muss.
Nach jedem Fehler oder Unterbrechung überprüfen Sie die Bereinigung:
crabbox list --provider aws
Wenn eine Sitzungsdatei existiert und die Anmeldedaten noch gemietet sein könnten, führen Sie finish mit dieser Sitzungsdatei aus, bevor Sie es erneut versuchen.
Beweise anhängen
Hängen Sie nur das nützliche visuelle Artefakt an den PR an, es sei denn, Logs werden benötigt. Der Runner ist standardmäßig GIF-only:
proof_cmd="${OPENCLAW_TELEGRAM_USER_PROOF_CMD:-openclaw-telegram-user-crabbox-proof}"
"$proof_cmd" publish \
--session .artifacts/qa-e2e/telegram-user-crabbox/pr-review/session.json \
--pr <pr-number> \
--summary 'Telegram real-user Crabbox session motion GIF'
Dies kopiert nur das nützliche GIF in ein temporäres Veröffentlichungsbündel und kommentiert dieses GIF. Wenn finish --preview-crop telegram-window ein zugeschnittenes GIF erstellt hat, verwendet publish dieses; ansonsten verwendet es telegram-user-crabbox-session-motion.gif. Verwenden Sie --full-artifacts nur, wenn der PR Logs oder JSON-Ausgabe benötigt. Veröffentlichen Sie niemals Anmeldedaten-Payloads, lokale Umgebungsdateien, TDLib-Datenbanken, Telegram-Desktop-Profile oder rohe Sitzungsarchive.
Für Vorher/Nachher-Beweise führen Sie eine Sitzung auf main und eine auf dem PR-Head aus und veröffentlichen dann nur die gewünschten GIFs aus einem sauberen Bündel:
mkdir -p .artifacts/qa-e2e/telegram-user-crabbox/pr-123/comparison
cp <main-output>/telegram-user-crabbox-session-motion-telegram-window.gif \
.artifacts/qa-e2e/telegram-user-crabbox/pr-123/comparison/main-before.gif
cp <pr-output>/telegram-user-crabbox-session-motion-telegram-window.gif \
.artifacts/qa-e2e/telegram-user-crabbox/pr-123/comparison/pr-after.gif
crabbox artifacts publish \
--repo openclaw/openclaw \
--pr 123 \
--dir .artifacts/qa-e2e/telegram-user-crabbox/pr-123/comparison \
--summary 'Telegram before/after proof' \
--no-comment
Posten Sie dann eine prägnante Markdown-Tabelle mit diesen beiden URLs. Veröffentlichen Sie keine Arbeitsverzeichnisse, die Screenshots, Rohvideos, Logs, Sitzungs-JSONs oder Zuschnittsexperimente enthalten, es sei denn, diese Artefakte werden explizit benötigt.
Schnelltests
Für eine schnelle Einmalüberprüfung verwenden Sie:
proof_cmd="${OPENCLAW_TELEGRAM_USER_PROOF_CMD:-openclaw-telegram-user-crabbox-proof}"
"$proof_cmd" --text /status
Dies ist eine Abkürzung für Start/Senden/Beenden. Bevorzugen Sie die gehaltene Sitzung für PR-Reviews, Bug-Reports oder jede Aufgabe, bei der der Agent mehrere Versuche benötigen könnte.