Source - Session Tool (OpenClaw Docs)

Origin: https://docs.openclaw.ai/concepts/session-tool
Fetched: 2026-04-15

Summary

Seven agent-facing tools for cross-session inspection and sub-agent orchestration. Agents use these to query history, send messages to other sessions, spawn background workers, and manage child agents.

Key Points

• sessions_list — list sessions filtered by kind (main, group, cron, hook, node) or recency; returns key, kind, channel, model, token counts, timestamps
• sessions_history — retrieve transcript; excludes tool results by default; strips thinking tags, scaffolding blocks, control tokens
• sessions_send — send message to another session; timeoutSeconds: 0 = fire-and-forget; reply-back loops up to 5 turns with optional early termination
• sessions_spawn — create isolated background task session; non-blocking; returns runId + childSessionKey; runtime: "subagent" (default) or "acp"; thread binding + sandbox enforcement available; orchestrators (depth ≥ 1) get expanded tool access
• sessions_yield — terminate current turn early to receive follow-up results
• subagents — control spawned sub-agents: list, steer, kill
• session_status — show current status and model overrides
• Visibility scoping: self | tree (default) | all

Linked Wiki Pages

• Session Tool — full concept page
• Session Management (OpenClaw) — session lifecycle context