---

name: js-eyes description: Browser automation for AI agents — control tabs, extract content, execute scripts and manage cookies via WebSocket. version: 1.4.3 metadata: openclaw: emoji: "\U0001F441" homepage: https://github.com/imjszhang/js-eyes os:

• windows

• macos

• linux

requires: bins:

• node

install:

• kind: node

package: ws bins: []

---

JS Eyes

Browser extension + WebSocket server that gives AI agents full browser automation capabilities.

What it does

JS Eyes connects a browser extension (Chrome / Edge / Firefox) to an AI agent framework via WebSocket, enabling the agent to:

• List and manage browser tabs

• Open URLs and navigate pages

• Extract full HTML content from any tab

• Execute arbitrary JavaScript in page context

• Read cookies for any domain

• Monitor connected browser clients

Architecture

`` Browser Extension <── WebSocket ──> JS-Eyes Server <── WebSocket ──> AI Agent (OpenClaw) (Chrome/Edge/FF) (Node.js) (Plugin: index.mjs) ` The browser extension runs in the user's browser and maintains a persistent WebSocket connection to the JS-Eyes server. The OpenClaw plugin connects to the same server and exposes 7 AI tools + a background service + CLI commands.

Provided AI Tools

| Tool | Description | |------|-------------| | js_eyes_get_tabs | List all open browser tabs with ID, URL, title | | js_eyes_list_clients | List connected browser extension clients | | js_eyes_open_url | Open a URL in new or existing tab | | js_eyes_close_tab | Close a tab by ID | | js_eyes_get_html | Get full HTML content of a tab | | js_eyes_execute_script | Run JavaScript in a tab and return result | | js_eyes_get_cookies | Get all cookies for a tab's domain |

CLI Commands

` openclaw js-eyes status # Server connection status openclaw js-eyes tabs # List all browser tabs openclaw js-eyes server start # Start the built-in server openclaw js-eyes server stop # Stop the built-in server `

Skill Bundle Structure

This skill bundle is published from the repository root and contains all files required to run the OpenClaw plugin: ` js-eyes/ ├── SKILL.md ← Skill entry point (this file) ├── package.json ← Root package — declares ws dependency ├── LICENSE ├── openclaw-plugin/ │ ├── openclaw.plugin.json ← Plugin manifest (ID, config schema, UI hints) │ ├── package.json ← ESM module descriptor, declares entry point │ └── index.mjs ← Plugin logic — registers 7 AI tools, 1 service, CLI ├── server/ │ ├── index.js ← HTTP + WebSocket server │ ├── ws-handler.js ← Connection and message handling │ └── package.json └── clients/ └── js-eyes-client.js ← Node.js client SDK for browser automation `

openclaw-plugin/index.mjs imports from ../server/ and ../clients/ via relative paths, so the directory layout above must be preserved — openclaw-plugin/ cannot be used in isolation.

Prerequisites

• Node.js >= 16

• A supported browser: Chrome 88+ / Edge 88+ / Firefox 58+

Deploy to .openclaw

Install the skill via ClawHub: `bash clawhub install js-eyes ` ClawHub installs into ./skills under your current working directory (or your configured OpenClaw workspace). The bundle is self-contained — it includes the plugin, WebSocket server, and client SDK. 1. Install Node.js dependencies — the ws package is required at runtime: `bash cd ./skills/js-eyes # from the dir where you ran clawhub install; or ~/.openclaw/skills/js-eyes if using legacy sync npm install `

Run npm install if ws was not auto-installed via the Skills UI.

2. Register the plugin in ~/.openclaw/openclaw.json. The path must point to the openclaw-plugin subdirectory inside the skill, not the skill root: | Install method | | Plugin path for plugins.load.paths | |----------------|----------------|--------------------------------------| | ClawHub (workspace) | ./skills/js-eyes or $WORKSPACE/skills/js-eyes | ./skills/js-eyes/openclaw-plugin (use absolute path if needed) | | ClawHub (legacy sync) | ~/.openclaw/skills/js-eyes | ~/.openclaw/skills/js-eyes/openclaw-plugin | Example config (replace the path with your actual install location — use pwd after cd into the skill to get the absolute path). If you already have other plugins, append this path to the existing paths array: `json { "plugins": { "load": { "paths": ["/path/to/skills/js-eyes/openclaw-plugin"] }, "entries": { "js-eyes": { "enabled": true, "config": { "serverPort": 18080, "autoStartServer": true } } } } } `

Path note: index.mjs imports from ../server/ and ../clients/ relative to itself, so the bundle directory layout must be preserved. Point paths at the openclaw-plugin subdirectory only.

3. Restart OpenClaw to load the plugin.

For developers: clone the full repository and point plugins.load.paths to the openclaw-plugin directory inside your clone.

Browser Extension Setup

The plugin talks to browsers through the JS Eyes extension. Install it separately (independent of ClawHub):

• Download from GitHub Releases:

• Chrome / Edge: js-eyes-chrome-vX.Y.Z.zip — open chrome://extensions/ (or edge://extensions/), enable Developer mode, click "Load unpacked", select the extracted folder

• Firefox: js-eyes-firefox-vX.Y.Z.xpi — drag and drop into the browser window

• Click the JS Eyes extension icon in the toolbar, enter http://localhost:18080 as the server address, click Connect — the status should turn green.

Verify

Run the CLI command to confirm everything is working: `bash openclaw js-eyes status ` Expected output: ` === JS-Eyes Server Status === Uptime: ...s Browser extensions: 1 Automation clients: ... ` You can also ask the AI agent to list your browser tabs — it should invoke js_eyes_get_tabs and return the tab list.

Plugin Configuration

| Option | Type | Default | Description | |--------|------|---------|-------------| | serverHost | string | "localhost" | Server listen address | | serverPort | number | 18080 | Server port (must match extension config) | | autoStartServer | boolean | true | Auto-start server when plugin loads | | requestTimeout | number | 60 | Per-request timeout in seconds |

Troubleshooting

| Symptom | Cause | Fix | |---------|-------|-----| | Extension shows "Disconnected" | Server not running | Check openclaw js-eyes status; ensure autoStartServer is true | | js_eyes_get_tabs returns empty | No extension connected | Click extension icon, verify address is correct, click Connect | | Cannot find module 'ws' | Dependencies not installed | Run npm install in the skill root (where package.json declares ws) | | Tools not appearing in OpenClaw | Plugin path wrong or not enabled | Ensure plugins.load.paths points to the openclaw-plugin subdirectory, not the skill root | | Plugin path not found (Windows) | Path format | Use forward slashes in JSON, e.g. C:/Users/you/skills/js-eyes/openclaw-plugin` |

Links

• Source:

• Releases:

• ClawHub:

• Author: @imjszhang

• License: MIT