Unbrowse Openclaw

Name: Unbrowse Openclaw
Rating: 3.5 (1 reviews)
Author: lekt9

By lekt9 👁 62 views ▲ 0 votes

Openclaw plugin to work with unbrowse cli.

GitHub

Install

openclaw plugins install unbrowse-openclaw

Configuration Example

{
  "action": "resolve",
  "intent": "get pricing page API data",
  "url": "https://example.com"
}

README

# unbrowse-openclaw

Use Unbrowse inside OpenClaw.

This plugin adds a native `unbrowse` tool, teaches agents to use it first for website tasks, and gives you a strict mode that can keep agents off the built-in `browser` tool.

Use it when you want API-first web work: structured extraction, reverse-engineered site actions, less brittle browser automation.

## Install

```bash
openclaw plugins install unbrowse-openclaw
openclaw gateway restart
```

Verify:

```bash
openclaw plugins info unbrowse-openclaw
openclaw unbrowse-plugin health
```

If you use plugin allowlists, trust it:

```json5
{
  plugins: {
    allow: ["unbrowse-openclaw"]
  }
}
```

## What agents get

Tool:

```json
{
  "action": "resolve",
  "intent": "get pricing page API data",
  "url": "https://example.com"
}
```

Actions: `resolve`, `search`, `execute`, `login`, `skills`, `skill`, `health`

Integration:

- bootstrap guidance plus a `before_agent_start` system-prompt hint each run
- a shipped `unbrowse-browser` skill so the replacement policy shows up in OpenClaw's skill surface
- strict-mode blocking of the built-in `browser` tool via `before_tool_call`

## Default web path

This plugin makes `unbrowse` the default web path in practice by:

- teaching the agent to prefer `unbrowse`
- shipping a skill that reinforces the policy
- optionally blocking `browser` in strict mode

### Fallback mode

Prefer Unbrowse first. Let `browser` handle real UI-only tasks.

- [examples/openclaw.fallback.json5](./examples/openclaw.fallback.json5)

### Strict mode

Route normal web tasks through Unbrowse by blocking the built-in `browser` tool.

- [examples/openclaw.strict.json5](./examples/openclaw.strict.json5)

Strict mode is the closest thing to making Unbrowse the default browser path without patching OpenClaw core.

## Tool policy

If you use tool allowlists, allow one of:

- plugin id: `unbrowse-openclaw`
- tool name: `browser`
- tool name: `unbrowse`
- `group:plugins`

Example:

```json5
{
  tools: {
    allow: ["browser", "unbrowse"]
  }
}
```

## Local dev install

Load directly from source with `plugins.load.paths`:

```json5
{
  plugins: {
    allow: ["unbrowse-openclaw"],
    load: { paths: ["/absolute/path/to/unbrowse-openclaw"] },
    entries: {
      "unbrowse-openclaw": {
        enabled: true,
        config: {
          routingMode: "fallback",
          preferInBootstrap: true,
          allowBrowserFallback: true,
          timeoutMs: 120000
        }
      }
    }
  }
}
```

## CLI helpers

```bash
openclaw unbrowse-plugin health
openclaw unbrowse-plugin print-bootstrap
openclaw unbrowse-plugin print-config strict
openclaw unbrowse-plugin print-config fallback
```

## Dev

```bash
npm test
npm run typecheck
```

tools