Skip to content

lekt9/unbrowse-openclaw

Repository files navigation

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

openclaw plugins install unbrowse-openclaw
openclaw gateway restart

Verify:

openclaw plugins info unbrowse-openclaw
openclaw unbrowse-plugin health

If you use plugin allowlists, trust it:

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

What agents get

Tool:

{
  "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.

Strict mode

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

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:

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

Local dev install

Load directly from source with plugins.load.paths:

{
  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

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

Dev

npm test
npm run typecheck

About

Openclaw plugin to work with unbrowse cli.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages