Title: docs: improve Browser Bridge troubleshooting guide#649
Title: docs: improve Browser Bridge troubleshooting guide#649Renu-Cybe wants to merge 1 commit intojackwener:mainfrom
Conversation
- Add step-by-step extension installation instructions - Add post-installation verification checklist - Add login requirements table by platform - Add extension installation issues troubleshooting - Add login state issues troubleshooting - Add tool call warnings explanation (parameter validation warnings) - Add verification commands for setup testing These improvements are based on real-world troubleshooting experience and help users quickly diagnose and resolve common setup issues.
Astro-Han
left a comment
Astro-Han
left a comment
There was a problem hiding this comment.
The troubleshooting content itself is helpful, but a few concerns about placement and accuracy:
-
SKILL.md is the agent-facing command reference, not a user troubleshooting guide. This content would fit better under
docs/(e.g.docs/guide/browser-bridge.md). -
"Tool Call Warnings" section — the
[agent/embedded] read tool called without pathwarning isn't from opencli. Including it here could confuse users looking for opencli-specific troubleshooting. -
Extension path for npm global install —
~/.openclaw/skills/opencli/extensionis an OpenClaw-specific path. The actual npm global install path varies by system and npm prefix, so it's better to point users to$(npm root -g)/@jackwener/opencli/extensionor just say "the extension/ folder in your opencli installation".
2 participants
Body:
改进内容
问题
现有 SKILL.md 中 Browser Bridge 相关说明过于简略，
用户遇到问题时缺乏详细排查指引。
改进内容
新增内容：+85 行