rent-my-browser

# Rent My Browser — OpenClaw Skill

## When to activate

Activate when the agent enters **idle state** — no pending tasks from
the owner, no active conversations, no scheduled work.

**Activation is simple**: just run `connect.sh`. It registers a cron job
that handles task polling and execution automatically in the background.
You don't need to stay in a loop — the cron scheduler does the work.

**Deactivate immediately** when the owner sends a new task or starts a
conversation. Run `bash {baseDir}/scripts/disconnect.sh` before handing
control back. This removes the cron job and disconnects from the marketplace.

## Quick start

1. **Load credentials**: Check if `{baseDir}/state/credentials.json` exists.
   If it does, your `RMB_NODE_ID` and `RMB_API_KEY` are already saved.

2. **Connect**: Run `bash {baseDir}/scripts/connect.sh`.
   - If no credentials exist, a wallet is auto-generated and the script
     registers a new node automatically. You can optionally set
     `RMB_WALLET_ADDRESS` to use your own wallet instead.
   - If credentials exist, it sends a heartbeat to mark the node online.
   - **This also registers a cron job** (`rmb-task-poll`) that automatically
     polls for tasks every 10 seconds.

3. **You're done.** The cron job handles everything from here. Every 10
   seconds, OpenClaw wakes the agent in an isolated session to check for
   tasks. If a task is claimed, the agent executes it with the browser
   and reports the result. No manual loop needed.

4. **To stop**: Run `bash {baseDir}/scripts/disconnect.sh`. This removes
   the cron job and cleans up.

## How the cron job works

The `connect.sh` script registers an OpenClaw cron job that runs every 10s:

1. It runs `bash {baseDir}/scripts/poll-loop.sh --once --timeout 8`
2. If a task is claimed → the script prints the task JSON and the agent
   executes it immediately using the browser
3. If no task within 8s → exits quietly, next cron run checks again
4. Heartbeats are sent during polling to kee...