Zhipu Search

Zhipu AI Web Search Tool - Provides flexible search engine capabilities. Use when: Need to search web information for latest data Need specific search engines (Sogou, Quark, Zhipu Search) Need to filter search results by time range or domain Need to control result count and detail level Supported search engines: search_std (basic), search_pro (advanced), search_pro_sogou (Sogou), search_pro_quark (Quark) Supported parameters: search intent recognition, result count, time filter, domain filter, content size control

Web search via Zhipu AI API, supporting multiple search engines and flexible parameter configuration.

Quick Start

Basic Search

python

# Use default parameters
search_query = "OpenClaw latest version"
search_engine = "search_std"

Advanced Search (Full Parameters)

python

search_query = "AI development trends"      # Required, max 70 chars
search_engine = "search_pro"                # Required: search_std/search_pro/search_pro_sogou/search_pro_quark
search_intent = true                        # Optional, default false, enable search intent recognition
count = 20                                  # Optional, default 10, range 1-50
search_domain_filter = "example.com"        # Optional, whitelist domain filter
search_recency_filter = "oneWeek"           # Optional: oneDay/oneWeek/oneMonth/oneYear/noLimit
content_size = "high"                       # Optional: medium/high, control content detail level
request_id = "unique-request-id"            # Optional, unique request identifier
user_id = "user-123456"                     # Optional, end user ID (6-128 chars)

Usage Methods

Method 1: Direct Script Call (Recommended)

bash

python scripts/zhipu_search.py \
  --query "search content" \
  --engine search_pro \
  --count 10

Method 2: Use OpenClaw Tool

System will automatically select appropriate parameters based on needs.

API Parameter Reference

Parameter	Type	Required	Default	Description
search_query	string	✅	-	Search content, recommended ≤70 chars
search_engine	enum	✅	-	search_std/search_pro/search_pro_sogou/search_pro_quark
search_intent	boolean	-	false	Enable search intent recognition
count	integer	-	10	Result count, 1-50
search_domain_filter	string	-	-	Whitelist domain filter
search_recency_filter	enum	-	noLimit	oneDay/oneWeek/oneMonth/oneYear/noLimit
content_size	enum	-	-	medium/high, control content length
request_id	string	-	-	Unique request identifier
user_id	string	-	-	End user ID (6-128 chars)

Search Engine Selection Guide

Engine	Use Case
search_std	Basic search, regular Q&A
search_pro	Advanced search, need more accurate results
search_pro_sogou	Sogou search, China domestic content
search_pro_quark	Quark search, specific scenarios

Response Structure

json

{
  "id": "task-id",
  "created": 1704067200,
  "request_id": "request-id",
  "search_intent": [
    {
      "query": "original query",
      "intent": "SEARCH_ALL",
      "keywords": "rewritten keywords"
    }
  ],
  "search_result": [
    {
      "title": "title",
      "content": "content summary",
      "link": "result link",
      "media": "site name",
      "icon": "site icon",
      "refer": "reference number",
      "publish_date": "publish date"
    }
  ]
}

Environment Requirements

• Environment variable ZHIPU_API_KEY must be configured
• Python 3.7+
• requests library

Notes

1. search_query should be kept within 70 characters
2. search_pro_sogou count must be 10/20/30/40/50
3. user_id length must be between 6-128 characters if provided
4. Search intent recognition increases response time but improves result relevance