fix(cli): improve browser control errors

docs/agents.md

@@ -93,6 +93,12 @@ If you enable the clawd-managed browser (default on), the agent can use:
 
 This uses a dedicated Chrome/Chromium profile (lobster-orange by default) so it doesn’t interfere with your daily browser.
 
+## Debugging `clawdis-mac` errors
+
+When the agent runs `clawdis-mac` (often over SSH), the CLI prints compact, human-readable errors by default.
+
+- To get the full `NSError` dump (domain/code/userInfo), rerun with `CLAWDIS_MAC_VERBOSE_ERRORS=1` in the environment.
+
 ---
 
 *Next: [Group Chats](./group-messages.md)* 🦞

docs/configuration.md

@@ -111,6 +111,7 @@ Defaults:
 - enabled: `true`
 - control URL: `http://127.0.0.1:18791` (CDP uses `18792`)
 - profile color: `#FF4500` (lobster-orange)
+- Note: the control server is started by the running gateway (Clawdis.app menubar, or `clawdis gateway`).
 
 ```json5
 {