Dispatch Mode

Your agent runs on a dedicated server 24/7. Dispatch Mode creates a secure tunnel between your agent and your personal computer. When you run the relay, your agent can see your screen and interact with any application — just like a remote assistant sitting at your desk.

Easiest way: Go to instaclaw.io/settings and click "Connect Your Computer". It downloads a small file — double-click it and you're connected.

Or from your terminal:

npx @instaclaw/dispatch

You'll be asked for a pairing code (shown on your Settings page). Enter it and the relay connects automatically via encrypted WebSocket.

• Node.js 18 or later
• Pro or Power tier subscription
• macOS: Grant Accessibility and Screen Recording permissions to your terminal app (Terminal, iTerm, Warp, etc.)
• Windows: No special permissions needed
• Linux: X11 display server (Wayland not yet supported)

• Take screenshots of your screen
• Click at any position
• Type text via keyboard
• Press key combos (Cmd+C, Ctrl+V, etc.)
• Drag and drop between positions
• Scroll in any direction
• List open windows
• Open and control any desktop application
• Batch actions — execute multiple actions in one round-trip (click, type, press Enter) for 2-3x faster task completion

Supervised (default)

Every action the agent wants to take is shown in your terminal. Press Enter to approve or 'n' to deny. Screenshots are auto-approved.

Autonomous

Auto-approves most actions. Dangerous actions (passwords, delete, purchases) still require your confirmation. Enable with:

npx @instaclaw/dispatch --autonomous

Dispatch v0.5 introduced action batching and optimized screenshots for significantly faster computer control.

• Batch actions: Your agent plans multiple steps (click, type, press Enter) and executes them in a single round-trip instead of one at a time — 2-3x faster for multi-step tasks
• WebP screenshots: 50-60% smaller than the previous JPEG format, reducing transfer time without losing visual quality
• Smart verification: Your agent only takes screenshots at decision points, not after every keystroke — cutting vision costs by up to 70%

A typical 20-step task that previously took 1-3 minutes now completes in 25-45 seconds.

macOS requires two permissions for computer control:

1. Accessibility — allows mouse clicks and keyboard input.
   System Settings → Privacy & Security → Accessibility → enable your terminal app
2. Screen Recording — allows screenshots.
   System Settings → Privacy & Security → Screen Recording → enable your terminal app

Note: macOS Sequoia may re-prompt for Screen Recording permission monthly. This is an Apple security feature, not an InstaClaw issue.

• All communication is encrypted via TLS (WebSocket Secure)
• Authentication uses your unique gateway token — only your agent can send commands
• Supervised mode lets you approve every action before it executes
• Dangerous actions (passwords, deletions, purchases) always require confirmation, even in autonomous mode
• Press Ctrl+C at any time to immediately disconnect and stop all agent control