Web Search

The web search tool enables PocketPaw to search the internet for real-time information.

Providers

Two search providers are supported:

Tavily is an AI-optimized search API that returns clean, structured results.

Terminal window
export POCKETCLAW_WEB_SEARCH_PROVIDER="tavily"
export POCKETCLAW_TAVILY_API_KEY="tvly-your-key"

Brave Search offers a privacy-focused search API.

Terminal window
export POCKETCLAW_WEB_SEARCH_PROVIDER="brave"
export POCKETCLAW_BRAVE_SEARCH_API_KEY="your-key"

Usage

The agent can use web search automatically when it needs to find information:

User: What's the latest version of Python?
Agent: [uses web_search tool] → Python 3.13 is the latest stable version...

Tool Schema

{
  "name": "web_search",
  "description": "Search the web for current information",
  "input_schema": {
    "type": "object",
    "properties": {
      "query": {
        "type": "string",
        "description": "The search query"
      },
      "max_results": {
        "type": "integer",
        "description": "Maximum number of results (default: 5)"
      }
    },
    "required": ["query"]
  }
}

Policy Group

The web search tool belongs to group:search. To control access:

Terminal window
# Allow web search
export POCKETCLAW_TOOLS_ALLOW="group:search"


# Or deny it
export POCKETCLAW_TOOLS_DENY="web_search"
Last updated: February 12, 2026
Edit this page