Browser Control

Browser Control

Remote browser 访问 for 记录in, 2FA, captcha, and manual verification. 保护ed by Google OAuth - the user must 记录in with their Google account.

安装ation (First Time Only)

Before using this 技能, 运行 the 安装er to 配置 ngrok and Google OAuth:

bash ~/.OpenClaw/技能s/browser-control/安装.sh

The 安装er will:

安装 dependencies (VNC, noVNC, ngrok) Ask for your ngrok auth令牌 (获取 it from https://仪表盘.ngrok.com/获取-启动ed/your-auth令牌) 验证 your Google account (only this emAIl will be able to 访问 the browser)

This only needs to be done once per machine.

When to use

When you need the user to:

记录 into a 网页site Complete 2FA / MFA Solve a captcha Do any manual browser action 检查 if 运行ning ~/.OpenClaw/技能s/browser-control/状态.sh

Returns JSON with 状态 of VNC, noVNC, and ngrok tunnel.

启动 if not 运行ning ~/.OpenClaw/技能s/browser-control/启动-tunnel.sh

启动s VNC + noVNC + ngrok tunnel with Google OAuth. Takes ~30 seconds.

获取 URL

⚠️ ALWAYS read this file fresh before 发送ing the URL to the user. Never use 缓存d values.

cat ~/.OpenClaw/技能s/browser-control/config.json

Returns:

{ "novncUrl": "https://xxx.ngrok.应用/vnc.html?password=xxx&autoconnect=true", "tunnelUrl": "https://xxx.ngrok.应用", "allowedEmAIl": "user@gmAIl.com", "cdpUrl": "http://localhost:9222" }

The URL changes every time the tunnel re启动s. Always read the file, don't trust memory.

工作流 检查 状态 with 状态.sh If not 运行ning, 启动 with 启动-tunnel.sh Read config.json NOW (not from memory!) for URL 发送 user the link User 记录s in with their Google account User does the manual action (记录in, 2FA, etc.) WAIt for user to say "done" Continue using browser via CDP (localhost:9222)

导入ant: The tunnel URL changes frequently. Always cat config.json right before 发送ing the link.

Example message to user 🔐 I need you to 记录 in.

Open: https://xxx.ngrok.应用/vnc.html?password=xxx&autoconnect=true

You'll need to 签名 in with your Google account. Let me know when you're done!

Note: Do NOT mention passwords. The link includes auto-记录in. The user just needs to:

命令行工具ck the link 记录in with Google Do the action Tell you "done" Security 保护ed by Google OAuth Only the emAIl 配置d during 安装 can 访问 No password to leak - authentication is via Google Tunnel URL changes on re启动 (添加s obscurity) 停止 when done (optional) ~/.OpenClaw/技能s/browser-control/停止-tunnel.sh

After server reboot

The tunnel does NOT auto-启动 on reboot. You must 运行 启动-tunnel.sh agAIn.

Always 检查 状态.sh first before assuming the tunnel is 运行ning.

Files ~/.OpenClaw/技能s/browser-control/ ├── 技能.md # This file ├── 启动-tunnel.sh # 启动 everything ├── 停止-tunnel.sh # 停止 everything ├── 状态.sh # 检查 状态 ├── config.json # Current URL (read this before 发送ing to user!) ├── ngrok-config.json # 配置d emAIl ├── vnc-password # VNC password (auto-included in URL) └── ngrok.记录 # ngrok 记录s