← Back to Skills Marketplace
stevenxie66

Control Host Browser

by stevenxie66 · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
58
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install control-host-browser
Description
Control the host machine's Chrome browser to open specific URLs in new tabs. Use when: User explicitly asks to "open a link", "show me this page", or "search...
README (SKILL.md)

Host Browser Controller

功能定义

此技能用于控制宿主机(用户物理机)上的 Chrome 浏览器。它通过 Chrome DevTools Protocol (CDP) 创建新标签页并导航至指定 URL,让用户能在本地屏幕上查看网页内容。

触发场景

  • 用户说:“在浏览器里打开这个链接”。
  • 用户说:“帮我搜索一下‘AI 发展趋势’”。
  • 用户希望查看某个文档或网页的可视化效果。

执行步骤 (SOP)

  1. 参数准备
    • 确认目标 URL。如果是搜索请求,先构造 Google/Bing 搜索链接。
    • 确认 Profile 名称(默认为 main,对应宿主机上的特定用户配置)。
  2. 创建标签页
    • 调用 control_host_browser.sh 脚本。
    • 传入 profile 参数(通常为 main)。
    • 脚本会通过 CDP 接口在宿主机 Chrome 中创建一个新 Tab,并返回 targetId
  3. 导航页面
    • 使用返回的 targetId,通过 CDP WebSocket 发送 Page.navigate 指令。
    • 传入目标 URL。
  4. 确认状态
    • 等待页面加载事件(Page.loadEventFired)。
    • 向用户反馈:“已在您的浏览器中打开 [标题/URL]”。

参数说明

  • profile: 浏览器配置文件标识。
    • main: 主配置文件(默认)。
  • url: 需要打开的完整 URL(包含 https://)。

输出格式

  • 成功:返回 "Tab created with ID: [ID], navigating to [URL]"。
  • 失败:返回具体的 CDP 错误信息(如 "Connection refused", "Invalid URL")。

限制说明

  • 仅支持 HTTP/HTTPS 协议。
  • 依赖于宿主机 Chrome 浏览器已开启远程调试端口(默认 18800)。
  • 无法直接操作页面内的 DOM(如点击按钮),仅负责打开页面。

Usage:

./control_host_browser.sh \x3Cprofile> \x3Curl>

Where profile is main

Usage Guidance
Review before installing. This is not shown to be malicious, but it can drive your real Chrome browser through CDP. Use it only if you want the agent to open pages on your machine, keep Chrome's debugging port locked down, avoid sensitive browser profiles, and prefer a version that enforces HTTP/HTTPS-only URLs.
Capability Analysis
Type: OpenClaw Skill Name: control-host-browser Version: 1.0.0 The skill bundle provides a utility for an AI agent to open URLs in a Chrome browser on the host machine using the Chrome DevTools Protocol (CDP). It consists of a shell script (control_host_browser.sh) that creates a new tab via a REST API call and a Python script (cdp_navigate.py) that implements a raw WebSocket handshake to send the navigation command. The code is transparent, lacks obfuscation, and its functionality is strictly limited to the stated purpose of browser control without any indicators of data exfiltration or unauthorized execution.
Capability Assessment
Purpose & Capability
The stated purpose and included code align: it creates a new Chrome tab via CDP and navigates it. This is user-visible browser control, not hidden scraping.
Instruction Scope
SKILL.md says the skill should be used only for explicit user requests and only for HTTP/HTTPS URLs, but the scripts accept and forward any URL argument, so the main safety boundary relies on agent discipline rather than enforcement.
Install Mechanism
There is no install spec and the registry declares no required binaries or config paths, while the package includes Bash/Python scripts that require python3, curl, and an already-enabled host Chrome CDP port.
Credentials
The skill targets the host machine's Chrome profile over CDP, which can make requests in the user's local browser/session context and is more sensitive than a normal link-opening helper.
Persistence & Privilege
No persistence, background worker, or privilege escalation is shown, but operation depends on access to a host Chrome remote-debugging port and the main browser profile.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install control-host-browser
  3. After installation, invoke the skill by name or use /control-host-browser
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of control-host-browser skill: - Enables opening specific URLs in new tabs on the host machine's Chrome browser. - Triggered by user requests such as "open a link" or "search in browser." - Not intended for agent-internal or headless browsing tasks. - Requires Chrome remote debugging enabled on the host machine. - Operates using a shell script and Chrome DevTools Protocol (CDP).
Metadata
Slug control-host-browser
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Control Host Browser?

Control the host machine's Chrome browser to open specific URLs in new tabs. Use when: User explicitly asks to "open a link", "show me this page", or "search... It is an AI Agent Skill for Claude Code / OpenClaw, with 58 downloads so far.

How do I install Control Host Browser?

Run "/install control-host-browser" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Control Host Browser free?

Yes, Control Host Browser is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Control Host Browser support?

Control Host Browser is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Control Host Browser?

It is built and maintained by stevenxie66 (@stevenxie66); the current version is v1.0.0.

💬 Comments