session-keeper

Why this exists

Sales, content, ops — every specialist that depends on a logged-in browser session breaks silently when the session expires. By the time the user sees an outage in the inbox-router or "0 leads found" in the brief, the actual problem (linkedin logged out 18h ago) is buried.

This skill audits the 3 default targets every morning and surfaces expired sessions before Cooper opens Telegram for the day.

Targets

~/.openclaw/state/session-keeper/targets.json. Initial 3:

Add Stripe / Gumroad / Gmail-web by editing targets.json once Cooper has those tabs logged in on agent-chrome. URL-redirect detection is the canonical primitive — DOM selectors break on UI updates.

Procedure

bash ${OPENCLAW_HOME}/skills/session-keeper/run.sh

SESSION_KEEPER_DRYRUN=1 → scan only, no gate, no Telegram.

The bash + python flow:

1. Read targets.json
2. For each target: PUT /json/new?<url> → wait 3s → GET /json → find tab by id → read final URL
3. Match final URL against logged_in_marker.value (live) or logged_out_marker.value (expired); else "unknown"
4. Close the spawned tab (CDP /json/close/<id>)
5. Write ~/.openclaw/state/session-keeper/<YYYY-MM-DD>.json with full results
6. For each expired: open LOGIN_<NAME> approval gate with the curl-PUT command Cooper taps
7. Telegram-summary only if expired OR unknown count > 0

Hard rules

1. URL-redirect detection over DOM selectors. UI updates break selectors; URL paths are stable.
2. Always close spawned tabs. Otherwise the agent-chrome instance accumulates dead tabs.
3. Silent on all-live. Cooper doesn't need a "everything fine" message every morning.
4. One gate per expired target per day. If yesterday's gate is still pending and target is still expired today, don't open a duplicate — extend the timeout via resolve_gate.py if needed (Cooper-side decision).
5. Cooper-tap commands in gate evidence. The --evidence field contains the literal curl -s -X PUT ... command — Cooper copies/runs in Terminal, that opens the login tab on agent-chrome, Cooper signs in, future probes auto-flip to live.
6. 3 default targets only. Stripe/Gumroad/Gmail-web added once Cooper has those tabs already logged in. Probing a never-logged-in service produces noise.

Self-test

SESSION_KEEPER_DRYRUN=1 bash ~/.openclaw/skills/session-keeper/run.sh

Output: STATUS=ok live=N expired=N unknown=N + per-category lists. Acceptance: scans 3 targets, writes state file, no false positives on currently-active sessions.