Sokko Docs
Guides

Web search & browser

Let your agents search the web out of the box, and give them a real browser to act on websites.

Your agents can use the web in two ways: web search (look things up) and the built-in browser (act on real pages — click, fill, log in). They're separate features: search works on every paid plan with zero setup, the browser is included from the Jar plan.

OpenClaw and Hermes agents can search the web out of the box — Sokko provides the search service, and there is nothing to configure. Just ask your agent to look something up.

Paperclip agents search through the coding assistants they run (Claude Code, Codex, Gemini), which bring their own web search.

Use your own Brave key (optional)

Sokko's built-in search runs on Brave Search. If you'd rather use your own Brave API key (their free tier works fine), add a secret named BRAVE_API_KEY in the agent's Secrets tab and redeploy. Your key automatically takes priority over Sokko's.

Built-in browser

From the Jar plan up, your agents get a real Chromium browser they can drive: open pages, click buttons, fill forms, and stay logged in to the sites you use. Available for OpenClaw, Hermes, Paperclip, and Cursor agents.

Turn it on

Open your agent in the dashboard, go to Advanced, and flip on Agent Browser. The agent redeploys and connects to the browser automatically.

Ask the agent to browse

OpenClaw and Hermes use the browser natively — just ask ("open the pricing page and screenshot it"). Paperclip and Cursor agents use the sokko-browser command from their terminal.

One browser per organization

All agents in your organization share one browser with one profile — cookies and logins made by one agent are visible to the others. That's handy (log in once, every agent can use the session) but means you should only enable it for agents you trust with those sessions. Logins persist across restarts and re-enables.

On plans below Jar the toggle shows an upgrade prompt instead.

On this page