​

OpenClaw macOS Companion (menyrad + gateway-broker)

​

Vad den gör

• Visar inbyggda notiser och status i menyraden.
• Äger TCC‑prompter (Notiser, Hjälpmedel, Skärminspelning, Mikrofon, Taligenkänning, Automation/AppleScript).
• Kör eller ansluter till Gateway (lokal eller fjärr).
• Exponerar macOS‑specifika verktyg (Canvas, Kamera, Skärminspelning, system.run).
• Startar den lokala nodvärdtjänsten i fjärr‑läge (launchd) och stoppar den i lokalt läge.
• Kan valfritt vara värd för PeekabooBridge för UI‑automation.
• Installerar den globala CLI:n (openclaw) via npm/pnpm på begäran (bun rekommenderas inte för Gateway‑körtiden).

​

Lokalt vs fjärrläge

• Lokalt (standard): appen ansluter till en körande lokal Gateway om den finns; annars aktiverar den launchd‑tjänsten via openclaw gateway install.
• Fjärr: appen ansluter till en Gateway över SSH/Tailscale och startar aldrig en lokal process. Appen startar den lokala node-värdtjänsten så att fjärrporten kan nå denna Mac. Appen spawnar inte Gateway som en barnprocess.

​

Launchd‑styrning

launchctl kickstart -k gui/$UID/bot.molt.gateway
launchctl bootout gui/$UID/bot.molt.gateway

​

Nodfunktioner (mac)

• Canvas: canvas.present, canvas.navigate, canvas.eval, canvas.snapshot, canvas.a2ui.*
• Kamera: camera.snap, camera.clip
• Skärm: screen.record
• System: system.run, system.notify

• När den huvudlösa nodvärdtjänsten kör (fjärrläge) ansluter den till Gateway WS som en nod.
• system.run körs i macOS‑appen (UI/TCC‑kontext) över en lokal Unix‑socket; prompter och utdata stannar i appen.

Gateway -> Node Service (WS)
                 |  IPC (UDS + token + HMAC + TTL)
                 v
             Mac App (UI + TCC + system.run)

​

Exec‑godkännanden (system.run)

~/.openclaw/exec-approvals.json

{
  "version": 1,
  "defaults": {
    "security": "deny",
    "ask": "on-miss"
  },
  "agents": {
    "main": {
      "security": "allowlist",
      "ask": "on-miss",
      "allowlist": [{ "pattern": "/opt/homebrew/bin/rg" }]
    }
  }
}

• allowlist‑poster är globmönster för upplösta binärsökvägar.
• Att välja ”Always Allow” i prompten lägger till kommandot i tillåtelselistan.
• system.run‑miljööverskrivningar filtreras (tar bort PATH, DYLD_*, LD_*, NODE_OPTIONS, PYTHON*, PERL*, RUBYOPT) och slås sedan samman med appens miljö.

​

Djupa länkar

​

openclaw://agent

open 'openclaw://agent?message=Hello%20from%20deep%20link'

• message (krävs)
• sessionKey (valfritt)
• thinking (valfritt)
• deliver / to / channel (valfritt)
• timeoutSeconds (valfritt)
• key (valfri nyckel för obevakat läge)

• Utan key ber appen om bekräftelse.
• Med en giltig key är körningen obevakad (avsedd för personliga automatiseringar).
• Med en giltig key är körningen obevakad (avsedd för personliga automatiseringar).

​

Introduktionsflöde (typiskt)

1. Installera och starta OpenClaw.app.
2. Slutför behörighetschecklistan (TCC‑prompter).
3. Säkerställ att Lokalt läge är aktivt och att Gateway körs.
4. Installera CLI:n om du vill ha terminalåtkomst.

​

Build‑ och dev‑arbetsflöde (native)

• cd apps/macos && swift build
• swift run OpenClaw (eller Xcode)
• Paketera appen: scripts/package-mac-app.sh

​

Felsök gateway‑anslutning (macOS CLI)

cd apps/macos
swift run openclaw-mac connect --json
swift run openclaw-mac discover --timeout 3000 --json

• --url <ws://host:port>: åsidosätt konfig
• --mode <local|remote>: lös från konfig (standard: konfig eller lokal)
• --probe: tvinga en ny hälsokontroll
• --timeout <ms>: timeout för begäran (standard: 15000)
• --json: strukturerad utdata för diffning

• --include-local: inkludera gateways som annars skulle filtreras som ”lokala”
• --timeout <ms>: övergripande discovery‑fönster (standard: 2000)
• --json: strukturerad utdata för diffning

​

Fjärranslutningsrördragning (SSH‑tunnlar)

​

Kontrolltunnel (Gateway WebSocket‑port)

• Syfte: hälsokontroller, status, Web Chat, konfig och andra kontrollplansanrop.
• Lokal port: Gateway‑porten (standard 18789), alltid stabil.
• Fjärrport: samma Gateway‑port på fjärrvärden.
• Beteende: ingen slumpmässig lokal port; appen återanvänder en befintlig frisk tunnel eller startar om den vid behov.
• SSH‑form: ssh -N -L <local>:127.0.0.1:<remote> med BatchMode + ExitOnForwardFailure + keepalive‑alternativ.
• IP-rapportering: SSH-tunneln använder loopback, så gateway kommer att se noden IP som 127.0.0.1. Använd Direkt (ws/wss) transport om du vill att den verkliga klienten IP ska visas (se macOS fjärråtkomst).

​

Relaterad dokumentation

• Gateway runbook
• Gateway (macOS)
• macOS‑behörigheter
• Canvas