From 35d48cea90e8f8d49c5cf6cbc83241062027a026 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Thu, 23 Apr 2026 01:34:42 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@5461195035d9ca7c1e123da56de45d73a3d9682e --- .openclaw-sync/source.json | 4 ++-- docs/concepts/session-tool.md | 12 ++++++++---- 2 files changed, 10 insertions(+), 6 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index ed76023de..3b890451a 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "4ff720a83758906a034bed77f0e5875ee59c18f5", - "syncedAt": "2026-04-23T01:23:05.605Z" + "sha": "5461195035d9ca7c1e123da56de45d73a3d9682e", + "syncedAt": "2026-04-23T01:34:42.355Z" } diff --git a/docs/concepts/session-tool.md b/docs/concepts/session-tool.md index 2c019c7f0..9642417e7 100644 --- a/docs/concepts/session-tool.md +++ b/docs/concepts/session-tool.md @@ -16,7 +16,7 @@ orchestrate sub-agents. | Tool | What it does | | ------------------ | --------------------------------------------------------------------------- | -| `sessions_list` | List sessions with optional filters (kind, recency) | +| `sessions_list` | List sessions with optional filters (kind, label, agent, recency, preview) | | `sessions_history` | Read the transcript of a specific session | | `sessions_send` | Send a message to another session and optionally wait | | `sessions_spawn` | Spawn an isolated sub-agent session for background work | @@ -26,9 +26,13 @@ orchestrate sub-agents. ## Listing and reading sessions -`sessions_list` returns sessions with their key, kind, channel, model, token -counts, and timestamps. Filter by kind (`main`, `group`, `cron`, `hook`, -`node`) or recency (`activeMinutes`). +`sessions_list` returns sessions with their key, agentId, kind, channel, model, +token counts, and timestamps. Filter by kind (`main`, `group`, `cron`, `hook`, +`node`), exact `label`, exact `agentId`, search text, or recency +(`activeMinutes`). When you need mailbox-style triage, it can also ask for +derived titles, last-message previews, or bounded recent messages. Preview +transcript reads are scoped to sessions visible under the configured session +tool visibility policy. `sessions_history` fetches the conversation transcript for a specific session. By default, tool results are excluded -- pass `includeTools: true` to see them.