// Use Valyu (valyu.ai) to search the web, extract content from web pages, answer with sources, and do deepresearch.
[HINT] Download the complete skill directory including SKILL.md and all related files
| name | valyu-search |
| description | Use Valyu (valyu.ai) to search the web, extract content from web pages, answer with sources, and do deepresearch. |
| metadata | {"openclaw":{"emoji":"🔎","requires":{"bins":["node"],"env":["VALYU_API_KEY"]},"primaryEnv":"VALYU_API_KEY","homepage":"https://docs.valyu.ai"}} |
Search across the world's knowledge.
Trigger this skill when the user asks for:
VALYU_API_KEY in the Gateway environment (recommended) or in ~/.openclaw/.env.Run a search across the web:
node {baseDir}/scripts/valyu.mjs search web "<query>"
Search across news, academic papers, financial data, patents and more
node {baseDir}/scripts/valyu.mjs search news "<query>"
| Parameter | Type | Description |
|---|---|---|
query | string | Search query (required) |
searchType | string | "web", "proprietary", "news", or "all" (default: "all") |
maxNumResults | number | 1-20 (default: 10) |
includedSources | string[] | Limit to specific sources (e.g., ["valyu/valyu-arxiv"]) |
excludedSources | string[] | Exclude specific sources |
startDate | string | Filter from date (YYYY-MM-DD) |
endDate | string | Filter to date (YYYY-MM-DD) |
countryCode | string | ISO 3166-1 alpha-2 (e.g., "US", "GB") |
responseLength | string | "short", "medium", "large", "max" |
fastMode | boolean | Reduced latency mode |
category | string | Natural language category (e.g., "academic research") |
relevanceThreshold | number | 0.0-1.0 (default: 0.5) |
| Source | Description |
|---|---|
valyu/valyu-arxiv | Academic papers from arXiv |
valyu/valyu-pubmed | Medical and life science literature |
valyu/valyu-stocks | Global stock market data |
Additional sources: BioRxiv, MedRxiv, clinical trials, FDA drug labels, WHO health data, SEC filings, USPTO patents, Wikipedia, UK Parliament, UK National Rail, maritime vessel tracking, and more.
Extract clean, structured content from any URL. Converts web pages to markdown or structured data.
node {baseDir}/scripts/valyu.mjs contents "https://example.com" --summary
| Parameter | Type | Description |
|---|---|---|
urls | string[] | Array of URLs to extract (required) |
responseLength | string | Output length: "short", "medium", "large", "max" |
extractEffort | string | "auto", "lightweight", "moderate", "heavy" |
jsonSchema | object | JSON Schema for structured extraction |
Get AI-generated answers grounded in real-time search results with citations.
node {baseDir}/scripts/valyu.mjs answer "What is quantum computing?" --fast
| Parameter | Type | Description |
|---|---|---|
query | string | Question or query (required) |
searchType | string | Search scope: "web", "proprietary", "news", "all" |
outputSchema | object | JSON Schema for structured responses |
Launch async, multi-step research tasks that produce detailed reports with citations.
| Mode | Duration | Use Case |
|---|---|---|
fast | ~5 min | Quick answers, lightweight research |
standard | ~10-20 min | Balanced research with deeper insights |
heavy | ~90 min | In-depth, complex analysis |
node {baseDir}/scripts/valyu.mjs deepresearch create "AI market trends" --mode heavy --pdf
| Parameter | Type | Description |
|---|---|---|
query | string | Research query (required) |
mode | string | "fast", "standard", "heavy" |
outputFormats | array | ["markdown"], ["pdf"], or JSON Schema object |
files | array | File attachments (base64 encoded, max 10) |
urls | string[] | URLs to analyze (max 10) |
webhookUrl | string | HTTPS URL for completion notification |
| Need | API |
|---|---|
| Quick facts, current events, citations | Search |
| Read/parse a specific URL | Contents |
| AI-synthesized answer with sources | Answer |
| In-depth analysis or report | DeepResearch |