js-eyes

Category: Tools & Productivity | Uploader: imjszhang | Downloads: 0 | Version: v1.0（Latest）

Install, configure, verify, and troubleshoot JS Eyes browser automation for OpenClaw.

Changelog: Source: GitHub https://github.com/imjszhang/js-eyes

Directory Structure

Current level: tree/main/

📁 apps/
- 📁 cli/
  - 📁 bin/
    
    📄 js-eyes.js 164 B
  - 📁 src/
    
    📄 cli.js 39.2 KB
  - 📄 package.json 446 B
📁 docs/
- 📁 i18n/
  - 📁 locales/
    
    📄 en-US.js 6.7 KB
    
    📄 zh-CN.js 9.2 KB
  - 📄 index.js 2.4 KB
- 📁 skills/
  - 📁 js-bilibili-ops-skill/
    
    📄 js-bilibili-ops-skill-skill.zip 13.3 KB
    
    📄 js-bilibili-ops-skill-skill.zip.sha256 98 B
  - 📁 js-browser-ops-skill/
    
    📄 js-browser-ops-skill-skill.zip 18.8 KB
    
    📄 js-browser-ops-skill-skill.zip.sha256 97 B
  - 📁 js-jike-ops-skill/
    
    📄 js-jike-ops-skill-skill.zip 14.7 KB
    
    📄 js-jike-ops-skill-skill.zip.sha256 94 B
  - 📁 js-reddit-ops-skill/
    
    📄 js-reddit-ops-skill-skill.zip 18.0 KB
    
    📄 js-reddit-ops-skill-skill.zip.sha256 96 B
  - 📁 js-wechat-ops-skill/
    
    📄 js-wechat-ops-skill-skill.zip 14.9 KB
    
    📄 js-wechat-ops-skill-skill.zip.sha256 96 B
  - 📁 js-x-ops-skill/
    
    📄 js-x-ops-skill-skill.zip 89.1 KB
    
    📄 js-x-ops-skill-skill.zip.sha256 91 B
  - 📁 js-xiaohongshu-ops-skill/
    
    📄 js-xiaohongshu-ops-skill-skill.zip 16.2 KB
    
    📄 js-xiaohongshu-ops-skill-skill.zip.sha256 101 B
  - 📁 js-youtube-ops-skill/
    
    📄 js-youtube-ops-skill-skill.zip 13.5 KB
    
    📄 js-youtube-ops-skill-skill.zip.sha256 97 B
  - 📁 js-zhihu-ops-skill/
    
    📄 js-zhihu-ops-skill-skill.zip 15.6 KB
    
    📄 js-zhihu-ops-skill-skill.zip.sha256 95 B
- 📄 .nojekyll 0 B
- 📄 CNAME 12 B
- 📄 index.html 56.8 KB
- 📄 install.ps1 11.0 KB
- 📄 install.sh 11.8 KB
- 📄 js-eyes-skill.zip.sha256 84 B
- 📄 README_CN.md 19.8 KB
- 📄 skills.json 8.1 KB
📁 extensions/
- 📁 chrome/
  - 📁 _locales/
    
    📁 en/
    
    📄 messages.json 13.9 KB
    
    📁 zh_CN/
    
    📄 messages.json 13.7 KB
  - 📁 background/
    
    📄 background.js 120.2 KB
  - 📁 content/
    
    📄 content.js 15.6 KB
    
    📄 extension-bridge.js 9.6 KB
  - 📁 icons/
    
    📄 generate-icons.html 8.4 KB
    
    📄 icon-128.png 4.6 KB
    
    📄 icon-16.png 502 B
    
    📄 icon-32.png 1017 B
    
    📄 icon-48.png 1.6 KB
    
    📄 icon.svg 1.0 KB
  - 📁 popup/
    
    📁 fonts/
    
    📄 fonts.css 1.1 KB
    
    📄 Inter-300.ttf 318.1 KB
    
    📄 Inter-400.ttf 317.2 KB
    
    📄 Inter-500.ttf 317.7 KB
    
    📄 Inter-600.ttf 318.4 KB
    
    📄 Inter-700.ttf 318.8 KB
    
    📄 JetBrainsMono-400.ttf 109.5 KB
    
    📄 JetBrainsMono-500.ttf 109.6 KB
    
    📁 libs/
    
    📄 tailwind.css 11.4 KB
    
    📄 i18n.js 2.1 KB
    
    📄 popup.css 2.9 KB
    
    📄 popup.html 20.0 KB
    
    📄 popup.js 27.1 KB
  - 📄 config.js 4.1 KB
  - 📄 manifest.json 1.4 KB
