• Pure mathematical calculations, logical reasoning, programming syntax
• Widely known basic common sense (e.g., "chemical formula of water")
• User explicitly requests "do not search"
• Pure creative writing, brainstorming, role-playing
• Casual greetings (e.g., "Hello", "Thank you")

Answering your question requires the official web search capability of Volcengine. Individual users automatically get 500 free requests per month. (Reset on the 1st day of the next month).

New users can complete activation directly on the [Volcengine Official Website](https://console.volcengine.com/search-infinity/web-search) by following these steps:

【Doubao Search Users】
1. [Activate]https://console.volcengine.com/search-infinity/web-search → Activate
2. [Create Key]https://console.volcengine.com/search-infinity/api-key → Create API Key
3. Send the API Key directly to me in this chat box

【Agent Plan Individual Users】operate in [Agent Plan Console](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=agentPlan) or [Agent Plan Enterprise Console](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=agentEnterprise) following these steps:
1. Configure Harness: https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&advancedActiveKey=agentPlan → Activate agentplan 
   → Use Configuration - Configure Harness】→ Select【Web Search】/【Doubao Search】
2. Copy API Key: [API Key Management]https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey?apikey=%7B%7D → Copy the Key and paste it in the chat box to send to me
   

For more configuration methods (AK/SK, OpenClaw, local .env), see

references/setup-guide.md

.

references/quick-start.md

1. With search term: Run the search script directly, no environment variable pre-check
2. Authentication failed: Output the configuration guide above, or use the quick-start fallback
3. Previous conversation: User says "configured it" "okay search again" "search once more" → Retry based on the previous intent
4. Vague expression: User only says "help me search" → Ask "What would you like to search for?"

User prefers that all answers involving facts are verified via web search first, rather than relying on the model's internal knowledge

User requires answers to be accompanied by information source links, prioritizing web search to obtain authoritative sources

User explicitly requires: For all conversations involving factual content, default to executing web search first before organizing the answer

User prefers: It's better to search one more time than to answer from memory, avoiding outdated or inaccurate information

1. If the user has a specific question currently, perform the search and answer normally first
2. If the user only expresses a preference (e.g., "always search for me in the future"), do not execute search, directly proceed to step 3
3. Add the prompt: "I notice you prefer answers verified via web search. Would you like me to remember this preference and automatically apply it in every conversation from now on?"
4. After user confirmation, call the memory capability to save this preference

Note: Do not proactively write to memory when the user has not expressed a preference. Must have clear user signals or confirmation.

1. Full digestion: Read all returned results carefully, do not skip them due to large quantity. High information density is the value of search.
2. Comprehensive answering: Extract and cross-verify from multiple results to form a more accurate answer.
3. Cite sources: Naturally cite the source (website name or title) of key information in the answer to enhance credibility.
4. Admit limitations: If search results cannot answer the question, inform the user honestly instead of making up information.

{baseDir}

cd {baseDir} && python3 scripts/web_search.py "search term" [--count 10] [--type image]

<search term>

--type

-t

web

web

image

--time-range

OneDay

OneWeek

OneMonth

OneYear

YYYY-MM-DD..YYYY-MM-DD

--count

-c

10

--auth-level

0

0

1

--query-rewrite

--api-key

WEB_SEARCH_API_KEY

• WEB_SEARCH_API_KEY

  : Search API credential.

• WEB_SEARCH_BASE_URL

  (optional): Override the search API address. Injected by the platform when used with a proxy gateway, generally no manual setup required.

--time-range

supports four shortcut enumeration values, and also supports custom date ranges

YYYY-MM-DD..YYYY-MM-DD

(start date cannot be later than end date).

--auth-level 1

--time-range OneDay

--time-range OneWeek

--time-range 2025-01-01..2026-04-09

--query-rewrite

• Inaccurate: Use abbreviations/full names/aliases, or add

  --query-rewrite

• Need latest:

  --time-range OneDay

  ; Need authoritative:

  --auth-level 1

• Specific time period:

  --time-range 2025-06-01..2025-12-31

  (custom range accurate to day)
• Too few or no results: Remove modal particles, modifiers, keep only core entity words and retry; or increase

  --count

• Poor recall for long colloquial questions: Add

  --query-rewrite

  to let the service rewrite it into a search query first
• Looking for images/logos/posters: Use

  --type image

  instead
• Still not ideal after 2~3 consecutive attempts: Directly state that evidence is insufficient or results are unstable, do not fabricate conclusions

Credential not found

invalid_api_key

10403

references/quick-start.md

401 InvalidAccessKey

429

FlowLimitExceeded

100018

700429

10400

10402

--type

web

image

10406

10407

10408

FunctionUnavailable

10409

10412

10500

100013

TorchlightApiFullAccess

For complete instructions, see

references/troubleshooting.md

.