Menubalk

Wat wordt weergegeven

• De huidige werkstatus van de agent wordt weergegeven in het menubalkpictogram en in de eerste statusrij van het menu.
• De gezondheidsstatus wordt verborgen zolang er actief werk wordt uitgevoerd; deze keert terug zodra alle sessies inactief zijn.
• Een hoofditem 'Context' opent een submenu met recente sessies in plaats van deze in het hoofdmenu uit te vouwen.
• Een blok 'Nodes' in het hoofdmenu vermeldt alleen gekoppelde apparaten (uit node.list), geen client-/aanwezigheidsvermeldingen.
• Een hoofdsectie 'Gebruik' verschijnt onder Context wanneer momentopnamen van het providergebruik beschikbaar zijn, gevolgd door kostengegevens indien beschikbaar.

Statusmodel

• Bron: WorkActivityStore (apps/macos/Sources/OpenClaw/WorkActivityStore.swift).
• Gebeurtenissen komen binnen als ControlAgentEvent met een runId; de afhandelingsfunctie (ControlChannel.routeWorkActivity) leest sessionKey uit de gebeurtenispayload en gebruikt standaard "main" als deze ontbreekt.
• Prioriteit: de hoofdsessie (standaard sessionKey == "main") heeft altijd voorrang. Als de hoofdsessie actief is, wordt de status daarvan onmiddellijk weergegeven. Als de hoofdsessie inactief is, wordt in plaats daarvan de meest recent actieve niet-hoofdsessie weergegeven. De opslag wisselt niet tijdens een activiteit; er wordt alleen gewisseld wanneer de huidige sessie inactief wordt of de hoofdsessie actief wordt.
• Activiteitstypen:
  • job: uitvoering van opdrachten op hoog niveau (state: started|streaming|done|error|...).
  • tool: phase: start|result met name en optioneel meta/args.

IconState-enum (Swift)

• idle
• workingMain(ActivityKind)
• workingOther(ActivityKind)
• overridden(ActivityKind) (foutopsporingsoverschrijving)

ActivityKind -> badgesymbool

ActivityKind omvat een ToolKind (bash, read, write, edit, attach, other) of een losse job. Elk type wordt toegewezen aan een SF Symbols-badge die over het beestjespictogram wordt getekend (IconState.badgeSymbolName):

Visuele toewijzing

• idle: normaal beestje, geen badge.
• workingMain: badge met symbool, volledige tint (prominentie .primary), 'werk'-animatie van de poten.
• workingOther: badge met symbool, gedempte tint (prominentie .secondary), geen renbeweging.
• overridden: gebruikt het gekozen symbool en de gekozen tint, ongeacht de werkelijke activiteit.

Submenu Context

• Het hoofdmenu toont één rij 'Context' met een aantal sessies/status; hiermee wordt een submenu (MenuSessionsInjector) geopend.
• De kop van het submenu toont het aantal actieve sessies van de afgelopen 24 uur.
• Elke sessierij behoudt de tokenbalk, leeftijd, het voorbeeld, de schakelaar voor denken/uitgebreide uitvoer en de acties voor opnieuw instellen, comprimeren en verwijderen.
• Meldingen over laden, een verbroken verbinding en fouten bij het laden van sessies worden in het submenu Context weergegeven.
• De secties voor gebruik en kosten blijven op hoofdniveau onder Context staan, zodat ze in één oogopslag zichtbaar blijven zonder het submenu te openen.

Tekst van de statusrij (menu)

• Terwijl er actief wordt gewerkt: &lt;Session role&gt; · <activity label> ("\(roleLabel) · \(activity.label)" in MenuContentView), waarbij het rollabel Main of Other is.
• Bij inactiviteit: valt terug op het gezondheidsoverzicht.

Gebeurtenisverwerking

• Bron: agent-gebeurtenissen van het besturingskanaal, gerouteerd door ControlChannel.routeWorkActivity(from:).
• Geparseerde velden:
  • stream: "job" met data.state voor starten/stoppen.
  • stream: "tool" met data.phase, data.name en optioneel data.meta/data.args.
• Toollabels zijn afkomstig van ToolDisplayRegistry.resolve(name:args:meta:); niet-herkende namen vallen terug op de onbewerkte toolnaam.

Foutopsporingsoverschrijving

• Settings > Debug > kiezer "Icon override":
  • System (auto) (standaard)
  • Working: main / Working: other (per soort tool: bash, lezen, schrijven, bewerken, overig)
  • Idle
• Opgeslagen onder de UserDefaults-sleutel openclaw.iconOverride; toegewezen aan IconState.overridden.

Testchecklist

• Activeer een taak in de hoofdsessie: het pictogram verandert onmiddellijk en de statusrij toont het hoofdlabel.
• Activeer een taak in een andere sessie terwijl de hoofdsessie inactief is: het pictogram/de status toont de andere sessie en blijft stabiel totdat deze is voltooid.
• Start de hoofdsessie terwijl een andere sessie actief is: het pictogram schakelt onmiddellijk over naar de hoofdsessie.
• Snelle opeenvolging van toolactiviteiten: de badge flikkert niet (respijtperiode van 2 seconden voordat een voltooide tool wordt gewist, WorkActivityStore.toolResultGrace).
• De statusrij voor de systeemgezondheid verschijnt opnieuw zodra alle sessies inactief zijn.

Gerelateerd

• macOS-app
• Menubalkpictogram