- 📁 firefox/
  - 📁 _locales/
    
    📁 en/
    
    📄 messages.json 14.2 KB
    
    📁 zh_CN/
    
    📄 messages.json 13.9 KB
  - 📁 background/
    
    📄 background.js 110.0 KB
    
    📄 utils.js 21.5 KB
  - 📁 content/
    
    📄 content.js 16.3 KB
    
    📄 extension-bridge.js 9.6 KB
  - 📁 icons/
    
    📄 generate-icons.html 8.4 KB
    
    📄 icon-128.png 4.6 KB
    
    📄 icon-16.png 502 B
    
    📄 icon-32.png 1017 B
    
    📄 icon-48.png 1.6 KB
    
    📄 icon.svg 1.0 KB
  - 📁 popup/
    
    📁 fonts/
    
    📄 fonts.css 1.1 KB
    
    📄 Inter-300.ttf 318.1 KB
    
    📄 Inter-400.ttf 317.2 KB
    
    📄 Inter-500.ttf 317.7 KB
    
    📄 Inter-600.ttf 318.4 KB
    
    📄 Inter-700.ttf 318.8 KB
    
    📄 JetBrainsMono-400.ttf 109.5 KB
    
    📄 JetBrainsMono-500.ttf 109.6 KB
    
    📁 libs/
    
    📄 tailwind.css 11.4 KB
    
    📄 i18n.js 2.1 KB
    
    📄 input.css 60 B
    
    📄 package.json 275 B
    
    📄 popup.css 2.9 KB
    
    📄 popup.html 20.0 KB
    
    📄 popup.js 27.4 KB
    
    📄 tailwind.config.js 833 B
  - 📄 config.js 4.0 KB
  - 📄 install.md 5.9 KB
  - 📄 manifest.json 1.3 KB
📁 openclaw-plugin/
- 📄 index.mjs 30.9 KB
- 📄 openclaw.plugin.json 2.4 KB
- 📄 package.json 403 B
📁 packages/
- 📁 client-sdk/
  - 📁 policy/
    
    📄 egress.js 3.0 KB
    
    📄 index.js 8.5 KB
    
    📄 origin-utils.js 2.3 KB
    
    📄 taint.js 2.7 KB
    
    📄 task-origin.js 2.0 KB
  - 📄 index.js 14.7 KB
  - 📄 package.json 372 B
- 📁 config/
  - 📄 index.js 5.5 KB
  - 📄 package.json 334 B
- 📁 devtools/
  - 📁 bin/
    
    📄 js-eyes-dev.js 15.8 KB
  - 📁 i18n/
    
    📁 locales/
    
    📄 en-US.js 7.1 KB
    
    📄 zh-CN.js 7.3 KB
    
    📄 index.js 1.2 KB
  - 📁 lib/
    
    📄 builder.js 25.7 KB
    
    📄 clawhub-publish.js 2.7 KB
    
    📄 cloudflare.js 5.8 KB
    
    📄 dotenv.js 1.4 KB
    
    📄 git.js 5.0 KB
    
    📄 github-pages.js 5.1 KB
    
    📄 npm-publish.js 1.9 KB
    
    📄 publish-bundle.js 6.9 KB
  - 📄 package.json 251 B
