Picoclaw Visual Setup (Launcher)

Run the launcher so the setup UI is available at http://localhost:18800. To allow access from other devices on your network (e.g. your phone), use the -public flag:

./picoclaw-launcher -public

On Windows, run picoclaw-launcher.exe -public from a terminal. You can also double-click picoclaw-launcher (or picoclaw-launcher.exe) for localhost-only access.

From the UI you can:

• Add models — card-style model management, set primary model; no API key = grayed out
• Configure channels — form-based setup for Telegram, Discord, Slack, WeCom, etc.
• OAuth login — one-click login for OpenAI, Anthropic, Google Antigravity
• Start/stop gateway — manage the Picoclaw gateway process directly

The command above (./picoclaw-launcher -public) already binds to all interfaces, so you can open the UI from another device on your network. On Windows, create a shortcut with -public in the target if you want LAN access.

-public only makes the launcher reachable on your local network (LAN). To open the setup UI from somewhere else (e.g. when you’re away from home), use one of these options:

• Tunnel service — Run a tunnel so your machine doesn’t need an open port. Examples: ngrok (ngrok http 18800), Cloudflare Tunnel, or Tailscale. You get a URL that forwards to localhost:18800.
• Hosted Picoclaw on ClawNode — Deploy Picoclaw on a VPS; the Control UI is then available over HTTPS at your instance URL from anywhere. No tunnel or port forwarding on your side.

We don’t recommend opening port 18800 directly to the internet (router port forwarding) unless you add authentication or use a VPN; the launcher UI is meant for setup, not public exposure.

If you deployed Picoclaw through ClawNode, your instance runs the gateway on our servers. Use the Control UI link on your instance page to open the web chat and configure channels there. The desktop launcher is for when you run Picoclaw locally (e.g. on your own Mac or PC).