From 251fd3af45ff5e35fef1c73b68137b43ddead3c6 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-sync[bot]" Date: Sat, 25 Apr 2026 19:07:32 +0000 Subject: [PATCH] chore(sync): mirror docs from openclaw/openclaw@7d58362f3fa23c29ca06e36f869f7e6b64b6d73c --- .openclaw-sync/source.json | 4 ++-- docs/.generated/config-baseline.sha256 | 4 ++-- docs/gateway/configuration-reference.md | 4 +++- docs/tools/browser.md | 10 ++++++---- 4 files changed, 13 insertions(+), 9 deletions(-) diff --git a/.openclaw-sync/source.json b/.openclaw-sync/source.json index ec3c7a22b..0314cbcd7 100644 --- a/.openclaw-sync/source.json +++ b/.openclaw-sync/source.json @@ -1,5 +1,5 @@ { "repository": "openclaw/openclaw", - "sha": "5eab16e0863f30616e3a7999fb9268330e7a75e3", - "syncedAt": "2026-04-25T19:03:57.345Z" + "sha": "7d58362f3fa23c29ca06e36f869f7e6b64b6d73c", + "syncedAt": "2026-04-25T19:06:03.876Z" } diff --git a/docs/.generated/config-baseline.sha256 b/docs/.generated/config-baseline.sha256 index 0aafcd4e1..630b4ee97 100644 --- a/docs/.generated/config-baseline.sha256 +++ b/docs/.generated/config-baseline.sha256 @@ -1,4 +1,4 @@ -c8d24c55df89a76f44cd6ab5fdb7c28b0b3a8adadcd2c94a1d81263512075c0f config-baseline.json -97c37380e03c167ee710adb0ee297573146e78434635780226b744841628370b config-baseline.core.json +6ed33ef102e7c92816243bfabc3626222a679c3270c12ec5ea47b28b66204b3b config-baseline.json +f86cb4d57ec1f5fd75008be0ab86151194945eb013a47ab4bdeaddafd3780da7 config-baseline.core.json 7cd9c908f066c143eab2a201efbc9640f483ab28bba92ddeca1d18cc2b528bc3 config-baseline.channel.json 7825b56a5b3fcdbe2e09ef8fe5d9f12ac3598435afebe20413051e45b0d1968e config-baseline.plugin.json diff --git a/docs/gateway/configuration-reference.md b/docs/gateway/configuration-reference.md index 978e3bf75..9ad7da2e0 100644 --- a/docs/gateway/configuration-reference.md +++ b/docs/gateway/configuration-reference.md @@ -283,7 +283,9 @@ See [Plugins](/tools/plugin). starts successfully but readiness checks race startup. Both values must be positive integers up to `120000` ms; invalid config values are rejected. - Auto-detect order: default browser if Chromium-based → Chrome → Brave → Edge → Chromium → Chrome Canary. -- `browser.executablePath` accepts `~` for your OS home directory. +- `browser.executablePath` and `browser.profiles..executablePath` both + accept `~` and `~/...` for your OS home directory before Chromium launch. + Per-profile `userDataDir` on `existing-session` profiles is also tilde-expanded. - Control service: loopback only (port derived from `gateway.port`, default `18791`). - `extraArgs` appends extra launch flags to local Chromium startup (for example `--disable-gpu`, window sizing, or debug flags). diff --git a/docs/tools/browser.md b/docs/tools/browser.md index dfa0f3d9e..a399e9286 100644 --- a/docs/tools/browser.md +++ b/docs/tools/browser.md @@ -236,12 +236,12 @@ Browser settings live in `~/.openclaw/openclaw.json`. current process. `OPENCLAW_BROWSER_HEADLESS=0` forces headed mode for ordinary starts and returns an actionable error on Linux hosts without a display server; an explicit `start --headless` request still wins for that one launch. -- `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. +- `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. Both forms accept `~` for your OS home directory. - `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. - `driver: "existing-session"` uses Chrome DevTools MCP instead of raw CDP. Do not set `cdpUrl` for that driver. -- Set `browser.profiles..userDataDir` when an existing-session profile should attach to a non-default Chromium user profile (Brave, Edge, etc.). +- Set `browser.profiles..userDataDir` when an existing-session profile should attach to a non-default Chromium user profile (Brave, Edge, etc.). This path also accepts `~` for your OS home directory. @@ -251,7 +251,8 @@ Browser settings live in `~/.openclaw/openclaw.json`. If your **system default** browser is Chromium-based (Chrome/Brave/Edge/etc), OpenClaw uses it automatically. Set `browser.executablePath` to override -auto-detection. `~` expands to your OS home directory: +auto-detection. Top-level and per-profile `executablePath` values accept `~` +for your OS home directory: ```bash openclaw config set browser.executablePath "/usr/bin/google-chrome" @@ -533,7 +534,8 @@ Default behavior: - The built-in `user` profile uses Chrome MCP auto-connect, which targets the default local Google Chrome profile. -Use `userDataDir` for Brave, Edge, Chromium, or a non-default Chrome profile: +Use `userDataDir` for Brave, Edge, Chromium, or a non-default Chrome profile. +`~` expands to your OS home directory: ```json5 {