# Send Session History Enhanced to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "session-history-enhancements", "name": "Session History Enhanced", "source": "tencent", "type": "skill", "category": "通讯协作", "sourceUrl": "https://clawhub.ai/maverick-software/session-history-enhancements", "canonicalUrl": "https://clawhub.ai/maverick-software/session-history-enhancements", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/session-history-enhancements", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=session-history-enhancements", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "references/backend-protocol-schemas.ts.txt", "references/backend-history-migration.ts.txt", "references/backend-session-archive.ts.txt", "references/frontend-state-changes.txt", "references/backend-rpc-handlers.ts.txt" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/session-history-enhancements" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/session-history-enhancements", "downloadUrl": "https://openagent3.xyz/downloads/session-history-enhancements", "agentUrl": "https://openagent3.xyz/skills/session-history-enhancements/agent", "manifestUrl": "https://openagent3.xyz/skills/session-history-enhancements/agent.json", "briefUrl": "https://openagent3.xyz/skills/session-history-enhancements/agent.md" } } ``` ## Documentation ### Session History Transforms OpenClaw's single-slot session model into a multi-session history system with SQLite indexing, archive/restore, and full dashboard UI. ### Architecture ~/.openclaw/agents/{agentId}/sessions/ ├── sessions.json # routing table (unchanged) ├── history.db # SQLite index (auto-created) ├── {activeSessionId}.jsonl # active transcript └── archive/ └── {sessionId}.jsonl # archived transcripts Lifecycle: On /new or session reset → old transcript moves to archive/, metadata indexed in SQLite On archive (from UI) → session deactivated, transcript archived, indexed, removed from store On resume → transcript moves back from archive/, SQLite status flips to active Migration auto-runs on first access: indexes all orphaned .jsonl files ### Backend (new files) FileReferencePurposesrc/config/sessions/history-db.tsreferences/backend-history-db.ts.txtSQLite CRUD operationssrc/config/sessions/history-migration.tsreferences/backend-history-migration.ts.txtOne-time migration + initHistoryDbWithMigrationsrc/gateway/session-archive.tsreferences/backend-session-archive.ts.txtArchive/restore logic ### Backend (modified files) FileReferencePurposesrc/gateway/protocol/schema/sessions.tsreferences/backend-protocol-schemas.ts.txtTypeBox schemas for new RPCssrc/gateway/server-methods/sessions.tsreferences/backend-rpc-handlers.ts.txt5 RPC handler implementations ### Frontend (modified files) FileReferencePurposeui/src/ui/controllers/sessions.tsreferences/frontend-controllers-sessions.ts.txtFull controller with archived session CRUD + paginationui/src/ui/views/sessions.tsreferences/frontend-views-sessions.ts.txtFull view with Session History section, Archive button, paginationui/src/ui/app-view-state.tsreferences/frontend-state-changes.txtState + app.ts + app-render.ts + app-chat.ts + app-settings.ts + app-render.helpers.ts wiring ### Installation See references/INSTALL.md for step-by-step instructions. ### RPC Endpoints MethodParamsPurposesessions.archivekeyArchive active session — deactivates, moves transcript, indexes in SQLite, removes from storesessions.archivedagentId?, limit?, offset?, search?, status?List archived sessions with pagination and searchsessions.resumesessionId, agentId?Restore archived session to activesessions.renamesessionId, displayName, agentId?Update session display namesessions.deleteArchivedsessionId, agentId?, deleteTranscript?Delete archived session + optional transcript ### Sessions Page Active Sessions grid — with Archive button (hidden for Main Session), History, Delete Session History section — archived sessions with search, Resume/Rename/Delete buttons Pagination — both sections have 10/20/25 page-size dropdown + Prev/Next ### Chat Dropdown Filters out cron/subagent/openai sessions (only user-facing sessions shown) "Recent Sessions" with 10 most recent archived sessions "📋 View All Sessions" link navigates to Sessions tab Selecting an archived session auto-resumes it ### Key Design Decisions SQLite over JSON: Supports search, pagination, and indexing without loading everything into memory Server-side pagination for archives: Pass limit/offset to sessions.archived RPC Client-side pagination for live sessions: Slice the already-loaded array sessionId-based dropdown values: Archived sessions all share the same sessionKey (agent:main:main), so the dropdown uses __archived__:{sessionId} as the option value sessions.archive reuses sessions.delete param schema: Both need just { key } ### Common Pitfalls RPC handler signature: Must use ({ params, respond }) destructuring, not (request, respond) assertValidParams: Takes 4 args: (params, validator, "method.name", respond) Sessions directory: Use resolveSessionTranscriptsDirForAgent(agentId) — NOT resolveGatewaySessionStoreTarget(config) Pagination on every load: All loadArchivedSessions calls must pass limit and offset Page reset: Changing page size or search query must reset page to 1 Archived session dropdown filtering: Filter by sessionId, not sessionKey (all archived sessions share the same sessionKey) ## Trust - Source: tencent - Verification: Indexed source record - Publisher: maverick-software - Version: 1.0.1 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-30T16:55:25.780Z - Expires at: 2026-05-07T16:55:25.780Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/session-history-enhancements) - [Send to Agent page](https://openagent3.xyz/skills/session-history-enhancements/agent) - [JSON manifest](https://openagent3.xyz/skills/session-history-enhancements/agent.json) - [Markdown brief](https://openagent3.xyz/skills/session-history-enhancements/agent.md) - [Download page](https://openagent3.xyz/downloads/session-history-enhancements)