bocha-skillSearch the web using Bocha AI Search API (博查AI搜索) - a Chinese search engine optimized for Chinese content. Requires BOCHA_API_KEY. Supports web pages, images, and news with high-quality summaries.
Install via ClawdBot CLI:
clawdbot install ypw757/bocha-skill🔍 博查AI搜索 - 专为中文内容优化的智能搜索工具
This skill provides web search capabilities through the Bocha AI Search API (博查AI搜索). It's particularly effective for:
BOCHA_API_KEY or configure via OpenClaw settingsAdd to ~/.openclaw/openclaw.json:
{
"skills": {
"entries": {
"bocha-search": {
"enabled": true,
"apiKey": "your-bocha-api-key-here",
"env": {
"BOCHA_API_KEY": "your-bocha-api-key-here"
}
}
}
}
}Or set environment variable:
export BOCHA_API_KEY="your-bocha-api-key-here"Once configured, you can use this skill by asking in Chinese or English:
"搜索北京今天的天气"
"用博查查找人工智能的最新进展"
"bocha search: 量子计算发展趋势"
"查找特朗普的最新新闻"The skill will automatically route Chinese queries or explicit "bocha" / "博查" / "search" requests to this search provider.
| Feature | Description |
|---------|-------------|
| Chinese Optimized | Better results for Chinese language queries |
| High-Quality Summaries | AI-generated article summaries (when summary: true) |
| Multi-Modal | Returns web pages, images, and related content |
| Time Filtering | Filter results by time range (day/week/month/year) |
| Fast Response | Typically returns results within 1-2 seconds |
| Rich Metadata | Includes publish date, site name, favicon, etc. |
When calling the underlying tool directly:
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| query | string | ✅ Yes | - | Search query (supports Chinese and English) |
| count | number | No | 10 | Number of results (1-50) |
| freshness | string | No | "noLimit" | Time filter: "oneDay", "oneWeek", "oneMonth", "oneYear", "noLimit" |
| summary | boolean | No | true | Whether to include AI-generated summaries |
// Search for recent AI news in Chinese
{
"query": "人工智能最新进展",
"count": 10,
"freshness": "oneWeek",
"summary": true
}
// Search for Trump news
{
"query": "特朗普 Trump 最新新闻",
"count": 5,
"freshness": "oneDay"
}The API returns structured data including:
{
"_type": "SearchResponse",
"queryContext": {
"originalQuery": "search term"
},
"webPages": {
"totalEstimatedMatches": 1908646,
"value": [
{
"name": "Article Title",
"url": "https://example.com/article",
"snippet": "Short description...",
"summary": "Full AI-generated summary...",
"siteName": "Example Site",
"datePublished": "2026-01-30T07:19:14+08:00"
}
]
},
"images": {
"value": [...]
}
}Common errors and solutions:
| Error | Cause | Solution |
|-------|-------|----------|
| BOCHA_API_KEY is required | API key not configured | Add API key to config or environment |
| Invalid API KEY | Wrong API key | Check your API key at https://open.bocha.cn/ |
| Insufficient balance | Out of credits | Recharge your account |
| Rate limit exceeded | Too many requests | Wait before making more requests |
https://api.bocha.cn/v1/web-searchskills/bocha-search/
├── SKILL.md # This file
├── README.md # Full documentation
├── LICENSE # MIT License
└── scripts/
├── package.json # Node.js config
├── tool.json # OpenClaw tool definition
└── bocha_search.js # Main search script ⬅️ Entry point| Feature | Bocha Search | Brave Search | Perplexity |
|---------|--------------|--------------|------------|
| Chinese Content | ⭐⭐⭐ Excellent | ⭐⭐ Good | ⭐⭐ Good |
| Speed | ⭐⭐⭐ Fast | ⭐⭐⭐ Fast | ⭐⭐ Moderate |
| Summaries | ⭐⭐⭐ AI-powered | ❌ No | ⭐⭐⭐ AI-powered |
| Images | ⭐⭐⭐ Included | ⭐⭐ Separate | ⭐ Limited |
| Pricing | 💰 Affordable | 🆓 Free tier | 💰 Moderate |
summary: true) for better context"oneDay""oneWeek""noLimit"freshness: "noLimit")count parametersummary: false)api.bocha.cnMIT License - See LICENSE file for details
Note: This skill is specifically designed for OpenClaw and uses the official Bocha AI Search API. It is not affiliated with or endorsed by Bocha AI.
Generated Feb 23, 2026
Businesses analyzing Chinese consumer trends can use this skill to search for recent news, social media discussions, and industry reports in Chinese. It provides AI summaries to quickly digest content, helping identify market opportunities and competitive insights.
Researchers studying Chinese history, politics, or technology can leverage this skill to find scholarly articles, news, and encyclopedia entries in Chinese. The time filtering and summaries aid in gathering up-to-date sources efficiently.
Content creators targeting Chinese-speaking audiences can use this skill to search for trending topics, images, and news in Chinese. It helps generate ideas and verify facts, ensuring relevance and accuracy in blogs or social media posts.
Companies operating in China can monitor local news, regulatory changes, and competitor activities using this skill. The fast response and high-quality summaries enable timely decision-making and risk assessment.
Language learners and translators can search for authentic Chinese content to improve vocabulary and cultural understanding. The skill's optimization for Chinese queries ensures access to native materials and contextual examples.
Charge users based on the number of search queries made through the Bocha API. This model suits developers and businesses with variable search needs, offering scalability and cost control. Revenue comes from API usage fees.
Offer tiered subscription plans with different search limits, features like advanced summaries, and priority support. This model targets enterprises and heavy users seeking predictable costs and enhanced capabilities.
License the search technology to other companies for integration into their own products, such as news apps or research tools. Revenue is generated through licensing fees and customization services.
💬 Integration Tip
Ensure the BOCHA_API_KEY is securely stored in environment variables and test with simple Chinese queries first to verify connectivity and results.
Summarize URLs or files with the summarize CLI (web, PDFs, images, audio, YouTube).
AI-optimized web search via Tavily API. Returns concise, relevant results for AI agents.
This skill should be used when users need to search the web for information, find current content, look up news articles, search for images, or find videos. It uses DuckDuckGo's search API to return results in clean, formatted output (text, markdown, or JSON). Use for research, fact-checking, finding recent information, or gathering web resources.
Web search and content extraction via Brave Search API. Use for searching documentation, facts, or any web content. Lightweight, no browser required.
Search indexed Discord community discussions via Answer Overflow. Find solutions to coding problems, library issues, and community Q&A that only exist in Discord conversations.
Multi search engine integration with 17 engines (8 CN + 9 Global). Supports advanced search operators, time filters, site search, privacy engines, and WolframAlpha knowledge queries. No API keys required.