PR #71856: feat(tui): fetch startup conversation summary dynamically from Gateway API

• Repository: openclaw/openclaw
• Author: MertBasar0
• State: open | merged: False
• Link: https://github.com/openclaw/openclaw/pull/71856

Description (problem / solution / changelog)

• Problem: The TUI startup summary was static and relied on a legacy environment variable (OPENCLAW_TUI_STARTUP_SUMMARY), making it outdated or requiring manual configuration.
• Why it matters: Users should see their most recent conversation context automatically when opening the TUI for better continuity and DX.
• What changed:
  • Updated src/tui/tui.ts to dynamically fetch the last 10 sessions via client.listSessions upon connection.
  • Implemented logic to identify the most recent active session (excluding the current one) and display its title or last message preview as the startup summary.
  • Added best-effort error handling to ensure TUI startup isn't blocked by API fetch failures.
  • Removed legacy static summary resolution logic from CLI and tests.
• What did NOT change: The feature is skipped in isLocalMode to maintain local performance and prevent unnecessary API calls in local-only scenarios.

Change Type (select all)

• Bug fix
• Feature
• Refactor required for the fix
• Docs
• Security hardening
• Chore/infra

Scope (select all touched areas)

• Gateway / orchestration
• Skills / tool execution
• Auth / tokens
• Memory / storage
• Integrations
• API / contracts
• UI / DX
• CI/CD / infra

Linked Issue/PR

• Closes # (Insert your issue number here)
• Related #
• This PR fixes a bug or regression

Root Cause (if applicable)

• N/A

Regression Test Plan (if applicable)

• Coverage level that should have caught this:
  • Unit test
  • Seam / integration test
• Target test or file: src/cli/program.smoke.test.ts
• Scenario the test should lock in: Tui command bootstrap and successful connection flow without static summary dependencies.

User-visible / Behavior Changes

When connecting to a Gateway, the TUI now automatically displays a "startup summary" derived from the most recent previous conversation (if any), showing either the derived title or a preview of the last message.

Security Impact (required)

• New permissions/capabilities? No
• Secrets/tokens handling changed? No
• New/changed network calls? Yes (One additional listSessions call performed during connection)
• Command/tool execution surface changed? No
• Data access scope changed? No

Repro + Verification

Environment

• OS: Linux
• Runtime/container: Node.js (OpenClaw TUI)
• Model/provider: Gemini 3.1 Pro

Steps

1. Run openclaw tui
2. Observe the system message logs after connection.

Expected

• Startup summary appears dynamically based on recent account history.

Evidence

• Passing npm run build
• Passing src/cli/program.smoke.test.ts
• Verified via CLI log inspection.

Human Verification (required)

• Verified scenarios: Successfully verified that the TUI fetches and displays the correct session summary from the Gateway API.
• Edge cases checked: Verified that API timeouts or failures do not crash the TUI (handled via catch block).
• What you did not verify: UI layout on extremely narrow terminals (< 40 chars).

Compatibility / Migration

• Backward compatible? Yes
• Config/env changes? No (Removes reliance on an internal env var)
• Migration needed? No

Changed files

• src/tui/tui.ts (modified, +42/-0)