🚀 Official OpenClaw Skill · Zero Dependencies · Node.js 18+

Control instbox Sandboxes
via OpenClaw

Browser automation, web scraping, sandbox command execution, SOCKS5 proxy, Agent tasks, and subscription/pay-per-use billing — install with one command, no pairing code required.

Choose your installation method

Run this command in your terminal. The script installs the skill into OpenClaw and connects to the dispatcher automatically.

bash

      

Copy the prompt below and send it to OpenClaw. OpenClaw will detect the intent, run each step automatically, and confirm when the skill is ready — no manual commands needed.

OpenClaw prompt
Please install the instbox sandbox skill so I can browse the web, take screenshots, run commands, automate browser tasks, and manage billing.

Follow these steps automatically:
1. Check Node.js >= 18: `node --version`
2. Install the skill: `curl -fsSL __BASE__/skills/install-script | bash`
3. Verify the binary: `instbox --version`

After each step, check the output and proceed automatically. If Node.js is missing or below 18, stop and tell me to install it first. When finished, confirm the skill is ready.
↓ Explore Capabilities
41+
Commands
8
Categories
0
External Dependencies
18+
Node.js Minimum
2
Billing Modes
Capabilities

Everything You Need to Automate the Web

instbox is the only browser and network sandbox available in OpenClaw. Use it whenever AI needs to browse, scrape, or execute commands in an isolated environment.

21 cmds
🌐

Browser Automation

Launch Chromium, navigate URLs, take screenshots, click, fill forms, run JavaScript. Full headless browser with device emulation, tabs, and Shadow DOM support.

3 cmds
🕷️

Web Scraping & Crawling

Single-page scraping, recursive site crawling, and sitemap discovery. Integrates with Firecrawl for structured data extraction.

2 cmds
⚙️

Sandbox Command Execution

Run allowlisted POSIX commands and scripts in an isolated OS environment — safe, controlled, and without local risk.

4 cmds
🔌

SOCKS5 Proxy

Start a SOCKS5 proxy on any port to route sandbox traffic through an upstream proxy for network isolation and traffic control.

3 cmds
🤖

Agent Task Automation

Describe tasks in natural language and let the Agent autonomously drive the browser. Supports iteration, time, and navigation limits.

6 cmds
💳

Subscription & Pay-Per-Use

Built-in subscription plans and per-invocation billing. Real-time balance tracking with detailed cost info returned in HTTP response headers.

3 cmds
🔗

Remote Bridge

Link to a remote instbox instance for distributed sandbox access. Check bridge status and seamlessly unlink when done.

3 cmds
🔧

Tool Management

Install and manage extension tools like Firecrawl. List installed tools, check health, and expand sandbox capabilities on demand.

2 cmds
⚗️

Configuration

Configure browser binary path, CDP WebSocket endpoint, and workspace directories. Fully customizable runtime environment.

3 cmds
🔐

Authentication

OIDC-based auto-authentication with zero-config login. Non-blocking auth flow — CLI never blocks, token managed automatically.

How It Works

From Install to Automation in Minutes

Four steps to a fully operational sandbox — no manual configuration required.

1
📦

Install

One command or paste a prompt into OpenClaw

2
🔐

Authenticate

OIDC auto-auth, no pairing code needed

3

Command

Use 41+ commands across browser, scrape, exec, proxy, agent

4
🤖

Automate

Let the Agent drive autonomously or control step-by-step

Use Cases

Real-World Scenarios

See how instbox handles common automation tasks with just a few commands.

Screenshot a Webpage

Capture a full-page screenshot of any URL in seconds.

instbox browser launch
instbox browser navigate https://example.com
instbox browser screenshot --full-page

Fill & Submit a Form

Use @ref selectors from snapshot to interact with forms.

instbox browser navigate https://example.com/login
instbox browser snapshot
instbox browser fill @e3 "[email protected]"
instbox browser click @e5

Crawl a Site for Data

Recursively crawl pages or discover site structure.

instbox scrape crawl https://example.com
instbox scrape map https://example.com

Autonomous Agent Task

Let the Agent find and extract information autonomously.

instbox agent submit \
  "Find pricing and extract plan details" \
  --start-url https://example.com

Share Browser for CAPTCHA

Generate a temporary link for human intervention.

instbox browser share --ttl 10 --mode control
# Share the printed URL with a human

Run Sandbox Commands

Execute allowlisted commands safely in isolation.

instbox exec curl -s https://api.example.com
instbox exec --list-allowed
Command Reference

Full Command Catalog

41+ commands organized across 8 categories. Click to expand.

🌐

Browser

