diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index 3ad20b878..d28351bf2 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "759fe0bf95bbe01a2fca40d800f09bc1221af779", - "syncedAt": "2026-04-25T04:49:41.357Z" + "sha": "b0e834b2d95d35afaf11105b832e51158754fce2", + "syncedAt": "2026-04-25T04:51:32.699Z" } diff --git a/docs/.generated/config-baseline.sha256 b/docs/.generated/config-baseline.sha256 index 18beac9d4..89bd8e1b7 100644 --- a/docs/.generated/config-baseline.sha256 +++ b/docs/.generated/config-baseline.sha256 @@ -1,4 +1,4 @@ -b6d1e53947fcdfbff1b99f8ec79d3814d243385a1750b7fb40b40bb30f2e2975 config-baseline.json -98c83ce8af9ec4703726d7d673add95279be008a801b1d298982cbd9c1785747 config-baseline.core.json +d885c14dea2c361123a97a0f6c854f6dbae8592f39daa211173ef7f1fe7d554a config-baseline.json +c991bb527d8efffb5c9a2c5e502113260a2873923d469289c82f7029257fddaf config-baseline.core.json d72032762ab46b99480b57deb81130a0ab5b1401189cfbaf4f7fef4a063a7f6c config-baseline.channel.json -86f615b7d267b03888af0af7ccb3f8232a6b636f8a741d522ff425e46729ba81 config-baseline.plugin.json +0d5ba81f0030bd39b7ae285096276cc18b150836c2252fd2217329fc6154e80e config-baseline.plugin.json diff --git a/docs/cli/config.md b/docs/cli/config.md index ea9cc1283..c35c07f59 100644 --- a/docs/cli/config.md +++ b/docs/cli/config.md @@ -36,6 +36,7 @@ openclaw config --section gateway --section daemon openclaw config schema openclaw config get browser.executablePath openclaw config set browser.executablePath "/usr/bin/google-chrome" +openclaw config set browser.profiles.work.executablePath "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" openclaw config set agents.defaults.heartbeat.every "2h" openclaw config set agents.list[0].tools.exec.node "node-id-or-name" openclaw config set agents.defaults.models '{"openai/gpt-5.4":{}}' --strict-json --merge diff --git a/docs/gateway/configuration-reference.md b/docs/gateway/configuration-reference.md index dd64ae5d1..b47885db1 100644 --- a/docs/gateway/configuration-reference.md +++ b/docs/gateway/configuration-reference.md @@ -175,7 +175,11 @@ See [Plugins](/tools/plugin). }, profiles: { openclaw: { cdpPort: 18800, color: "#FF4500" }, - work: { cdpPort: 18801, color: "#0066CC" }, + work: { + cdpPort: 18801, + color: "#0066CC", + executablePath: "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome", + }, user: { driver: "existing-session", attachOnly: true, color: "#00AA00" }, brave: { driver: "existing-session", @@ -218,6 +222,9 @@ See [Plugins](/tools/plugin). `responsebody`, PDF export, download interception, or batch actions. - Local managed `openclaw` profiles auto-assign `cdpPort` and `cdpUrl`; only set `cdpUrl` explicitly for remote CDP. +- Local managed profiles can set `executablePath` to override the global + `browser.executablePath` for that profile. Use this to run one profile in + Chrome and another in Brave. - Auto-detect order: default browser if Chromium-based → Chrome → Brave → Edge → Chromium → Chrome Canary. - `browser.executablePath` accepts `~` for your OS home directory. - Control service: loopback only (port derived from `gateway.port`, default `18791`). diff --git a/docs/tools/browser.md b/docs/tools/browser.md index 1fe77fe20..51f5d514b 100644 --- a/docs/tools/browser.md +++ b/docs/tools/browser.md @@ -143,7 +143,12 @@ Browser settings live in `~/.openclaw/openclaw.json`. executablePath: "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser", profiles: { openclaw: { cdpPort: 18800, color: "#FF4500" }, - work: { cdpPort: 18801, color: "#0066CC", headless: true }, + work: { + cdpPort: 18801, + color: "#0066CC", + headless: true, + executablePath: "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome", + }, user: { driver: "existing-session", attachOnly: true, @@ -187,6 +192,7 @@ Browser settings live in `~/.openclaw/openclaw.json`. - `attachOnly: true` means never launch a local browser; only attach if one is already running. - `headless` can be set globally or per local managed profile. Per-profile values override `browser.headless`, so one locally launched profile can stay headless while another remains visible. +- `executablePath` can be set globally or per local managed profile. Per-profile values override `browser.executablePath`, so different managed profiles can launch different Chromium-based browsers. - `color` (top-level and per-profile) tints the browser UI so you can see which profile is active. - Default profile is `openclaw` (managed standalone). Use `defaultProfile: "user"` to opt into the signed-in user browser. - Auto-detect order: system default browser if Chromium-based; otherwise Chrome → Brave → Edge → Chromium → Chrome Canary. @@ -205,6 +211,7 @@ auto-detection. `~` expands to your OS home directory: ```bash openclaw config set browser.executablePath "/usr/bin/google-chrome" +openclaw config set browser.profiles.work.executablePath "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" ``` Or set it in config, per platform: @@ -239,6 +246,10 @@ Or set it in config, per platform: +Per-profile `executablePath` only affects local managed profiles that OpenClaw +launches. `existing-session` profiles attach to an already-running browser +instead, and remote CDP profiles use the browser behind `cdpUrl`. + ## Local vs remote control - **Local control (default):** the Gateway starts the loopback control service and can launch a local browser. @@ -246,6 +257,9 @@ Or set it in config, per platform: - **Remote CDP:** set `browser.profiles..cdpUrl` (or `browser.cdpUrl`) to attach to a remote Chromium-based browser. In this case, OpenClaw will not launch a local browser. - `headless` only affects local managed profiles that OpenClaw launches. It does not restart or change existing-session or remote CDP browsers. +- `executablePath` follows the same local managed profile rule. Changing it on a + running local managed profile marks that profile for restart/reconcile so the + next launch uses the new binary. Stopping behavior differs by profile mode: