Running an OpenClaw browser agent on a 24/7 or short-to-mid-term leased bare-metal remote Mac is a common 2026 topology for growth, QA, and RPA teams: your laptop holds orchestration while gateway and a managed Chromium profile stay in the data center. The stable line is 2026.5.2 per docs.openclaw.ai browser documentation. This article covers greenfield deploy, CDP/attachOnly troubleshooting, TCC acceptance, and lease/hardware decisions โ not loopback token wiring (see loopback token cross-checks with doctor and probe) or remote-gateway lease basics (see short-to-mid remote Gateway Mac leasing).
1. Scope: managed profile vs attachOnly vs Remote CDP
| Mode | Who starts the browser | Typical config | Remote Mac fit |
|---|---|---|---|
Managed openclaw profile | OpenClaw launches isolated Chromium | browser.profiles.openclaw | Default choice โ isolated login state |
| attachOnly | You or a third party already started it | attachOnly: true + cdpUrl | Browserless, loopback debug ports |
| Remote CDP | Chromium elsewhere | cdpUrl: wss://... | Node host relay or SSH tunnel |
When not to use attachOnly on day one: since 2026.3.22 the Chrome extension relay is gone โ existing-session cannot cross an SSH-only headless session; use Node host or Remote CDP instead. If you only need isolated automation, do not attach a personal Chrome profile.
2. Greenfield deploy on US East / APAC remote Mac (2026.5.x)
- Node 22 or 24 with a single global npm prefix.
- Install:
curl -fsSL https://openclaw.ai/install.sh | bashornpm i -g openclaw@latest. openclaw onboard: setbrowser.enabled; addtools.alsoAllow: ["browser"]for agents that need the tool.- launchd for always-on Gateway (default 18789); browser control service is roughly
gateway.port + 2. openclaw gateway probefor liveness.openclaw browser --browser-profile openclaw doctorโstartโstatus --json.
openclaw backup create โ openclaw doctor --fix โ openclaw gateway restart, then re-run browser doctor per profile. See also 2026.5.x upgrade with Gateway probe and doctor.3. browser.profiles and per-profile CDP port plan
| Profile | cdpPort | Notes |
|---|---|---|
| openclaw | 18800 | Default managed |
| work | 18801 | Optional headless batch lane |
| browserless | โ | cdpUrl + attachOnly: true |
Local pools allocate from 18800โ18899. Multiple Gateways on one host must stagger ports. For stale cdpUrl after restarts: remove expired WebSocket URLs from config, gateway restart, then browser start. Loopback Browserless on the same host needs attachOnly: true or OpenClaw may treat the port as a managed profile and report ownership conflicts.
4. TCC and Screen Recording: SSH-only vs VNC
| Permission | SSH only | VNC |
|---|---|---|
| Automation / Accessibility | Cannot complete first grant | System Settings โ Privacy |
| Screen Recording | Snapshots may be black | Grant then re-test snapshot |
See macOS TCC, Node 24, and remote Gateway workflow; SSH/VNC delivery is in the help center.
5. doctor / status / probe and CDP troubleshooting tree
- L0 Gateway:
openclaw doctorโgateway statusโgateway status --require-rpcโgateway probe - L1 Browser:
openclaw browser --browser-profile <name> doctor [--deep]โstatus --json - L2 CDP HTTP:
curl -s http://127.0.0.1:<cdpPort>/json/version
| Symptom | Action |
|---|---|
| profile not running | With attachOnly, start Chromium first; or switch to managed profile |
| cdpReady false | Free the port; raise localCdpReadyTimeoutMs on slow hosts |
| stale cdpUrl | Clear config โ gateway restart โ browser start |
| token / auth mismatch | Align gateway.auth.token with client headers; see loopback article above |
6. Reference workflows (architecture only)
- Competitive monitoring: managed profile + Cron โ
snapshotโ object storage; keep large artifacts off the operator laptop. - Form-fill QA: separate
workprofile; on failure, reproduce headed over VNC. - Skill batch jobs: scale out to multiple machines โ do not stack many profiles on one host all fighting for 18800.
7. Same-host split: browser agent vs Xcode / Runner
Keep browser agents on a lower-tier M4 with large disk; spill xcodebuild Archive and heavy compiles to a high-memory node. If you must co-locate, separate user data directories and stagger launchd schedules. Disk queue patterns: enterprise Mac CI cache partitions and NVMe FAQใ
8. US East vs APAC: latency and screenshot/PDF egress
| Operators based in | Prefer node | Typical RTT |
|---|---|---|
| Mainland China / Southeast Asia | Singapore, Hong Kong, Tokyo | ~30โ80 ms |
| North America | US West entry | ~60โ90 ms cross-US |
| Hard cross-continent pairing | Avoid if possible | 130โ190 ms+ |
Large PDF or screenshot pulls hurt more on high RTT โ place storage close to the browser host, not your laptop.
9. Three M4 tiers + 1TB/2TB parallel vs single M4 Pro
| Dimension | Tier A + 1TB | Two tier-A + 2TB | Single M4 Pro |
|---|---|---|---|
| Cache / snapshots | Single profile, weekly cleanup | Profile isolation per host | More RAM, less swap |
| Short-to-mid cost | Lower week/month rent | Burst with daily add-on hosts | Expensive when idle |
| When not to choose | Many profiles fighting RAM | You dislike multi-port ops | One light profile only |
Pricing and stock: pricing page and checkout โ figures here are decision framing, not quotes.
10. SSH tunnel vs Tailscale Serve (browser angle)
SSH -L forwarding for 18789 and 18800 lets your laptop call remote Gateway/CDP locally; carry the gateway token on every client. Tailscale Serve suits stable team entry points. The standalone loopback browser HTTP API does not honor Tailscale identity headers โ you still need shared-secret auth (see site Tailscale articles for install; this post only compares browser access patterns). Do not expose CDP ports on the public internet.
11. Upgrade and rollback
openclaw updateโbackup createโdoctor --fixโgateway restart- Per profile:
browser stopโstart - Rollback: restore backup and pin version; avoid copying profile dirs across major versions
Blue/green on long leases: remote Mac blue/green rolling on port 18789. Multi-team isolation: shared remote Mac gateway boundaries.
12. FAQ
- Is one week enough to validate? Yes if onboard + single-profile
snapshotpasses doctor and probe. - attachOnly says not running?
curl /json/versionfirst; upgrade to 2026.5.2+; clear stalecdpUrl. - Can we skip VNC? Gateway can stay CLI-only; first TCC grants need graphics.
- Multiple profiles in parallel? Limited by RAM and
tabCleanupโ prefer separate hosts. - Headless on remote Mac? Without DISPLAY, managed profiles may auto-headless; screenshots still need Screen Recording.
- Coexist with Runner? Separate users or machines; do not share disk with DerivedData.
- US East or APAC? Section 8; mainland/SEA teams usually pick APAC.
- 1TB vs 2TB? Choose 2TB if you keep 30+ days of snapshots.
- Missing
openclaw browser? Checkplugins.allowincludesbrowserandbrowser.enabled. - All CDP dead after upgrade?
doctor --fix, restart Gateway, rebuild profiles one by one. - When not to run two tier-A hosts? Single light profile and no compile spill โ one M4 Pro is simpler but costly when idle.
Why a remote Mac mini fits always-on browser agents
Apple Silicon unified memory helps multi-tab Chromium; Mac mini power draw suits 24/7 Gateway; macOS keeps TCC and VNC delivery consistent with what operators already know. You need isolated profiles plus disk headroom for cache and snapshots, not a second laptop left open.
Compare US West and APAC nodes, three M4 tiers, and 1TB/2TB expansion on the Macstripe home page; list prices on the pricing page; SSH/VNC setup in the help center.