agent-home

Agent Home

Zero-click ambient second-screen display for OpenClaw agents.

Agent Home is meant to live beside the existing OpenClaw Control UI, not replace it. Control UI is the interactive cockpit at http://127.0.0.1:18789/. Agent Home is the room display: a full-screen, no-scroll, privacy-safe answer to whether the agent is working, waiting, or needs the human.

It should show more than a chat app can show. A single transport only sees its own delivery path. Agent Home shows the local OpenClaw conversation and operating context around it: source channel coverage, context pressure, agent/subagent topology, gateway posture, collector health, local machine posture, heartbeat/cron state, and the current attention queue.

The current visual model is a Signal Desk: a PC-native, bento-box-style chat-and-command surface for OpenClaw. It reads the local session store, merges recent user-facing messages across source channels, turns tool/PowerShell activity into one active event, and keeps collector proof visible without needing clicks or scroll.

This is the first local vertical slice. It is intentionally dependency-free:

• Node server reads machine-readable OpenClaw state.
• Browser UI renders one layout-ready view model from /api/view.
• Subagent/task relationships are derived from session and task metadata.
• No transcript bodies, tokens, raw tool args, or secrets are shown in ambient mode.
• No clicks, forms, tabs, or menus required; the trace panel has one compact optional filter.
• Truthful UI Fallback: if the backend is offline, the frontend renders empty telemetry shells instead of invented agent/process data.

Purpose

OpenClaw Control can already provide the deeper operator surface: chats, settings, auth, nodes, plugins, and interactive troubleshooting. Agent Home uses the same local facts for a narrower job:

• show the current agent posture as Quiet, Working, or Needs You
• surface only the top few attention signals
• show recent OpenClaw session messages across source channels in compact ambient form
• show tool calls, PowerShell commands, status, duration, and trimmed output
• filter the trace panel down to manually invoked agent tool commands when collector noise is distracting
• show file edit state for designers: changed paths, line counts, raw patch text, and Git hunks when a baseline exists
• show local safety posture that matters on an always-visible screen
• show verification, jobs, collector flow, and local sensor state in one frame
• stay useful from across the room on a second monitor

Run

cd C:\Users\ronit\.openclaw\workspace\agent-home
npm start

Open:

http://127.0.0.1:18880/

Or use the helper:

.\scripts\Open-AgentHome.ps1 -Fullscreen

The display refreshes itself. The user should not need keyboard shortcuts or manual interaction after launch.

Snapshot & API

npm run snapshot

Designer-friendly UI data:

http://127.0.0.1:18880/api/view

(Note: If the API is offline, the frontend renders empty telemetry panels. It does not invent transcript, process, or reaction data.)

Raw collector data:

http://127.0.0.1:18880/api/snapshot

Windows process transparency:

http://127.0.0.1:18880/api/processes

Reaction forecast:

http://127.0.0.1:18880/api/reaction

/api/reaction is the backend-first answer to "when will the agent react if the future is knowable?" It does not ask the agent to narrate a promise. It derives an honest forecast from local OpenClaw and Windows facts:

• open tool calls in the session trajectory
• running or queued OpenClaw tasks
• process-monitor activities and any trustworthy ETA they expose
• cron next-wake timestamps
• heartbeat intervals and the last heartbeat timestamp
• pending human-message state from the unified local transcript

The response separates active work from scheduled opportunities. It reports

nextKnownAt only when a trustworthy timestamp exists; otherwise it says why the next reaction is unknown, such as "after the running tool returns" or "heartbeat may skip when there is nothing useful to say."

/api/processes is the backend-first progress contract for process visibility. It does not require the agent to pass progress facts. On Windows it samples what the PC can actually expose:

• Win32_Process for PID, parent PID, executable, creation time, and redacted

command line

• Win32_PerfFormattedData_PerfProc_Process for CPU, memory, handles, threads,

and per-process disk/file I/O rates

• Get-NetTCPConnection for TCP connection ownership by process
• bounded local file-growth scans under likely workspace/download/archive roots

and any extra roots listed in AGENT_HOME_PROGRESS_ROOTS

The response separates broad evidence from progress claims:

• processMonitor.processes keeps a redacted, scored list of interesting

Windows processes.

• processMonitor.network.byProcess shows owned TCP sockets and connection

states.

• processMonitor.fileActivity shows recently changed or growing local files.
• processMonitor.activities is the high-level progress lane for likely

user-started work, transfers, builds, and growing outputs.

• progress.etaSeconds is null unless a trustworthy total byte count is

inferable. When ETA is unknown, progress.reason says why instead of guessing.

This means Agent Home can show “rclone is alive, owns these TCP connections, writes 4.2 MB/s to this growing file, ETA unknown because Windows does not expose the final total” without asking the agent to narrate progress.

The snapshot currently collects:

• openclaw status --deep --json
• openclaw sessions --all-agents --limit 50 --json
• openclaw tasks list --json
• openclaw cron status
• openclaw cron list --json
• openclaw security audit --deep
• Windows posture when available
• Windows process transparency and local file-growth progress signals
• reaction forecast from trajectory, tasks, cron, heartbeat, unified transcript, and

process evidence

• recent OpenClaw session transcript JSONL artifacts merged by timestamp
• recent OpenClaw trajectory JSONL artifacts for tool/command events
• Git workspace status/diff for agent-home

The existing Control UI/Gateway can eventually replace the subprocess adapter with authenticated Gateway route/RPC data for the same categories: gateway health, channel state, sessions, tasks/subagents, cron, node status, plugin health, memory/heartbeat status, reaction forecast, and model/provider status.

Release Direction

The local server is an MVP adapter. The release target is a native OpenClaw plugin with Gateway routes and agentHome.snapshot / agentHome.reactionForecast methods.

See docs-plugin-conversion.md.

For UI-only handoff, see DESIGNER-HANDOFF.md.

Release and safety notes:

• PRIVACY.md
• SECURITY.md
• RELEASE.md