#Integration error
1 messages · Page 1 of 1 (latest)
“Stuck in debugging” usually means the Chrome extension relay never fully connects/attaches (or it attaches, but OpenClaw can’t talk to the local relay).
A few high-signal checks (most common causes first):
- What do you mean by “debugging”?
- Is the extension badge showing
…(connecting) or!(relay not reachable/auth)? - Or is OpenClaw CLI/UI stuck while trying to use
profile=chrome?
- Port + token mismatch (super common)
- The extension “Port” must be the relay port, not the gateway port.
- By default: Gateway
18789⇒ Relay18792 - If you changed the Gateway port: Relay Port = Gateway Port + 3
- Example: gateway
19001⇒ relay19004
- Example: gateway
- Extension “Gateway token” must match
gateway.auth.token/OPENCLAW_GATEWAY_TOKEN
- No tab is actually attached
- The relay only controls tabs where you clicked the toolbar icon and the badge shows ON.
- If nothing is attached, OpenClaw will sit there with “no tab connected” vibes.
- Remote gateway? You need a node host on the Chrome machine
If your Gateway is on a different box than your Chrome, you generally need to run a node host where Chrome is:
openclaw node run --host <gateway-host> --port <gateway-port> --display-name "Chrome Node"
…and then approve it on the gateway:openclaw devices listopenclaw devices approve <requestId>
Docs: https://docs.openclaw.ai/nodes
If you paste the output of these 4 commands (and tell me what the extension badge shows), I can usually pinpoint it immediately:
openclaw --version
openclaw gateway status
openclaw browser --browser-profile chrome status --json
openclaw browser --browser-profile chrome tabs --json
Microsoft Windows [Version 10.0.26200.8037]
(c) Microsoft Corporation. All rights reserved.
C:\Windows\System32>openclaw --version
OpenClaw 2026.3.12 (6472949)
C:\Windows\System32>openclaw gateway status
🦞 OpenClaw 2026.3.12 (6472949) — I've read more man pages than any human should—so you don't have to.
|
penclaw browser --browser-profile chrome status --json
openclaw browser --browser-profile chrome tabs --jsono
Service: Scheduled Task (missing)
File logs: ~\AppData\Local\Temp\openclaw\openclaw-2026-03-14.log
Config (cli): ~.openclaw\openclaw.json
Config (service): ~.openclaw\openclaw.json
Gateway: bind=loopback (127.0.0.1), port=18789 (env/config)
Probe target: ws://127.0.0.1:18789
Dashboard: http://127.0.0.1:18789/
Probe note: Loopback-only gateway; only local clients can connect.
Runtime: stopped (ERROR: The system cannot find the file specified.)
RPC probe: failed
RPC target: ws://127.0.0.1:18789
gateway closed (1006 abnormal closure (no close frame)): no close reason
Gateway target: ws://127.0.0.1:18789
Source: cli --url
Config: C:\Users\zephyrus.openclaw\openclaw.json
Service unit not found.
Service not installed. Run: openclaw gateway install
File logs: C:\Users\zephyrus\AppData\Local\Temp\openclaw\openclaw-2026-03-14.log
Troubles: run openclaw status
Troubleshooting: https://docs.openclaw.ai/troubleshooting
C:\Windows\System32>
so?
Your relay is “stuck” because the Gateway isn’t running at all.
From your openclaw gateway status:
- Service: Scheduled Task (missing) → the Windows auto-start task is not installed
- Runtime: stopped / RPC probe: failed → nothing is listening on
ws://127.0.0.1:18789 - So the browser control service + relay (
18791/18792) never come up either
Fix (Windows native)
Reinstall the Gateway service, then start it:
openclaw gateway install --force
openclaw gateway start
openclaw gateway status
If start still doesn’t bring it up, run it in the foreground to see the error:
openclaw gateway --port 18789
Then re-test the relay
Once the gateway is actually running:
openclaw browser --browser-profile chrome status --json
openclaw browser --browser-profile chrome tabs --json
And in the extension Options:
- Port should be 18792 (default gateway 18789 + 3)
- Token must match your
gateway.auth.token/OPENCLAW_GATEWAY_TOKEN
If openclaw gateway start fails, paste the last ~50 lines of:
C:\Users\zephyrus\AppData\Local\Temp\openclaw\openclaw-2026-03-14.log
So the browser relay can’t work yet — there’s nothing for it to connect to.
Right now your Gateway is not running (RPC probe: failed, “Scheduled Task (missing)”), which means:
- no browser control service (gateway + 2)
- no relay server for the Chrome extension (gateway + 3)
Do this next (pick one):
A) Run Gateway right now (quick test):
openclaw gateway --port 18789
(leave that terminal open)
B) Install + run it as a background service (recommended):
openclaw gateway install --force
openclaw gateway start
openclaw gateway status
Paste the output of openclaw gateway start + openclaw gateway status and we’ll go to the relay step after.
gateway is connected but its stuck in debugging the browser
Nice — if the Gateway is up, then “stuck in debugging” is now almost always one of these:
- No tab attached / relay not actually connected
- In Chrome, click the OpenClaw Browser Relay extension on the tab you want.
- Badge must show ON (not
…/!). - In the extension Options page, confirm it says the relay is reachable and auth is OK (port + token).
chromerelay profile can’t see any targets (or Playwright/CDP is hanging)
Can you paste the output of these (this will tell us exactly where it’s stuck):
openclaw browser --browser-profile chrome status --json
openclaw browser --browser-profile chrome tabs --json
openclaw browser --browser-profile openclaw status --json
openclaw browser --browser-profile openclaw tabs --json
Also tell me:
- What does the extension badge show (ON / … / !)?
- Did you change the gateway port from
18789? (Relay port should be gateway + 3, so default is 18792.)
If the tabs command just hangs, grab the last ~150 lines of your log file (the one openclaw gateway status prints) and paste it here.
Microsoft Windows [Version 10.0.26200.8037]
(c) Microsoft Corporation. All rights reserved.
C:\Users\zephyrus>openclaw browser --browser-profile chrome status --json
{
"enabled": true,
"profile": "chrome",
"running": true,
"cdpReady": true,
"cdpHttp": true,
"pid": null,
"cdpPort": 18792,
"cdpUrl": "http://127.0.0.1:18792",
"chosenBrowser": null,
"detectedBrowser": "brave",
"detectedExecutablePath": "C:\Users\zephyrus\AppData\Local\BraveSoftware\Brave-Browser\Application\brave.exe",
"detectError": null,
"userDataDir": null,
"color": "#00AA00",
"headless": false,
"noSandbox": false,
"executablePath": null,
"attachOnly": false
}
C:\Users\zephyrus>openclaw browser --browser-profile chrome tabs --json
{
"tabs": [
{
"targetId": "F0C473EFE2B8D3E9DFBB04A6CB928968",
"title": "OpenClaw Browser Relay",
"url": "chrome-extension://nglingapjinhecnfejdcpihlpneeadjp/options.html",
"wsUrl": "ws://127.0.0.1:18792/cdp",
"type": "page"
},
{
"targetId": "839CF5A60B6E58737985E736DA5DA2A6",
"title": "(2)TikTok - Make Your Day",
"url": "https://www.tiktok.com/",
"wsUrl": "ws://127.0.0.1:18792/cdp",
"type": "page"
}
]
}
C:\Users\zephyrus>
C:\Users\zephyrus>openclaw browser --browser-profile openclaw status --json
{
"enabled": true,
"profile": "openclaw",
"running": false,
"cdpReady": false,
"cdpHttp": false,
"pid": null,
"cdpPort": 18800,
"cdpUrl": "http://127.0.0.1:18800",
"chosenBrowser": null,
"detectedBrowser": "brave",
"detectedExecutablePath": "C:\Users\zephyrus\AppData\Local\BraveSoftware\Brave-Browser\Application\brave.exe",
"detectError": null,
"userDataDir": null,
"color": "#FF4500",
"headless": false,
"noSandbox": false,
"executablePath": null,
"attachOnly": false
}
C:\Users\zephyrus>
so?
Those outputs actually look healthy for the relay:
running: true,cdpReady: true,cdpHttp: truetabsis returning real pages (extension options + TikTok)
So if what you mean is Brave/Chrome showing a “Debugging” / “being controlled” indicator: that’s expected while the extension is attached via chrome.debugger. It’ll stay until you detach (click the extension icon again so badge goes OFF) or restart the browser.
If you mean OpenClaw can’t do anything (snapshots/click/type) and it “hangs”, let’s narrow it to a specific command:
1) Focus the page tab, then snapshot
openclaw browser --browser-profile chrome focus 839CF5A60B6E58737985E736DA5DA2A6
openclaw browser --browser-profile chrome snapshot
(If TikTok is weird, try openclaw browser --browser-profile chrome open https://example.com then snapshot that.)
2) If snapshot/screenshot hangs or errors, paste the exact output
Also paste the last ~100 lines of your gateway log around the time you run it.
Common culprit if snapshot fails: Playwright missing (you’ll usually see a message like “Playwright is not available in this gateway build”).
Which exact thing is “stuck” on your side: a CLI command (which one), or the browser UI showing “Debugging”?
So: based on what you pasted, nothing is stuck. The relay is working.
What you’re calling “debugging” is almost certainly the browser warning/indicator that a debugger is attached (that’s how the extension relay works). It will stay there as long as the relay is attached.
You have 3 options:
-
Make it go away (detach): click the OpenClaw Browser Relay extension icon again on that tab → badge OFF. (Or just restart Brave.)
-
Avoid touching your daily browser entirely: use the isolated managed browser instead:
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot
- Prove control works (one quick test):
openclaw browser --browser-profile chrome focus 839CF5A60B6E58737985E736DA5DA2A6
openclaw browser --browser-profile chrome snapshot
If (3) hangs/errors, paste that exact output + log tail — otherwise you’re good.
C:\Users\zephyrus>openclaw browser --browser-profile chrome focus 839CF5A60B6E58737985E736DA5DA2A6
🦞 OpenClaw 2026.3.12 (6472949) — Powered by open source, sustained by spite and good documentation.
|
penclaw browser --browser-profile chrome snapshot
o
focused tab 839CF5A60B6E58737985E736DA5DA2A6
C:\Users\zephyrus>
Your focus worked (focused tab ...). The “snapshot” part didn’t actually run in that paste (it looks like it got mangled into penclaw ...).
Run this as a separate command (copy exactly):
openclaw browser --browser-profile chrome snapshot --json --timeout 30000
If that errors or hangs, paste whatever it prints.
Two quick notes:
- If it says something like “Playwright is not available …”: that’s the reason you feel “stuck” (extension relay snapshots/actions need Playwright). Paste the exact error and I’ll tell you the right install path for Windows.
- If you want a control test that avoids the extension relay path, you can also try the managed browser:
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw snapshot --json --timeout 30000
C:\Users\zephyrus>openclaw browser --browser-profile openclaw start
🦞 OpenClaw 2026.3.12 (6472949) — Self-hosted, self-updating, self-aware (just kidding... unless?).
|
o
|
o
🦞 browser [openclaw] running: true
C:\Users\zephyrus>openclaw browser --browser-profile openclaw start
🦞 OpenClaw 2026.3.12 (6472949) — Open source means you can see exactly how I judge your config.
|
o
|
o
🦞 browser [openclaw] running: true
C:\Users\zephyrus> openclaw browser --browser-profile openclaw snapshot --json --timeout 30000
{
"ok": true,
"format": "ai",
"targetId": "A47B48E7EEE73AE697F36F5D70B4654B",
"url": "about:blank",
"snapshot": "",
"refs": {}
}
C:\Users\zephyrus>
Yep — that shows the managed openclaw browser is working.
Your snapshot is empty because the only page open is about:blank:
"url": "about:blank",
"snapshot": ""
Do this to verify snapshots end-to-end:
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot --json --timeout 30000
Now, to get back to your original issue (the Chrome/Brave relay), run:
openclaw browser --browser-profile chrome snapshot --json --timeout 30000
- If this one hangs or errors, paste the output (and we’ll check logs / Playwright path).
- If it succeeds, then the “Debugging” indicator you’re seeing in Brave is just the normal “debugger attached” warning while the extension badge is ON (detach to remove it).
(detach to remove it)., how do i detach IT?
To detach the browser relay, you detach it from the browser UI (not from OpenClaw CLI):
- In Brave/Chrome, go to the tab that’s currently attached (the one showing the “debugging/being controlled” warning).
- Click the OpenClaw Browser Relay extension icon in the toolbar.
- If the badge says ON, clicking it again should turn it OFF (that detaches).
- If you don’t see the icon:
- Click the Extensions menu (puzzle piece) → find OpenClaw Browser Relay → Pin it, then click it.
If it’s still stuck attached:
- Close that tab, or
brave://extensions(orchrome://extensions) → toggle the extension off/on (or hit Reload), or just restart Brave.
yes but when i turn it on it comes back.
Yep — that’s expected.
That “debugging / being controlled” warning is Chromium’s UI any time something attaches via the Debugger protocol (chrome.debugger). The OpenClaw relay works by doing exactly that, so:
- Relay ON / attached → warning shows
- Relay OFF / detached → warning disappears
There’s no supported way to keep the relay attached and hide that warning.
If you want browser automation without messing with your daily browser UI, use the isolated managed browser instead:
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
Or keep using the relay but do it in a dedicated Chrome/Brave profile so your main one isn’t constantly showing the “debugging” state.
my clawbot is saying, Still not showing. Are you sure you:
- Entered the token in the extension settings and saved it?
- Went to TikTok.com in Chrome
- Clicked the OpenClaw extension icon on that tab?
The extension needs to be clicked ON A SPECIFIC TAB to attach. Let me know exactly what you did step by step.
Given your earlier output, the relay itself is up and the Gateway can see the browser. So if your chat bot still says “no tab connected”, it’s almost always one of these two things:
1) You attached the extension in the “wrong place” (wrong tab / wrong browser)
Make sure you’re doing this in the same browser you installed the extension into (Brave counts, but it must be Brave’s extension install), and on the exact tab you want controlled.
Do this cleanly:
-
Close the “OpenClaw Browser Relay” options tab (so it doesn’t confuse things).
-
Open TikTok in Brave.
-
Click the OpenClaw Browser Relay extension icon on that TikTok tab → badge ON (you’ll see the “debugging/being controlled” warning; that’s normal).
-
In CMD, confirm the relay sees it:
openclaw browser --browser-profile chrome tabs --json
Ideally you’ll see just the TikTok tab (or at least TikTok + whatever else you attached).
2) Your agent session is sandboxed (so it’s looking at the sandbox browser, not host)
The CLI commands you ran talk to the host gateway, but your Discord agent might be running sandboxed and therefore can’t use the host relay unless allowed.
Fix options:
- quickest: try from an unsandboxed agent/session, or
- set
agents.defaults.sandbox.browser.allowHostControl: trueand restart the gateway, then make sure the agent usestarget="host"withprofile="chrome".
If you tell me whether you have sandboxing/Docker enabled for Discord sessions, I can point you to the exact config knob.
you arent helping me at all, im still stuck in debigging.
You’re stuck because “debugging” can mean two totally different things, and the fix depends on which one you mean:
A) You mean the browser UI says “Debugging / being controlled”
That is normal for the extension relay. The relay uses Chromium’s debugger API, and Chromium always shows that warning while it’s attached.
- It will only go away when you detach (badge OFF) or close/restart the browser.
- There is no supported way to keep relay attached and hide the warning.
- If you want automation without that warning in your daily browser: use the managed browser (
--browser-profile openclaw) instead.
B) You mean OpenClaw (the bot) can’t actually control / snapshot the attached tab
Then we need to test one command and look at its output.
Please run exactly this and paste the result:
openclaw browser --browser-profile chrome snapshot --json --timeout 30000
- If this returns a snapshot → the relay is fine, and your Discord session is likely sandboxed / targeting sandbox instead of host (fixable via
allowHostControl+target=host). - If this errors or hangs → paste the error (that’s the real blocker).
Which of A or B is your situation? If you paste the chrome snapshot output, I can stop guessing and give you the exact next step.
No — there isn’t a command to “remove debugging” while using the Chrome/Brave extension relay.
That “Debugging / being controlled” indicator is Chromium’s built-in security UI for anything attached via the Debugger protocol. OpenClaw’s relay uses that API, so the warning is unavoidable when attached.
What you can do:
- Remove it immediately: detach the relay (click the extension icon again so badge goes OFF), or close/restart the browser.
- Avoid it entirely: don’t use the relay; use the isolated managed browser instead:
openclaw browser --browser-profile openclaw start - Reduce annoyance: use a dedicated Brave/Chrome profile just for relay use (so your main browser isn’t constantly in “debugging” mode).
The “???” here is: the relay is debugging.
The Chrome/Brave takeover works by attaching a debugger (CDP) to the tab. Chromium then must show the “Debugging / being controlled” warning. When you turn the relay ON, that warning will come back every time. That’s not an OpenClaw setting you can toggle off.
Only ways to make it disappear:
- Detach (badge OFF) — click the extension icon again on that tab
- Disable/unload the extension (chrome://extensions / brave://extensions)
- Use the managed browser instead (
--browser-profile openclaw) so your normal browser never gets a debugger attached
If you tell me which one you’re aiming for (keep takeover but no warning vs just want automation), I’ll point you to the best setup.
Yep — simplest check is to list the relay-visible tabs and look for tiktok.com.
In CMD
openclaw browser --browser-profile chrome tabs --json | findstr /i tiktok.com
In PowerShell
openclaw browser --browser-profile chrome tabs --json | Select-String -CaseSensitive:$false "tiktok.com"
If that prints a line containing https://www.tiktok.com/, the relay is connected to a TikTok tab.
If you want to confirm it can actually drive that tab: copy the targetId from tabs --json, then:
openclaw browser --browser-profile chrome focus <targetId>
openclaw browser --browser-profile chrome snapshot --json --timeout 30000
The snapshot output’s "url" should be the TikTok URL if you’re on the right tab.
do i need some extension packs or anything alike
No extra “extension packs” in general.
There are only two moving parts, depending on which mode you use:
1) Browser relay (control an existing Brave/Chrome tab)
You need only:
- The OpenClaw Browser Relay extension loaded (unpacked), and
- The extension Options set with the right port (usually
18792) + gateway token - Then you click the extension icon on the specific tab to attach (badge ON)
After an OpenClaw upgrade, refresh the extension files + reload it:
openclaw browser extension install
Then in brave://extensions / chrome://extensions hit Reload on the extension.
2) Managed browser (--browser-profile openclaw)
No extension needed at all.
Playwright note (only if you see an error)
If you run snapshot/screenshot/click/type and OpenClaw complains about Playwright missing (“Playwright is not available…”), then you’d need Playwright installed for those features — but don’t install anything preemptively unless you hit that message.
If you paste the output of:
openclaw browser --browser-profile chrome snapshot --json --timeout 30000
I can tell you if you’re missing anything.
i will make a newq bot and delete current one, now give a step by steb to do all
Ok. Here’s a clean, “from zero” checklist for Windows + Discord bot + browser relay (and I’ll include the managed-browser path too, because the relay always shows the Debugging warning when attached).
0) Optional: hard reset OpenClaw (only if you really want to “delete current one”)
In CMD:
openclaw gateway stop
openclaw gateway uninstall
Back up your state/config (recommended instead of deleting):
ren "%USERPROFILE%\.openclaw" ".openclaw.bak"
(If you don’t want a reset, skip this whole section.)
1) Start the Gateway (required)
Either run it in foreground (quick test):
openclaw gateway --port 18789
Or install it as a background service:
openclaw gateway install --force
openclaw gateway start
openclaw gateway status
You want gateway status to show running.
2) Create a fresh Discord bot (new token)
Follow the official steps here (this is the canonical guide):
https://docs.openclaw.ai/channels/discord
High level:
- Discord Developer Portal → New Application
- Create Bot
- Enable Message Content Intent (and Members Intent recommended)
- OAuth2 URL Generator: select
bot+applications.commands, then invite it to your server
- Copy the Bot Token (keep it secret)
3) Put the new token into OpenClaw config (don’t paste token into Discord)
On the machine running OpenClaw:
openclaw config set channels.discord.enabled true --json
openclaw config set channels.discord.token '"YOUR_BOT_TOKEN"' --json
openclaw gateway restart
Then pair it (DM your bot, it gives a pairing code):
openclaw pairing list discord
openclaw pairing approve discord <CODE>
4) Browser control — pick ONE of these
Option A (recommended): Managed browser (no “Debugging” warning in your main browser)
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot --json --timeout 30000
Option B: Extension relay takeover (this WILL show “Debugging” when attached — cannot be removed)
- Install/refresh the extension files:
openclaw browser extension install openclaw browser extension path - In Brave:
brave://extensions→ enable Developer mode → Load unpacked → pick the folder fromextension path - Open extension Options and set:
- Port: 18792 (default gateway 18789 + 3)
- Gateway token: must match your OpenClaw gateway token
- Open
tiktok.comand click the extension icon on that tab → badge ON - Verify it’s connected:
openclaw browser --browser-profile chrome tabs --json | findstr /i tiktok.com
If you answer just these two, I’ll tailor the exact final steps:
- Are you trying to use Option A (managed) or Option B (relay takeover)?
- Are you ok with the browser showing Debugging while attached (that’s normal for Option B)?
Windows PowerShell
Copyright (C) Microsoft Corporation. All rights reserved.
Install the latest PowerShell for new features and improvements! https://aka.ms/PSWindows
PS C:\Users\zephyrus> openclaw browser --browser-profile chrome tabs --json | findstr /i tiktok.com
Cannot run a document in the middle of a pipeline: C:\WINDOWS\system32\openclaw.
At line:1 char:1
- openclaw browser --browser-profile chrome tabs --json | findstr /i ti ...
-
+ CategoryInfo : InvalidOperation: (C:\WINDOWS\system32\openclaw:String) [], RuntimeException + FullyQualifiedErrorId : CantActivateDocumentInPipeline
PS C:\Users\zephyrus>
That’s a PowerShell quirk: your openclaw shim is being treated like a “document”, so PS won’t run it inside a pipeline.
Use one of these instead:
Option 1 (recommended): PowerShell call operator &
& openclaw browser --browser-profile chrome tabs --json | Select-String -CaseSensitive:$false "tiktok.com"
Option 2: Run the OpenClaw command through cmd.exe
cmd /c "openclaw browser --browser-profile chrome tabs --json" | findstr /i tiktok.com
If you want to see what PowerShell thinks openclaw is
Get-Command openclaw | Format-List Name,CommandType,Source
If you paste that last output, I can tell you whether you should call openclaw.cmd explicitly on your machine.
PS C:\Users\zephyrus> cmd /c "openclaw browser --browser-profile chrome tabs --json" | findstr /i tiktok.com
PS C:\Users\zephyrus> Get-Command openclaw | Format-List Name,CommandType,Source
Name : openclaw
CommandType : Application
Source : C:\WINDOWS\system32\openclaw
PS C:\Users\zephyrus>
Cool — two important takeaways from that output:
Get-Commandshowsopenclawreally is an Application atC:\Windows\system32\openclaw.- Your
findstrline printed nothing, which means your relay tabs output currently does not containtiktok.com→ i.e. it’s not attached to a TikTok tab right now.
Do this in order:
1) See exactly what the relay thinks is attached (no filtering)
cmd /c "openclaw browser --browser-profile chrome tabs --json"
2) If TikTok isn’t in that JSON
Open TikTok in the same browser where the OpenClaw extension is installed (Brave/Chrome), then:
- click the OpenClaw extension icon on the TikTok tab
- ensure the badge shows ON
- then rerun step (1)
If you paste the full JSON from step (1), I can tell you immediately whether:
- you attached the wrong tab,
- you attached in a different browser profile/window, or
- the extension is only attaching the Options page instead of the site tab.
The real issue is:
- Gateway is running on your machine âś…
- Extension is trying to connect âś…
- Token auth is failing (extension not sending the token) ❌
I can't fix the extension bug from here. That's a bug in the OpenClaw Chrome extension itself that the developers need to fix.
That message from your bot sounds like “401/unauthorized from the relay”, but it’s usually not an extension bug — it’s almost always one of these:
- token in the extension Options is empty / not saved
- token is different than your gateway token
- you changed gateway port and the extension is pointing at the wrong relay port
Do this exact checklist:
1) Confirm what your Gateway token actually is
In PowerShell/CMD on the gateway machine:
openclaw config get gateway.auth.token
- If it prints nothing /
null, generate one:
openclaw doctor --generate-gateway-token
then restart:
openclaw gateway restart
2) Reinstall + reload the extension (forces the latest files)
openclaw browser extension install
openclaw browser extension path
Then in Brave/Chrome:
brave://extensions→ Reload the OpenClaw extension (or remove + “Load unpacked” again using the printed path)
3) Set extension Options correctly
Open the extension Options page and set:
- Port:
18792(default; it’sgateway port + 3) - Gateway token: paste the exact value from
openclaw config get gateway.auth.token - hit Save (if there’s a save button)
4) Verify it’s attached
Open tiktok.com → click the extension icon on that tab → badge ON → then:
cmd /c "openclaw browser --browser-profile chrome tabs --json"
If after step (1) you paste what openclaw config get gateway.auth.token outputs (redact all but first/last 4 chars if you want), and/or a screenshot of the extension Options status, I can tell you which of the above is failing.
tur nthis into tiktok access file:///C:/WINDOWS/system32/openclaw
file:///C:/WINDOWS/system32/openclaw is not a TikTok URL — it’s just a local file path to the OpenClaw executable on your PC. There’s nothing to “turn into TikTok access” there.
If your goal is: make OpenClaw control a TikTok tab, do this:
- In Brave/Chrome, open a normal web URL:
https://www.tiktok.com/
-
While you’re on that TikTok tab, click the OpenClaw Browser Relay extension icon → badge ON.
-
Verify from terminal:
cmd /c "openclaw browser --browser-profile chrome tabs --json"
You should see a tab whose "url" contains https://www.tiktok.com/.
If you’re seeing that file:///.../openclaw inside your browser, it means you (or the bot) opened the local file in a tab — close that tab and attach the extension on the TikTok tab instead.
whatt
You’re mixing up two things:
file:///C:/WINDOWS/system32/openclaw= a local file on your PC (the OpenClaw program). Not a website.https://www.tiktok.com/= TikTok (a website).
To connect the relay to TikTok, do only this:
- Open https://www.tiktok.com/ in Brave/Chrome
- Click the OpenClaw Browser Relay extension icon on that TikTok tab → badge ON
- Run and paste the output:
cmd /c "openclaw browser --browser-profile chrome tabs --json"
If the pasted JSON doesn’t include a URL with tiktok.com, you’re not attached to the TikTok tab yet (attached to the wrong tab or wrong browser window/profile).
PS C:\Users\zephyrus> cmd /c "openclaw browser --browser-profile chrome tabs --json"
{
"tabs": [
{
"targetId": "091ABD88E0C1A64651DEB75DDA2FEB54",
"title": "(3)TikTok - Make Your Day",
"url": "https://www.tiktok.com/",
"wsUrl": "ws://127.0.0.1:18792/cdp",
"type": "page"
}
]
}
PS C:\Users\zephyrus>
Perfect — that output means the relay is attached to TikTok successfully:
- URL:
https://www.tiktok.com/ - Profile:
chrome - Exactly 1 attached tab (that’s what you want)
Next, confirm OpenClaw can actually read/control it:
cmd /c "openclaw browser --browser-profile chrome snapshot --json --timeout 30000"
If your Discord clawbot still says “no tab connected / still not showing” even though the CLI sees TikTok, then the bot session is almost certainly using the sandbox browser or the wrong target/profile. Fix is to make it use the host relay:
- ensure it uses profile
chrome - and (if sandboxing is on) it must use
target=hostor you must enableagents.defaults.sandbox.browser.allowHostControl.
Run the snapshot command above and paste the output if it fails or comes back empty.
not empti
If the chrome snapshot is not empty, then the relay is working end-to-end — OpenClaw can see and read the TikTok tab.
At that point there are only two “remaining” possibilities:
- You’re still bothered by the Debugging banner → that’s expected while attached; only detaching removes it.
- Your Discord clawbot still says “not showing” → it’s using the wrong browser target/profile (often sandbox). Tell it explicitly to use browser profile
chrome(andtarget=hostif sandboxing is enabled).
Can you paste the actual output of:
cmd /c "openclaw browser --browser-profile chrome snapshot --json --timeout 30000"
…and tell me which of the two issues above you’re still seeing?
PS C:\Users\zephyrus> cmd /c "openclaw browser --browser-profile chrome snapshot --json --timeout 30000"
{
"ok": true,
"format": "ai",
"targetId": "E3B462E3493C66CFC31D272CC8DA595D",
"url": "http://127.0.0.1:18792/",
"snapshot": "- generic [ref=e2]: OK",
"refs": {
"e2": {
"role": "generic"
}
}
}
PS C:\Users\zephyrus>
That snapshot is not TikTok — it’s the relay server’s own “OK” page:
"url": "http://127.0.0.1:18792/""snapshot": "- generic: OK"
So right now, snapshot is not targeting the TikTok tab. You need to focus the TikTok targetId first, then snapshot.
Run these in order:
cmd /c "openclaw browser --browser-profile chrome tabs --json"
cmd /c "openclaw browser --browser-profile chrome focus 091ABD88E0C1A64651DEB75DDA2FEB54"
cmd /c "openclaw browser --browser-profile chrome snapshot --json --timeout 30000"
Expected result: the final snapshot should have "url": "https://www.tiktok.com/" (or some TikTok URL), not 127.0.0.1:18792.
If it still snapshots 127.0.0.1:18792 after focusing the TikTok target, paste the outputs of all three commands — that would indicate the relay driver isn’t switching targets correctly.
PS C:\Users\zephyrus> cmd /c "openclaw browser --browser-profile chrome focus 091ABD88E0C1A64651DEB75DDA2FEB54"
🦞 OpenClaw 2026.3.12 (6472949) — Your task has been queued; your dignity has been deprecated.
|
o
GatewayClientRequestError: browser not running
PS C:\Users\zephyrus> cmd /c "openclaw browser --browser-profile chrome snapshot --json --timeout 30000"
GatewayClientRequestError: tab not found (no attached Chrome tabs for profile "chrome"). Click the OpenClaw Browser Relay toolbar icon on the tab you want to control (badge ON).
PS C:\Users\zephyrus>
That output is actually very clear:
GatewayClientRequestError: browser not running= the chrome relay server isn’t running right nowtab not found (no attached Chrome tabs...)= even if it were running, there are currently zero attached tabs (badge isn’t ON on any tab)
Do this reset sequence:
1) Start the relay server for the chrome profile
cmd /c "openclaw browser --browser-profile chrome start"
cmd /c "openclaw browser --browser-profile chrome status --json"
You want running: true and cdpReady: true.
2) Re-attach a tab (this is required every time it’s detached)
In Brave/Chrome:
- Open
https://www.tiktok.com/ - Click the OpenClaw Browser Relay extension icon on that tab → badge ON
3) Confirm OpenClaw sees the attached tab again
cmd /c "openclaw browser --browser-profile chrome tabs --json"
Once TikTok shows up there, then focus + snapshot will work again.
If chrome status --json won’t go to running:true, paste that status output and we’ll look at why the relay server isn’t starting.
PS C:\Users\zephyrus> cmd /c "openclaw browser --browser-profile chrome start"
🦞 OpenClaw 2026.3.12 (6472949) — Your personal assistant, minus the passive-aggressive calendar reminders.
│
â—‡
│
â—‡
🦞 browser [chrome] running: false
PS C:\Users\zephyrus> cmd /c "openclaw browser --browser-profile chrome status --json"
changed to brave now
browser [chrome] running: false after start means the relay server failed to come up — we need the JSON status to see why.
Please paste the output of:
cmd /c "openclaw browser --browser-profile chrome status --json"
Also run this one check (most common cause is the port is already taken):
netstat -ano | findstr :18792
- If you see a line with
LISTENINGon18792, something else is occupying the relay port (or a stuck old process is). - If there’s no listener on
18792, the relay server isn’t binding at all (and the status JSON/log will tell us what it’s unhappy about).
Once you paste the status --json, I’ll tell you the exact fix (port conflict vs browser disabled vs auth/config).
Brave is totally fine — the profile is still called chrome, it just means “extension relay”, not “must be Google Chrome”.
One important gotcha: the extension is installed per browser. If you previously loaded it in Chrome, switching to Brave means you must load it in Brave too.
Let’s re-sync from scratch in Brave:
1) Reinstall the extension files
cmd /c "openclaw browser extension install"
cmd /c "openclaw browser extension path"
2) Load it in Brave
- Open:
brave://extensions - Enable Developer mode
- Load unpacked → choose the folder printed by
extension path - Pin the extension
3) Check relay status + tabs (paste both outputs)
cmd /c "openclaw browser --browser-profile chrome status --json"
cmd /c "openclaw browser --browser-profile chrome tabs --json"
If status still shows running:false, we’re back to a relay-server/port issue (then we’ll do the netstat :18792 check).
profile is false, its linked in brave browser
If the extension is loaded in Brave but chrome profile shows running: false, that means:
The extension is fine — the local relay server on 127.0.0.1:18792 is not running / not reachable.
We can’t guess the cause without the status JSON. Please paste this:
cmd /c "openclaw browser --browser-profile chrome status --json"
And run this quick port check:
netstat -ano | findstr :18792
Common outcomes:
- Nothing is listening on 18792 → relay server never started (often gateway not running, browser disabled, or it failed to bind)
- Something else is LISTENING on 18792 → port conflict (you’ll need to stop that process or change gateway port, then set extension port to
gateway+3)
Post the status --json + the netstat line(s) and I’ll tell you the exact fix.
C:\Windows\System32>openclaw browser --browser-profile openclaw status
🦞 OpenClaw 2026.3.12 (6472949) — I'll do the boring stuff while you dramatically stare at the logs like it's cinema.
|
penclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshotopenclaw browser --browser-profile openclaw status
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
o
profile: openclaw
enabled: true
running: false
cdpPort: 18800
cdpUrl: http://127.0.0.1:18800
browser: unknown
detectedBrowser: brave
detectedPath: ~\AppData\Local\BraveSoftware\Brave-Browser\Application\brave.exe
profileColor: #FF4500
C:\Windows\System32>
That status output just means: the managed browser profile (openclaw) is enabled, but it’s not currently running (running: false). Nothing is broken yet — you just need to start it again.
In CMD, run these one at a time (don’t paste a whole block; it’s getting mangled into penclaw in your terminal):
openclaw browser --browser-profile openclaw start
Then open a page:
openclaw browser --browser-profile openclaw open https://example.com
Then verify with a snapshot:
openclaw browser --browser-profile openclaw snapshot --json --timeout 30000
If start prints an error (port in use, permission, etc.), paste that exact error line.
Also: are you trying to use the managed browser (openclaw, no extension, no “Debugging” banner) or the relay takeover (chrome, requires extension + “Debugging” banner)? Pick one and we’ll stick to it.
WebSocket connection to 'ws://127.0.0.1:18792/extension?token=9ba12b9cb898a361a441521625653b50a76af1ff7ae0b1cb30054faaedaa6c9b' failed: HTTP Authentication failed; no valid credentials available
That error is the smoking gun:
ws://127.0.0.1:18792/extension?token=... failed: HTTP Authentication failed
Two important things:
1) You just posted your gateway token in a public channel
Treat it as compromised. Rotate it now (and don’t paste the new one here).
2) Fix is usually auth-mode mismatch or token mismatch
First, check what auth mode your gateway is using:
openclaw config get gateway.auth.mode
You want it to be:
token✅ (works with the extension’s token field)
If it’s password (or anything else), the extension token won’t authenticate.
Rotate + force token auth (safe fix)
Run these (PowerShell or CMD is fine):
openclaw config set gateway.auth.mode '"token"' --json
Generate a new token locally (PowerShell):
$tok = ([guid]::NewGuid().ToString('N') + [guid]::NewGuid().ToString('N')); $tok