21
browser launchLaunch Chromium instance
browser navigate <url>Navigate to URL
browser snapshotGet accessibility tree with @ref annotations
browser elementsList interactive elements with bounding boxes
browser shadow-infoScan page for shadow DOM hosts
browser click <sel>Click element (CSS or @ref)
browser fill <sel> <text>Clear and fill element
browser type <sel> <text>Type text into element (appends)
browser hover <sel>Hover over an element
browser press <key>Press keyboard key
browser select <sel> <val>Select dropdown option
browser scrollScroll page or element
browser eval <expr>Execute JavaScript in page context
browser screenshotCapture screenshot (PNG/JPEG)
browser emulate <device>Apply device preset emulation
browser devicesList available device presets
browser consoleShow captured console logs
browser shareGenerate temporary access link
browser revokeRevoke access link(s)
browser tab <action>Manage tabs (new, list, switch, close)
browser closeClose browser instance
🕷️

Web Scraping

3
scrape scrape <url>Extract content from single page
scrape crawl <url>Recursively crawl pages
scrape map <url>Discover site structure/sitemap
⚙️

Command Execution

2
exec <command>Run allowlisted POSIX command
exec --list-allowedList allowed commands
🔧

Tool Management

3
tools listList installed tools
tools install <name>Install a tool (e.g., firecrawl)
tools health <name>Check tool health
🔌

SOCKS5 Proxy

4
proxy statusShow proxy status and stats
proxy startStart SOCKS5 proxy
proxy stopStop proxy
proxy upstream <host:port>Set upstream proxy for chaining
🤖

Agent Automation

3
agent submit <prompt>Submit autonomous browser task
agent status <taskId>Get task status and result
agent cancel <taskId>Cancel a running task
⚗️

Configuration

2
config browserConfigure browser binary, CDP endpoint
config workspaceManage workspace directories
🔗

Remote Bridge

3
bridge link <url>Link to a remote instbox
bridge unlinkUnlink from remote instbox
bridge statusShow bridge connection status
Spotlight

Autonomous Browser Agent

Describe what you need in plain language. The Agent handles the rest.

Natural Language Browser Automation

Submit a prompt and let the Agent autonomously navigate pages, click elements, fill forms, extract data, and report results — no manual step-by-step scripting required.

  • --max-iterations — limit loop iterations (default 20, max 50)
  • --max-time — maximum execution time (up to 10 minutes)
  • --max-navigations — cap page navigations (max 20)
  • --start-url — navigate to a URL before starting
$ instbox agent submit \
  "Find the pricing page and extract all plan details" \
  --start-url https://example.com --max-iterations 30
➤ Task submitted: task_a1b2c3
$ instbox agent status task_a1b2c3
➤ Status: running (iteration 12/30)
➤ Current page: https://example.com/pricing
➤ Actions: 8 clicks, 2 navigations
$ instbox agent status task_a1b2c3
➤ Status: completed
➤ Result: Found 3 plans (Basic, Pro, Enterprise)
Architecture

How It All Connects

A proxy-based architecture that keeps your environment isolated and secure.

💬

OpenClaw

AI coding assistant

💻

instbox CLI

Local skill binary

Dispatcher

Proxy, auth, billing

📦

Sandbox

Chromium + POSIX env

The Dispatcher manages pool allocation, session lifecycle, OIDC authentication, and usage-based billing. Each user gets an isolated sandbox lease with automatic expiry and cleanup.

Pricing

Simple, Transparent Billing

Pay for sandbox time, not per command. Choose the model that fits you.

💳

Subscription

Active plan covers pool occupancy. Choose monthly, quarterly, or yearly plans. Overage beyond quota is deducted from balance.

Pay-Per-Use

No subscription needed. Pool occupancy time is charged from your account balance. Top up and go — use only what you need.

Pool Occupancy Billing Charged for sandbox slot time, not per command
$0.01/min Default Rate Configurable by admin via API
1-Minute Minimum Minimum billable duration per lease
Real-Time Tracking Balance info in HTTP response headers
Check your billing status: instbox billing status
Quick Start

Get Started in 60 Seconds

Three common workflows to get you up and running fast.

bash
# Install the skill
curl -fsSL /skills/install-script | bash

# Run any command — auto-triggers auth if needed
instbox browser launch
# → Opens auth URL in browser, prints session ID

# After authorizing, retrieve token
instbox poll-auth <sessionId>

# Now all commands work
instbox status
bash
# Launch browser and navigate
instbox browser launch
instbox browser navigate https://example.com

# Get page structure with @ref selectors
instbox browser snapshot

# Interact using refs from snapshot
instbox browser fill @e3 "[email protected]"
instbox browser click @e5

# Capture the result
instbox browser screenshot --output result.png
bash
# Submit an autonomous task
instbox agent submit \
  "Find the pricing page and extract all plan details" \
  --start-url https://example.com \
  --max-iterations 30

# Check status
instbox agent status <taskId>

# Cancel if needed
instbox agent cancel <taskId>