- 📁 protocol/
  - 📄 index.js 7.8 KB
  - 📄 package.json 294 B
  - 📄 skills.js 17.7 KB
  - 📄 zip-extract.js 7.0 KB
- 📁 runtime-paths/
  - 📄 index.js 6.1 KB
  - 📄 package.json 270 B
  - 📄 token.js 1.9 KB
- 📁 server-core/
  - 📄 audit.js 2.2 KB
  - 📄 auth.js 2.1 KB
  - 📄 index.js 13.5 KB
  - 📄 package.json 446 B
  - 📄 ws-handler.js 19.9 KB
- 📁 skill-recording/
  - 📄 index.js 7.6 KB
  - 📄 package.json 314 B
📁 skills/
- 📁 js-bilibili-ops-skill/
  - 📁 cli/
    
    📄 index.js 1.2 KB
  - 📁 lib/
    
    📄 api.js 6.3 KB
    
    📄 bilibiliUtils.js 15.1 KB
    
    📄 runContext.js 1.1 KB
    
    📄 runtimeConfig.js 634 B
  - 📁 scripts/
    
    📄 bilibili-subtitles.js 2.6 KB
    
    📄 bilibili-video.js 2.8 KB
  - 📄 index.js 1.6 KB
  - 📄 package.json 459 B
  - 📄 skill.contract.js 3.3 KB
  - 📄 SKILL.md 1.6 KB
- 📁 js-browser-ops-skill/
  - 📁 cli/
    
    📄 index.js 1.2 KB
  - 📁 lib/
    
    📄 api.js 3.9 KB
    
    📄 browserUtils.js 11.4 KB
    
    📄 js-eyes-client.js 12.5 KB
    
    📄 runContext.js 914 B
    
    📄 runtimeConfig.js 993 B
  - 📁 scripts/
    
    📄 browser-interact.js 4.1 KB
    
    📄 browser-read.js 2.6 KB
  - 📄 index.js 1.7 KB
  - 📄 package.json 494 B
  - 📄 skill.contract.js 7.0 KB
  - 📄 SKILL.md 4.9 KB
- 📁 js-eyes/
  - 📄 SKILL.md 1.9 KB
- 📁 js-jike-ops-skill/
  - 📁 cli/
    
    📄 index.js 1.2 KB
  - 📁 lib/
    
    📄 api.js 6.3 KB
    
    📄 jikeUtils.js 9.1 KB
    
    📄 js-eyes-client.js 12.5 KB
    
    📄 runContext.js 1.0 KB
    
    📄 runtimeConfig.js 939 B
  - 📁 scripts/
    
    📄 jike-post.js 2.3 KB
  - 📄 index.js 1.5 KB
  - 📄 package.json 440 B
  - 📄 skill.contract.js 3.0 KB
  - 📄 SKILL.md 1.4 KB
- 📁 js-reddit-ops-skill/
  - 📁 cli/
    
    📄 index.js 1.2 KB
  - 📁 lib/
    
    📄 api.js 6.9 KB
    
    📄 cache.js 194 B
    
    📄 debug.js 121 B
    
    📄 history.js 155 B
    
    📄 js-eyes-client.js 12.5 KB
    
    📄 redditUtils.js 21.1 KB
    
    📄 runContext.js 963 B
    
    📄 runtimeConfig.js 1.0 KB
  - 📁 scripts/
    
    📄 reddit-post.js 2.3 KB
  - 📄 index.js 1.5 KB
  - 📄 package.json 495 B
  - 📄 skill.contract.js 3.0 KB
  - 📄 SKILL.md 1.3 KB
- 📁 js-wechat-ops-skill/
  - 📁 cli/
    
    📄 index.js 1.2 KB
  - 📁 lib/
    
    📄 api.js 5.7 KB
    
    📄 js-eyes-client.js 12.5 KB
    
    📄 runContext.js 687 B
    
    📄 runtimeConfig.js 939 B
    
    📄 wechatUtils.js 9.2 KB
  - 📁 scripts/
    
    📄 wechat-article.js 2.5 KB
  - 📄 index.js 1.7 KB
  - 📄 package.json 493 B
  - 📄 skill.contract.js 3.1 KB
  - 📄 SKILL.md 1.8 KB
- 📁 js-x-ops-skill/
  - 📁 cli/
    
    📄 index.js 1.7 KB
  - 📁 lib/
    
    📄 api.js 58.9 KB
    
    📄 js-eyes-client.js 12.5 KB
    
    📄 runtimeConfig.js 939 B
    
    📄 xUtils.js 43.4 KB
  - 📁 scripts/
    
    📄 x-home.js 37.9 KB
    
    📄 x-post.js 128.1 KB
    
    📄 x-profile.js 44.3 KB
    
    📄 x-search.js 45.6 KB
  - 📄 index.js 1.8 KB
  - 📄 package.json 592 B
  - 📄 README.md 5.1 KB
  - 📄 skill.contract.js 9.0 KB
  - 📄 SKILL.md 9.1 KB
- 📁 js-xiaohongshu-ops-skill/
  - 📁 cli/
    
    📄 index.js 1.2 KB
  - 📁 lib/
    
    📄 api.js 6.6 KB
    
    📄 js-eyes-client.js 12.5 KB
    
    📄 runContext.js 998 B
    
    📄 runtimeConfig.js 939 B
    
    📄 xiaohongshuUtils.js 12.0 KB
  - 📁 scripts/
    
    📄 xhs-note.js 2.6 KB
  - 📄 index.js 1.5 KB
  - 📄 package.json 459 B
  - 📄 skill.contract.js 3.3 KB
  - 📄 SKILL.md 1.4 KB
- 📁 js-youtube-ops-skill/
  - 📁 cli/
    
    📄 index.js 1.2 KB
  - 📁 lib/
    
    📄 api.js 6.3 KB
    
    📄 runContext.js 1.1 KB
    
    📄 runtimeConfig.js 634 B
    
    📄 youtubeUtils.js 15.8 KB
  - 📁 scripts/
    
    📄 youtube-subtitles.js 2.6 KB
    
    📄 youtube-video.js 2.8 KB
  - 📄 index.js 1.6 KB
  - 📄 package.json 457 B
  - 📄 skill.contract.js 3.3 KB
  - 📄 SKILL.md 1.6 KB
- 📁 js-zhihu-ops-skill/
  - 📁 cli/
    
    📄 index.js 1.2 KB
  - 📁 lib/
    
    📄 api.js 6.3 KB
    
    📄 js-eyes-client.js 12.5 KB
    
    📄 runContext.js 924 B
    
    📄 runtimeConfig.js 939 B
    
    📄 zhihuUtils.js 8.3 KB
  - 📁 scripts/
    
    📄 zhihu-answer.js 2.3 KB
    
    📄 zhihu-article.js 2.3 KB
  - 📄 index.js 1.6 KB
  - 📄 package.json 494 B
  - 📄 skill.contract.js 3.7 KB
  - 📄 SKILL.md 1.5 KB
📁 src/
- 📁 i18n/
  - 📁 locales/
    
    📄 en-US.js 6.7 KB
    
    📄 zh-CN.js 9.2 KB
  - 📄 index.js 2.4 KB
- 📄 index.html 56.8 KB
📁 test/
- 📄 js-eyes-client.test.js 15.8 KB
- 📄 npm-cli.test.js 17.2 KB
- 📄 skill-bundle.test.js 7.2 KB
- 📄 utils.test.js 11.3 KB
- 📄 ws-handler.test.js 25.9 KB
📄 .clawhubignore 778 B
📄 .env.example 180 B
📄 .gitignore 482 B
📄 CHANGELOG.md 18.1 KB
📄 config.json 187 B
📄 config.json.example 148 B
📄 install.ps1 11.0 KB
📄 install.sh 11.8 KB
📄 LICENSE 1.0 KB
📄 package.json 2.3 KB
📄 README.md 22.2 KB
📄 RELEASE.md 10.3 KB
📄 RELEASE_NOTES.md 20.8 KB
📄 SECURITY.md 14.4 KB
📄 SKILL.md 10.9 KB

