docs: clarify mac gateway launch behavior

This commit is contained in:
Peter Steinberger
2026-01-18 16:29:33 +00:00
parent 0b350d78d5
commit 5ec499e14c
3 changed files with 15 additions and 10 deletions

View File

@@ -7,8 +7,8 @@ read_when:
# Clawdbot macOS Companion (menu bar + gateway broker)
The macOS app is the **menubar companion** for Clawdbot. It owns permissions,
manages the Gateway locally, and exposes macOS capabilities to the agent as a
node.
manages/attaches to the Gateway locally (launchd or manual), and exposes macOS
capabilities to the agent as a node.
## What it does
@@ -26,11 +26,11 @@ Planned:
## Local vs remote mode
- **Local** (default): the app ensures a local Gateway is running via launchd.
- **Local** (default): the app attaches to a running local Gateway if present;
otherwise it enables the launchd service via `clawdbot daemon`.
- **Remote**: the app connects to a Gateway over SSH/Tailscale and never starts
a local process.
- **Attachonly** (debug): the app connects to an alreadyrunning local Gateway
and never spawns its own.
The app does not spawn the Gateway as a child process.
## Launchd control