Närvaro¶

OpenClaw ”närvaro” är en lättviktig vy enligt best effort av:

• Gatewayn själv, och
• klienter som är anslutna till Gateway (mac-app, WebChat, CLI, osv.)

Närvaro används främst för att rendera macOS-appens flik Instances och för att ge operatörer snabb överblick.

Närvarofält (vad som visas)¶

Närvaroposter är strukturerade objekt med fält som:

• instanceId (valfritt men starkt rekommenderat): stabil klientidentitet (vanligen connect.client.instanceId)
• host: lättläst värdnamn
• ip: IP-adress enligt best effort
• version: klientens versionssträng
• deviceFamily / modelIdentifier: hårdvaruindikationer
• mode: ui, webchat, cli, backend, probe, test, node, ...
• lastInputSeconds: ”sekunder sedan senaste användarinmatning” (om känt)
• reason: self, connect, node-connected, periodic, ...
• ts: tidsstämpel för senaste uppdatering (ms sedan epok)

Producenter (var närvaro kommer ifrån)¶

Närvaroposter produceras av flera källor och slås samman.

1. Gatewayns egen post¶

Gateway skapar alltid en ”egen”-post vid uppstart så att UI:er visar gateway-värden redan innan några klienter ansluter.

2. WebSocket-anslutning¶

Varje WS-klient börjar med en connect-begäran. Vid lyckad handskakning höjer Gateway en närvaropost för den anslutningen.

Varför engångskommandon i CLI inte syns¶

CLI ansluter ofta för korta, one‐off kommandon. För att undvika spamming av listan instanser, client.mode === "cli" är inte förvandlas till en närvaropost.

3. system-event-beacons¶

Klienter kan skicka rikare periodiska fyrar via system-event-metoden. Appen mac använder detta för att rapportera värdnamn, IP och lastInputSeconds.

4. Nodanslutningar (roll: node)¶

När en nod ansluter via Gateway-WebSocket med role: node uppdaterar Gateway (en upsert) en närvaropost för den noden (samma flöde som för andra WS-klienter).

Sammanfogning + deduplicering (varför instanceId är viktigt)¶

Närvaroposter lagras i en enda minnesbaserad map:

• Poster nycklas med en närvaronyckel.
• Den bästa nyckeln är en stabil instanceId (från connect.client.instanceId) som överlever omstarter.
• Nycklar är skiftlägesokänsliga.

Om en klient återansluter utan en stabil instanceId kan den visas som en duplicerad rad.

TTL och begränsad storlek¶

Närvaro är avsiktligt flyktig:

• TTL: poster äldre än 5 minuter rensas bort
• Max antal poster: 200 (äldsta tas bort först)

Detta håller listan aktuell och undviker obegränsad minnestillväxt.

Fjärr-/tunnel-varning (loopback-IP:n)¶

När en klient ansluter över en SSH-tunnel / lokal port framåt kan Gateway se fjärradressen som 127.0.0.1. För att undvika att skriva över en bra klientrapporterad IP-adresser ignoreras.

Konsumenter¶

macOS-fliken Instances¶

MacOS-appen renderar utdata från system-presence och tillämpar en liten statusindikator (Active/Idle/Stale) baserat på åldern på den senaste uppdateringen.

Felsökningstips¶

• För att se rålistan, anropa system-presence mot Gateway.
• Om du ser dubbletter:
• bekräfta att klienter skickar en stabil client.instanceId i handskakningen
• bekräfta att periodiska beacons använder samma instanceId
• kontrollera om den anslutningshärledda posten saknar instanceId (dubbletter är förväntade)