openclaw/docs/platforms/mac/child-process.md
Jon Shapiro 92697edb7c fix(venice): add compat settings to prevent HTTP 400 errors
Venice's API doesn't support certain OpenAI-compatible parameters that
Clawdbot sends by default:

- `store`: Venice returns HTTP 400 with no body when this is present
- `developer` role: Not supported by Venice's API

This adds VENICE_COMPAT settings (supportsStore: false,
supportsDeveloperRole: false) to all Venice model definitions, both
from the static catalog and dynamically discovered models.

Fixes issues reported in PR #1666 where users experienced silent
failures (HTTP 400, no body) when using Venice models.

Co-authored-by: jonisjongithub <jonisjongithub@users.noreply.github.com>
Co-authored-by: Clawdbot <bot@clawd.bot>
2026-01-26 17:56:01 -08:00

2.3 KiB
Raw Blame History

summary read_when
Gateway lifecycle on macOS (launchd)
Integrating the mac app with the gateway lifecycle

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 alreadyrunning Gateway on the configured port; if none is reachable, it enables the launchd service via the external clawdbot CLI (no embedded runtime). This gives you reliable autostart at login and restart on crashes.

Childprocess 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 peruser LaunchAgent labeled com.clawdbot.gateway (or com.clawdbot.<profile> when using --profile/CLAWDBOT_PROFILE).
  • When Local mode is enabled, the app ensures the LaunchAgent is loaded and starts the Gateway if needed.
  • Logs are written to the launchd gateway log path (visible in Debug Settings).

Common commands:

launchctl kickstart -k gui/$UID/com.clawdbot.gateway
launchctl bootout gui/$UID/com.clawdbot.gateway

Replace the label with com.clawdbot.<profile> when running a named profile.

Unsigned dev builds

scripts/restart-mac.sh --no-sign is for fast local builds when you dont have signing keys. To prevent launchd from pointing at an unsigned relay binary, it:

  • Writes ~/.clawdbot/disable-launchagent.

Signed runs of scripts/restart-mac.sh clear this override if the marker is present. To reset manually:

rm ~/.clawdbot/disable-launchagent

Attach-only mode

To force the macOS app to never install or manage launchd, launch it with --attach-only (or --no-launchd). This sets ~/.clawdbot/disable-launchagent, so the app only attaches to an already running Gateway. You can toggle the same behavior in Debug Settings.

Remote mode

Remote mode never starts a local Gateway. The app uses an SSH tunnel to the remote host and connects over that tunnel.

Why we prefer launchd

  • Autostart at login.
  • Builtin restart/KeepAlive semantics.
  • Predictable logs and supervision.

If a true childprocess mode is ever needed again, it should be documented as a separate, explicit devonly mode.