vultr/openclaw
1
0
Fork 0
mirror of https://github.com/openclaw/openclaw.git synced 2026-05-06 14:50:45 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: typography hygiene + 2 in-body H1 removals across 5 pages

Browse Source
This commit is contained in:
Vincent Koc
2026-05-05 21:01:08 -07:00
parent f35fb7288a
commit 0d73f174a9
5 changed files with 24 additions and 28 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
docs/platforms/mac/child-process.md
View File

@@ -2,23 +2,21 @@
summary: "Gateway lifecycle on macOS (launchd)"
read_when:
- Integrating the mac app with the gateway lifecycle
title: "Gateway lifecycle"
title: "Gateway lifecycle on macOS"
---
# Gateway lifecycle on macOS
The macOS app **manages the Gateway via launchd** by default and does not spawn
the Gateway as a child process. It first tries to attach to an already‑running
the Gateway as a child process. It first tries to attach to an already-running
Gateway on the configured port; if none is reachable, it enables the launchd
service via the external `openclaw` CLI (no embedded runtime). This gives you
reliable auto‑start at login and restart on crashes.
reliable auto-start at login and restart on crashes.
Child‑process mode (Gateway spawned directly by the app) is **not in use** today.
Child-process mode (Gateway spawned directly by the app) is **not in use** today.
If you need tighter coupling to the UI, run the Gateway manually in a terminal.
## Default behavior (launchd)
- The app installs a per‑user LaunchAgent labeled `ai.openclaw.gateway`
- The app installs a per-user LaunchAgent labeled `ai.openclaw.gateway`
(or `ai.openclaw.<profile>` when using `--profile`/`OPENCLAW_PROFILE`; legacy `com.openclaw.*` is supported).
- When Local mode is enabled, the app ensures the LaunchAgent is loaded and
starts the Gateway if needed.
@@ -35,7 +33,7 @@ Replace the label with `ai.openclaw.<profile>` when running a named profile.
## Unsigned dev builds
`scripts/restart-mac.sh --no-sign` is for fast local builds when you don’t have
`scripts/restart-mac.sh --no-sign` is for fast local builds when you don't have
signing keys. To prevent launchd from pointing at an unsigned relay binary, it:
- Writes `~/.openclaw/disable-launchagent`.
@@ -61,12 +59,12 @@ remote host and connects over that tunnel.
## Why we prefer launchd
- Auto‑start at login.
- Built‑in restart/KeepAlive semantics.
- Auto-start at login.
- Built-in restart/KeepAlive semantics.
- Predictable logs and supervision.
If a true child‑process mode is ever needed again, it should be documented as a
separate, explicit dev‑only mode.
If a true child-process mode is ever needed again, it should be documented as a
separate, explicit dev-only mode.
## Related