SKILL.md

---
name: js-eyes
description: Install, configure, verify, and troubleshoot JS Eyes browser automation for OpenClaw.
version: 2.3.0
metadata: {"openclaw":{"emoji":"\U0001F441","homepage":"https://github.com/imjszhang/js-eyes","os":["darwin","linux","win32"],"requires":{"bins":["node"]}}}
---

# JS Eyes

Use this skill to turn a ClawHub-installed `js-eyes` bundle into a working OpenClaw browser automation stack.

Treat `{baseDir}` as the installed skill root. The plugin path that must be registered in OpenClaw is `{baseDir}/openclaw-plugin`, not `{baseDir}` itself.

## Use This Skill When

- The user wants to install or configure JS Eyes from a ClawHub skill bundle.
- `js_eyes_*` tools are missing after installation.
- The browser extension is installed but still shows `Disconnected`.
- The user wants to verify the built-in server, plugin config, or extension connection.
- The user wants to discover or install JS Eyes extension skills after the base stack is working.

## What Success Looks Like

A successful setup has all of the following:

1. `npm install` has been run in `{baseDir}` with Node.js 22 or newer.
2. OpenClaw loads `{baseDir}/openclaw-plugin` via `plugins.load.paths`.
3. `plugins.entries["js-eyes"].enabled` is `true`.
4. `tools.alsoAllow` (preferred) or `tools.allow` includes `js-eyes`, so the plugin's optional tools are actually exposed to the model.
5. The user can run `openclaw js-eyes status`.
6. The browser extension is connected to `http://<serverHost>:<serverPort>`, the popup **Server Token** field is populated (2.2.0+), and `js_eyes_get_tabs` returns real tabs.
7. The user can later run `js_eyes_discover_skills` / `js_eyes_install_skill` to add extension skills dynamically, and the main plugin auto-loads installed skills from `{baseDir}/skills` or the configured `skillsDir`.
8. `js-eyes doctor` reports a clean security posture (token present, `allowAnonymous=false`, `allowRawEval=false`, host bound to loopback, skill integrity OK).

## Deployment Modes

Treat `{baseDir}` as the bundle or repository root that contains `openclaw-plugin/`, `skills/`, and the package manifests.

There are two supported complete deployment modes:

1. ClawHub / bundle deployment
   - `{baseDir}` is the installed JS Eyes bundle root.
   - Run `npm install` in `{baseDir}` so the plugin runtime can resolve its dependencies.
   - Register `{baseDir}/openclaw-plugin` in OpenClaw.

2. Source-repo / development deployment
   - `{baseDir}` is the root of a local `js-eyes` git clone.
   - Run `npm install` in the repo root, not inside `openclaw-plugin/`.
   - Point OpenClaw `plugins.load.paths` at the repo-root `openclaw-plugin` directory.
   - If you are debugging the browser side, load the extension from `extensions/chrome/` or `extensions/firefox/manifest.json` as appropriate.
   - After plugin/runtime code changes, restart or refresh OpenClaw so the updated plugin code is reloaded.

## Setup Workflow

When the user asks to install, configure, or repair JS Eyes, follow this exact order:

1. Determine the operating system first and choose commands accordingly.
2. Resolve the OpenClaw config path before editing anything.
3. Verify prerequisites:
   - `node -v` must be `>= 22`
   - if the user expects OpenClaw plugin mode, `openclaw --version` should work
