{
  "title": "~/.config/systemd/user/openclaw-browser.service",
  "content": "[Unit]\nDescription=OpenClaw Browser (Chrome CDP)\nAfter=network.target\n\n[Service]\nExecStart=/snap/bin/chromium --headless --no-sandbox --disable-gpu --remote-debugging-port=18800 --user-data-dir=%h/.openclaw/browser/openclaw/user-data about:blank\nRestart=on-failure\nRestartSec=5\n\n[Install]\nWantedBy=default.target\nbash theme={null}\ncurl -s http://127.0.0.1:18791/ | jq '{running, pid, chosenBrowser}'\nbash theme={null}\ncurl -s -X POST http://127.0.0.1:18791/start\ncurl -s http://127.0.0.1:18791/tabs\n```\n\n| Option                   | Description                                                          | Default                                                     |\n| ------------------------ | -------------------------------------------------------------------- | ----------------------------------------------------------- |\n| `browser.enabled`        | Enable browser control                                               | `true`                                                      |\n| `browser.executablePath` | Path to a Chromium-based browser binary (Chrome/Brave/Edge/Chromium) | auto-detected (prefers default browser when Chromium-based) |\n| `browser.headless`       | Run without GUI                                                      | `false`                                                     |\n| `browser.noSandbox`      | Add `--no-sandbox` flag (needed for some Linux setups)               | `false`                                                     |\n| `browser.attachOnly`     | Don't launch browser, only attach to existing                        | `false`                                                     |\n| `browser.cdpPort`        | Chrome DevTools Protocol port                                        | `18800`                                                     |\n\n### Problem: \"Chrome extension relay is running, but no tab is connected\"\n\nYou’re using the `chrome` profile (extension relay). It expects the OpenClaw\nbrowser extension to be attached to a live tab.\n\n1. **Use the managed browser:** `openclaw browser start --browser-profile openclaw`\n   (or set `browser.defaultProfile: \"openclaw\"`).\n2. **Use the extension relay:** install the extension, open a tab, and click the\n   OpenClaw extension icon to attach it.\n\n* The `chrome` profile uses your **system default Chromium browser** when possible.\n* Local `openclaw` profiles auto-assign `cdpPort`/`cdpUrl`; only set those for remote CDP.",
  "code_samples": [
    {
      "code": "Enable with: `systemctl --user enable --now openclaw-browser.service`\n\n### Verifying the Browser Works\n\nCheck status:",
      "language": "unknown"
    },
    {
      "code": "Test browsing:",
      "language": "unknown"
    }
  ],
  "headings": [
    {
      "level": "h3",
      "text": "Verifying the Browser Works",
      "id": "verifying-the-browser-works"
    },
    {
      "level": "h3",
      "text": "Config Reference",
      "id": "config-reference"
    },
    {
      "level": "h3",
      "text": "Problem: \"Chrome extension relay is running, but no tab is connected\"",
      "id": "problem:-\"chrome-extension-relay-is-running,-but-no-tab-is-connected\""
    }
  ],
  "url": "llms-txt#~/.config/systemd/user/openclaw-browser.service",
  "links": []
}