Sessions Wait

Wait for OpenClaw child sessions (ACP builders, verifiers, probes) to finish without sleep loops.

Tools

sessions_wait

Blocks until a child session closes or times out. One tool call, one result.

Parameters:

• session_key (required) — Session key or UUID fragment from sessions_spawn
• timeout_seconds (optional, default 600) — Max seconds to wait
• poll_interval (optional, default 5) — Seconds between internal polls

Returns status closed with the session result, timeout if the deadline passes, or not_found if no matching session files exist.

sessions_check

Instant non-blocking status check. Returns running or closed with message count and result if available.

Parameters:

• session_key (required) — Session key or UUID fragment

When to use

Use sessions_wait after sessions_spawn instead of bash sleep loops. The controller/builder/verifier pattern becomes:

1. sessions_spawn(...) → get session key
2. sessions_wait(session_key, timeout_seconds: 900) → blocks until done
3. Read result, dispatch next lane

Install

As an OpenClaw plugin

openclaw plugins install git:https://github.com/peterkatz/openclaw-sessions-wait

As an MCP server

openclaw mcp set sessions-wait '{"command":"python3","args":["mcp/server.py"]}'

Requirements

• OpenClaw 2026.5.17+
• Node.js 20+ (plugin mode) or Python 3.8+ (MCP server mode)