{"id":277,"date":"2026-03-21T22:47:25","date_gmt":"2026-03-21T14:47:25","guid":{"rendered":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/tools-browser-linux-troubleshooting\/"},"modified":"2026-03-21T23:08:52","modified_gmt":"2026-03-21T15:08:52","slug":"tools-browser-linux-troubleshooting","status":"publish","type":"post","link":"https:\/\/pa.yingzhi8.cn\/index.php\/2026\/03\/21\/tools-browser-linux-troubleshooting\/","title":{"rendered":"\u6d4f\u89c8\u5668\u6545\u969c\u6392\u9664"},"content":{"rendered":"

\u6d4f\u89c8\u5668\u6545\u969c\u6392\u9664<\/h1>\n

\u6d4f\u89c8\u5668\u6545\u969c\u6392\u9664\uff08Linux\uff09<\/h1>\n

\u95ee\u9898\uff1a”Failed to start Chrome CDP on port 18800″<\/h2>\n

OpenClaw \u7684\u6d4f\u89c8\u5668\u63a7\u5236\u670d\u52a1\u5668\u65e0\u6cd5\u542f\u52a8 Chrome\/Brave\/Edge\/Chromium\uff0c\u51fa\u73b0\u4ee5\u4e0b\u9519\u8bef\uff1a<\/p>\n

{"error":"Error: Failed to start Chrome CDP on port 18800 for profile "openclaw"."}\n<\/code><\/pre>\n
\u6839\u672c\u539f\u56e0<\/h3>\n
\u5728 Ubuntu\uff08\u548c\u8bb8\u591a Linux \u53d1\u884c\u7248\uff09\u4e0a\uff0c\u9ed8\u8ba4\u7684 Chromium \u5b89\u88c5\u662f snap \u5305<\/strong>\u3002Snap \u7684 AppArmor \u9650\u5236\u4f1a\u5e72\u6270 OpenClaw \u542f\u52a8\u548c\u76d1\u63a7\u6d4f\u89c8\u5668\u8fdb\u7a0b\u7684\u65b9\u5f0f\u3002<\/p>\n
apt install chromium<\/code> \u547d\u4ee4\u5b89\u88c5\u7684\u662f\u4e00\u4e2a\u91cd\u5b9a\u5411\u5230 snap \u7684\u5b58\u6839\u5305\uff1a<\/p>\n
Note, selecting 'chromium-browser' instead of 'chromium'\nchromium-browser is already the newest version (2:1snap1-0ubuntu2).\n<\/code><\/pre>\n
\u8fd9\u4e0d\u662f\u771f\u6b63\u7684\u6d4f\u89c8\u5668\u2014\u2014\u5b83\u53ea\u662f\u4e00\u4e2a\u5305\u88c5\u5668\u3002<\/p>\n
\u89e3\u51b3\u65b9\u6848 1\uff1a\u5b89\u88c5 Google Chrome\uff08\u63a8\u8350\uff09<\/h3>\n
\u5b89\u88c5\u5b98\u65b9 Google Chrome .deb<\/code> \u5305\uff0c\u5b83\u4e0d\u53d7 snap \u6c99\u7bb1\u9650\u5236\uff1a<\/p>\n
“`bash  theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
\nwget https:\/\/dl.google.com\/linux\/direct\/google-chrome-stable_current_amd64.deb
\nsudo dpkg -i google-chrome-stable_current_amd64.deb
\nsudo apt –fix-broken install -y  # if there are dependency errors<\/p>\n
\n\u7136\u540e\u66f4\u65b0\u4f60\u7684 OpenClaw \u914d\u7f6e\uff08`~\/.openclaw\/openclaw.json`\uff09\uff1a\n\n```json  theme={"theme":{"light":"min-light","dark":"min-dark"}}\n{\n  "browser": {\n    "enabled": true,\n    "executablePath": "\/usr\/bin\/google-chrome-stable",\n    "headless": true,\n    "noSandbox": true\n  }\n}\n<\/code><\/pre>\n
\u89e3\u51b3\u65b9\u6848 2\uff1a\u4f7f\u7528 Snap Chromium \u7684\u4ec5\u9644\u52a0\u6a21\u5f0f<\/h3>\n
\u5982\u679c\u4f60\u5fc5\u987b\u4f7f\u7528 snap Chromium\uff0c\u914d\u7f6e OpenClaw \u9644\u52a0\u5230\u624b\u52a8\u542f\u52a8\u7684\u6d4f\u89c8\u5668\uff1a<\/p>\n
    \n
  1. \u66f4\u65b0\u914d\u7f6e\uff1a<\/li>\n<\/ol>\n
    “`json  theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}
    \n{
    \n  “browser”: {
    \n    “enabled”: true,
    \n    “attachOnly”: true,
    \n    “headless”: true,
    \n    “noSandbox”: true
    \n  }
    \n}<\/p>\n
    \n2. \u624b\u52a8\u542f\u52a8 Chromium\uff1a\n\n```bash  theme={"theme":{"light":"min-light","dark":"min-dark"}}\nchromium-browser --headless --no-sandbox --disable-gpu \n  --remote-debugging-port=18800 \n  --user-data-dir=$HOME\/.openclaw\/browser\/openclaw\/user-data \n  about:blank &\n<\/code><\/pre>\n
      \n
    1. \u53ef\u9009\u521b\u5efa systemd \u7528\u6237\u670d\u52a1\u4ee5\u81ea\u52a8\u542f\u52a8 Chrome\uff1a<\/li>\n<\/ol>\n
      “`ini  theme={“theme”:{“light”:”min-light”,”dark”:”min-dark”}}<\/p>\n
      ~\/.config\/systemd\/user\/openclaw-browser.service<\/h1>\n
      [Unit]
      \nDescription=OpenClaw Browser (Chrome CDP)
      \nAfter=network.target<\/p>\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<\/p>\n
      [Install]
      \nWantedBy=default.target<\/p>\n
      \n\u542f\u7528\uff1a`systemctl --user enable --now openclaw-browser.service`\n\n### \u9a8c\u8bc1\u6d4f\u89c8\u5668\u662f\u5426\u5de5\u4f5c\n\n\u68c0\u67e5\u72b6\u6001\uff1a\n\n```bash  theme={"theme":{"light":"min-light","dark":"min-dark"}}\ncurl -s http:\/\/127.0.0.1:18791\/ | jq '{running, pid, chosenBrowser}'\n<\/code><\/pre>\n
      \u6d4b\u8bd5\u6d4f\u89c8\uff1a<\/p>\n
      bash  theme={\"theme\":{\"light\":\"min-light\",\"dark\":\"min-dark\"}}
      \ncurl -s -X POST http:\/\/127.0.0.1:18791\/start
      \ncurl -s http:\/\/127.0.0.1:18791\/tabs<\/code><\/p>\n
      \u914d\u7f6e\u53c2\u8003<\/h3>\n\n\n\n\n\n\n\n\n\n\n
      \u9009\u9879<\/th>\n\u63cf\u8ff0<\/th>\n\u9ed8\u8ba4\u503c<\/th>\n<\/tr>\n<\/thead>\n
      browser.enabled<\/code><\/td>\n\u542f\u7528\u6d4f\u89c8\u5668\u63a7\u5236<\/td>\ntrue<\/code><\/td>\n<\/tr>\n
      browser.executablePath<\/code><\/td>\nChromium \u7cfb\u6d4f\u89c8\u5668\u4e8c\u8fdb\u5236\u6587\u4ef6\u8def\u5f84\uff08Chrome\/Brave\/Edge\/Chromium\uff09<\/td>\n\u81ea\u52a8\u68c0\u6d4b\uff08\u5f53\u9ed8\u8ba4\u6d4f\u89c8\u5668\u662f Chromium \u7cfb\u65f6\u4f18\u5148\u4f7f\u7528\uff09<\/td>\n<\/tr>\n
      browser.headless<\/code><\/td>\n\u65e0 GUI \u8fd0\u884c<\/td>\nfalse<\/code><\/td>\n<\/tr>\n
      browser.noSandbox<\/code><\/td>\n\u6dfb\u52a0 --no-sandbox<\/code> \u6807\u5fd7\uff08\u67d0\u4e9b Linux \u8bbe\u7f6e\u9700\u8981\uff09<\/td>\nfalse<\/code><\/td>\n<\/tr>\n
      browser.attachOnly<\/code><\/td>\n\u4e0d\u542f\u52a8\u6d4f\u89c8\u5668\uff0c\u4ec5\u9644\u52a0\u5230\u73b0\u6709\u6d4f\u89c8\u5668<\/td>\nfalse<\/code><\/td>\n<\/tr>\n
      browser.cdpPort<\/code><\/td>\nChrome DevTools Protocol \u7aef\u53e3<\/td>\n18800<\/code><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
      \u95ee\u9898\uff1a”Chrome extension relay is running, but no tab is connected”<\/h3>\n
      \u4f60\u6b63\u5728\u4f7f\u7528 chrome<\/code> \u914d\u7f6e\u6587\u4ef6\uff08\u6269\u5c55\u4e2d\u7ee7\uff09\u3002\u5b83\u671f\u671b OpenClaw \u6d4f\u89c8\u5668\u6269\u5c55\u9644\u52a0\u5230\u4e00\u4e2a\u6d3b\u52a8\u6807\u7b7e\u9875\u3002<\/p>\n
      \u4fee\u590d\u9009\u9879\uff1a<\/p>\n
        \n
      1. \u4f7f\u7528\u6258\u7ba1\u6d4f\u89c8\u5668\uff1a<\/strong> openclaw browser start --browser-profile openclaw<\/code>
        \n   \uff08\u6216\u8bbe\u7f6e browser.defaultProfile: \"openclaw\"<\/code>\uff09\u3002<\/li>\n
      2. \u4f7f\u7528\u6269\u5c55\u4e2d\u7ee7\uff1a<\/strong> \u5b89\u88c5\u6269\u5c55\uff0c\u6253\u5f00\u4e00\u4e2a\u6807\u7b7e\u9875\uff0c\u7136\u540e\u70b9\u51fb OpenClaw \u6269\u5c55\u56fe\u6807\u6765\u9644\u52a0\u5b83\u3002<\/li>\n<\/ol>\n
        \u6ce8\u610f\u4e8b\u9879\uff1a<\/p>\n
          \n
        • chrome<\/code> \u914d\u7f6e\u6587\u4ef6\u5728\u53ef\u80fd\u65f6\u4f7f\u7528\u4f60\u7684\u7cfb\u7edf\u9ed8\u8ba4 Chromium \u6d4f\u89c8\u5668<\/strong>\u3002<\/li>\n
        • \u672c\u5730 openclaw<\/code> \u914d\u7f6e\u6587\u4ef6\u81ea\u52a8\u5206\u914d cdpPort<\/code>\/cdpUrl<\/code>\uff1b\u4ec5\u4e3a\u8fdc\u7a0b CDP \u8bbe\u7f6e\u8fd9\u4e9b\u3002<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
          \u6d4f\u89c8\u5668\u6545\u969c\u6392\u9664 \u6d4f\u89c8\u5668\u6545\u969c\u6392\u9664\uff08Linux\uff09 \u95ee\u9898\uff1a”Failed to start Chrome […]<\/p>\n","protected":false},"author":0,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"class_list":["post-277","post","type-post","status-publish","format-standard","hentry","category-docs"],"_links":{"self":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/277","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/types\/post"}],"replies":[{"embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/comments?post=277"}],"version-history":[{"count":1,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/277\/revisions"}],"predecessor-version":[{"id":572,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/posts\/277\/revisions\/572"}],"wp:attachment":[{"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/media?parent=277"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/categories?post=277"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/pa.yingzhi8.cn\/index.php\/wp-json\/wp\/v2\/tags?post=277"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}