# Send bocha-skill to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "bocha-skill", "name": "bocha-skill", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/ypw757/bocha-skill", "canonicalUrl": "https://clawhub.ai/ypw757/bocha-skill", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/bocha-skill", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bocha-skill", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "scripts/bocha_search.js", "scripts/package.json", "scripts/tool.json", "README.md", "PUBLISH.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "bocha-skill", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-11T18:03:37.827Z", "expiresAt": "2026-05-18T18:03:37.827Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bocha-skill", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=bocha-skill", "contentDisposition": "attachment; filename=\"bocha-skill-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "bocha-skill" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/bocha-skill" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/bocha-skill", "downloadUrl": "https://openagent3.xyz/downloads/bocha-skill", "agentUrl": "https://openagent3.xyz/skills/bocha-skill/agent", "manifestUrl": "https://openagent3.xyz/skills/bocha-skill/agent.json", "briefUrl": "https://openagent3.xyz/skills/bocha-skill/agent.md" } } ``` ## Documentation ### Bocha Search Skill for OpenClaw 🔍 博查AI搜索 - 专为中文内容优化的智能搜索工具 ### Overview This skill provides web search capabilities through the Bocha AI Search API (博查AI搜索). It's particularly effective for: ✅ Chinese language searches (中文搜索) ✅ Domestic Chinese content (国内内容) ✅ News and current events (新闻资讯) ✅ Encyclopedia and knowledge queries (百科知识) ✅ High-quality AI-generated summaries (AI智能摘要) ### Requirements API Key: You need a Bocha API key from https://open.bocha.cn/ Node.js: Required to run the search script Environment Variable: Set BOCHA_API_KEY or configure via OpenClaw settings ### Step 1: Get API Key Visit 博查AI开放平台 Register an account (注册账号) Create an application and get your API KEY Recharge if needed (充值以获得搜索额度) ### Step 2: Configure OpenClaw Add 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" ### Usage 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. ### Features FeatureDescriptionChinese OptimizedBetter results for Chinese language queriesHigh-Quality SummariesAI-generated article summaries (when summary: true)Multi-ModalReturns web pages, images, and related contentTime FilteringFilter results by time range (day/week/month/year)Fast ResponseTypically returns results within 1-2 secondsRich MetadataIncludes publish date, site name, favicon, etc. ### API Parameters When calling the underlying tool directly: ParameterTypeRequiredDefaultDescriptionquerystring✅ Yes-Search query (supports Chinese and English)countnumberNo10Number of results (1-50)freshnessstringNo"noLimit"Time filter: "oneDay", "oneWeek", "oneMonth", "oneYear", "noLimit"summarybooleanNotrueWhether to include AI-generated summaries ### Example Tool Call // Search for recent AI news in Chinese { "query": "人工智能最新进展", "count": 10, "freshness": "oneWeek", "summary": true } // Search for Trump news { "query": "特朗普 Trump 最新新闻", "count": 5, "freshness": "oneDay" } ### Response Format The API returns structured data including: Web Pages: Title, URL, snippet, summary, site name, publish date Images: Thumbnail URL, full image URL, dimensions Total Matches: Estimated total number of matching results Related Queries: Suggested related search terms ### Sample Response Structure { "_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": [...] } } ### Error Handling Common errors and solutions: ErrorCauseSolutionBOCHA_API_KEY is requiredAPI key not configuredAdd API key to config or environmentInvalid API KEYWrong API keyCheck your API key at https://open.bocha.cn/Insufficient balanceOut of creditsRecharge your accountRate limit exceededToo many requestsWait before making more requests ### Pricing Visit https://open.bocha.cn/pricing for current pricing New users typically get free credits to start Pay-as-you-go based on search volume ### API Endpoint URL: https://api.bocha.cn/v1/web-search Method: POST Auth: Bearer token in Authorization header ### Script Location skills/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 ### Comparison with Other Search Tools FeatureBocha SearchBrave SearchPerplexityChinese Content⭐⭐⭐ Excellent⭐⭐ Good⭐⭐ GoodSpeed⭐⭐⭐ Fast⭐⭐⭐ Fast⭐⭐ ModerateSummaries⭐⭐⭐ AI-powered❌ No⭐⭐⭐ AI-poweredImages⭐⭐⭐ Included⭐⭐ Separate⭐ LimitedPricing💰 Affordable🆓 Free tier💰 Moderate ### Best Practices Use Chinese queries for better Chinese content results Enable summaries (summary: true) for better context Set appropriate freshness based on your needs: Breaking news: "oneDay" Recent developments: "oneWeek" General research: "noLimit" Start with count=10, increase if needed (max 50) Handle rate limits gracefully in production use ### No results returned Try different keywords or synonyms Remove time restrictions (freshness: "noLimit") Check if your query is too specific ### Slow response Reduce count parameter Disable summaries if not needed (summary: false) Check network connectivity to api.bocha.cn ### API errors Verify API key is correct and active Check account balance at https://open.bocha.cn/ Ensure you're not exceeding rate limits ### Links 🔗 博查AI开放平台 🔗 API Documentation 🔗 OpenClaw Docs 🔗 ClawdHub ### License MIT 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. ## Trust - Source: tencent - Verification: Indexed source record - Publisher: ypw757 - Version: 1.0.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-11T18:03:37.827Z - Expires at: 2026-05-18T18:03:37.827Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/bocha-skill) - [Send to Agent page](https://openagent3.xyz/skills/bocha-skill/agent) - [JSON manifest](https://openagent3.xyz/skills/bocha-skill/agent.json) - [Markdown brief](https://openagent3.xyz/skills/bocha-skill/agent.md) - [Download page](https://openagent3.xyz/downloads/bocha-skill)