4. From `{baseDir}`, run `npm install` if dependencies are missing or if the user just installed the bundle.
5. Update the resolved `openclaw.json`:
   - ensure `plugins.load.paths` contains the absolute path to `{baseDir}/openclaw-plugin`
   - ensure `plugins.entries["js-eyes"].enabled` is `true`
   - ensure `tools.alsoAllow` contains `js-eyes` (preferred additive mode), or ensure `tools.allow` includes `js-eyes`
   - if needed, create `plugins.entries["js-eyes"].config` with:
     - `serverHost: "localhost"`
     - `serverPort: 18080`
     - `autoStartServer: true`
6. Restart or refresh OpenClaw so the plugin is reloaded.
7. Verify with `openclaw js-eyes status`.
8. Initialize the local server token if this is a fresh 2.2.0+ install: `js-eyes server token init`, then `js-eyes server token show --reveal` to copy it into the browser extension popup **Server Token** field.
9. If the server is healthy but no browser is connected, guide the user through browser extension installation, server-token entry, and connection.
10. After the base setup works, prefer `js_eyes_discover_skills` and `js_eyes_install_skill` for extension skills — 2.2.0 writes a plan under `runtime/pending-skills/<id>.json`; finalize with `js-eyes skills approve <id>` then `js-eyes skills enable <id>`.
11. Run `js-eyes doctor` to confirm the hardened defaults (token present, `allowAnonymous=false`, loopback-bound, skill integrity OK) before handing off.

When asked to fix a broken setup, prefer repairing the existing config instead of repeating the whole installation.

## Resolve The OpenClaw Config Path

Use this precedence order:

1. `OPENCLAW_CONFIG_PATH`
2. `OPENCLAW_STATE_DIR/openclaw.json`
3. `OPENCLAW_HOME/.openclaw/openclaw.json`
4. Default:
   - macOS / Linux: `~/.openclaw/openclaw.json`
   - Windows: `%USERPROFILE%/.openclaw/openclaw.json`

Do not assume `~/.openclaw/openclaw.json` if any of the environment variables above are set.

## Recommended Config Shape

Update the resolved OpenClaw config so it contains the plugin path and enablement entry. Append to existing arrays and objects; do not remove unrelated plugins.

```json
{
  "tools": {
    "alsoAllow": ["js-eyes"]
  },
  "plugins": {
    "load": {
      "paths": ["/absolute/path/to/js-eyes/openclaw-plugin"]
    },
    "entries": {
      "js-eyes": {
        "enabled": true,
        "config": {
          "serverHost": "localhost",
          "serverPort": 18080,
          "autoStartServer": true
        }
      }
    }
  }
}
```

Important details:

- The path must end in `openclaw-plugin`.
- On Windows JSON paths, prefer forward slashes such as `C:/Users/name/skills/js-eyes/openclaw-plugin`.
- If `paths` or `entries` already exist, merge rather than overwrite.
- `js-eyes` registers its tools as optional plugin tools, so a complete deployment also needs `tools.alsoAllow: ["js-eyes"]` or an equivalent `tools.allow` entry.

## Verification Workflow

After setup, verify the stack in this order:

1. `openclaw plugins inspect js-eyes`
2. `openclaw js-eyes status`
3. Check whether the built-in server is reachable and reports uptime.
4. Confirm that at least one browser extension client is connected.
5. Ask the agent to use `js_eyes_get_tabs` or run `openclaw js-eyes tabs`.
6. If the user wants extension skills, call `js_eyes_discover_skills` only after the base stack works.

Expected status checks:

- `openclaw plugins inspect js-eyes` shows the plugin as loaded.
- Server responds on `http://localhost:18080` by default.
- `openclaw js-eyes status` shows uptime and browser client counts.
- `js_eyes_get_tabs` returns tabs instead of an empty browser list.

## Browser Extension Connection

If the plugin is enabled but no browser is connected:

1. Install the JS Eyes browser extension separately from GitHub Releases or the website.
2. Open the extension popup.
3. Set the server address to `http://<serverHost>:<serverPort>`.
4. Paste the server token from `js-eyes server token show --reveal` into the **Server Token (2.2.0+)** field.
5. Click `Connect`.
6. Re-run `openclaw js-eyes status`.

The browser extension is not bundled inside the main ClawHub skill. It must be installed separately. Connections without a matching server token are rejected unless the operator has set `security.allowAnonymous=true`.

## Dynamic Extension Skills

The main `js-eyes` bundle is intentionally minimal. It does not preinstall child skills.

After the base plugin works:

- Use `js_eyes_discover_skills` to list available extension skills.
- Use `js_eyes_install_skill` to stage a **plan** — 2.2.0+ downloads the bundle, verifies its `sha256` against `skills.json`, and writes `runtime/pending-skills/<id>.json` without installing.
- Finalize the plan with `js-eyes skills approve <id>`, then enable it with `js-eyes skills enable <id>`.
- Use `js-eyes skills verify` (or `js-eyes doctor`) to confirm `.integrity.json` still matches the on-disk skill files.
- Tell the user that newly installed/approved extension skills usually require an OpenClaw restart or a new session before their tools appear because the main `js-eyes` plugin discovers them on startup.

Do not instruct the user to register child-skill plugin paths manually. Child skills no longer ship their own `openclaw-plugin` wrappers.

Prefer the built-in install flow over manual zip extraction when the user wants additional JS Eyes capabilities.

## Troubleshooting

### `Cannot find module 'ws'`

Run `npm install` in `{baseDir}`. The bundle expects dependencies to be installed from the skill root.

### `js_eyes_*` tools do not appear

Check all three items:

1. `plugins.load.paths` points to `{baseDir}/openclaw-plugin`
2. `plugins.entries["js-eyes"].enabled` is `true`
3. `tools.alsoAllow` or `tools.allow` includes `js-eyes`
4. OpenClaw has been restarted or refreshed since the config change
5. If this is an extension skill, confirm it is not disabled in the JS Eyes host config or legacy OpenClaw child-plugin entries

### Browser Extension Stays Disconnected

Check:

1. `openclaw js-eyes status`
2. `serverHost` / `serverPort` in plugin config
3. The extension popup server URL
4. Whether `autoStartServer` is `true`
5. (2.2.0+) The popup **Server Token** field matches `js-eyes server token show --reveal`. Tail `logs/audit.log` via `js-eyes audit tail` — `conn.reject` with `reason: token` or `reason: origin` points to token/Origin mismatches.

### Sensitive Tool Calls Hang Without Output (2.2.0+)

`execute_script*`, `get_cookies*`, `upload_file*`, `inject_css`, and `install_skill` default to the `confirm` policy and wait for operator approval.

1. `js-eyes consent list` to see pending requests.
2. `js-eyes consent approve <id>` or `js-eyes consent deny <id>` to resolve.
3. To disable the gate for a specific tool, set `security.toolPolicies.<tool>=allow` in `config.json` (logs an audit event).

### Skill Fails to Load With Integrity Error (2.2.0+)

The main plugin refuses to register skills whose files no longer match `.integrity.json`.

1. `js-eyes skills verify <id>` to see which files drifted.
2. Re-install: `js-eyes skills install <id>` → `js-eyes skills approve <id>` → `js-eyes skills enable <id>`.
3. If the drift was expected (manual patch), re-generate the manifest by reinstalling; do not edit `.integrity.json` by hand.

### Custom OpenClaw Config Location

Always resolve `OPENCLAW_CONFIG_PATH`, `OPENCLAW_STATE_DIR`, and `OPENCLAW_HOME` before editing config or telling the user where to look.

## Notes For The Agent

- Prefer performing the setup steps for the user instead of only explaining them.
- Modify existing OpenClaw config carefully; preserve unrelated plugin entries.
- For plugin setup, edit JSON directly rather than asking the user to do it manually unless you are blocked by permissions.
- Once setup is complete, switch from installation guidance to normal use of `js_eyes_*` tools.

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

js-eyes

Directory Structure

SKILL.md

Report

Notice