| name | stepfun-search |
| description | StepFun Search API - 实时网络搜索工具。通过 StepFun API 进行互联网搜索，获取最新信息和研究资源。使用场景：用户说"联网搜索 XXX"、"网络搜索 XXX"、"搜索 XXX" 时触发。Triggers: "联网搜索", "网络搜索", "搜索". |
StepFun Search Skill
基于 StepFun API 的实时网络搜索工具。支持多分类搜索、结果过滤和格式化输出。
Configuration
API configuration is stored in ~/.openclaw/openclaw.json using the skills format:
{
"skills": {
"entries": {
"stepfun-search": {
"enabled": true,
"env": {
"STEPFUN_API_KEY": "YOUR_API_KEY"
}
}
}
}
}
The API key is loaded from the STEPFUN_API_KEY environment variable, which is automatically set by OpenClaw's skill system.
📝 Migration Note (2026-03-09)
Previous configuration (❌ DEPRECATED):
{
"tools": {
"web": {
"search": {
"apiKey": "YOUR_API_KEY"
}
}
}
}
New configuration (✅ CURRENT):
- Moved from
tools.web.search.apiKey to skills.entries.stepfun-search.env.STEPFUN_API_KEY
- Reason: OpenClaw core only supports
tools.web natively. Custom search APIs are better managed as skills.
- Benefit: Cleaner config, proper skill isolation, easier to manage multiple API keys
⚠️ Important Note
Do NOT use tools.stepfun or similar! Use the skills format above for all custom tool APIs.
Core Features
1. Research Search (学术搜索)
Find academic papers, research reports, and technical documentation.
Category: research (默认)
Best for:
- 学术论文 (academic papers)
- 研究报告 (research reports)
- 技术文档 (technical docs)
- 白皮书 (whitepapers)
2. Programming Search (编程搜索)
Find code snippets, documentation, and programming solutions.
Category: programming
Best for:
- 代码示例 (code examples)
- 技术文档 (technical docs)
- API 参考 (API reference)
- 教程和指南 (tutorials)
3. Business Search (商业搜索)
Find business news, market insights, and company information.
Category: business
Best for:
- 商业新闻 (business news)
- 市场分析 (market analysis)
- 公司信息 (company info)
- 行业报告 (industry reports)
4. Government Search (政府搜索)
Find government documents, policies, and official information.
Category: gov
Best for:
- 政府文件 (government docs)
- 政策法规 (policies)
- 官方信息 (official info)
Usage Examples
CLI Usage
python3 scripts/stepfun_search.py "transformer attention mechanism" 5 research json
python3 scripts/stepfun_search.py "Python asyncio tutorial" 5 programming json
python3 scripts/stepfun_search.py "AI startup funding" 5 business markdown
python3 scripts/stepfun_search.py "data privacy regulation" 5 gov text
Output Formats
- JSON: Full structured data (default)
- Markdown: Formatted for documents and chat
- Text: Plain text, no markup
Search Tips
✅ Good Search Queries
- Specific and clear: "Stable Diffusion fine-tuning guide"
- Domain-specific: Use category parameter (research/programming/business/gov)
- Keyword-based: "Python async tutorial" (not "How do I learn Python async?")
- Combined terms: "PyTorch image classification" (focused, not broad)
❌ Avoid
- Too broad: "Image", "Data" (use more specific terms)
- Full sentences: Use keywords instead
- Overly long: Keep under 200 characters for best results
Error Handling
Common errors and solutions:
| Error | Solution |
|---|
STEPFUN_API_KEY not set | Check ~/.openclaw/openclaw.json skills config |
Authorization failed | Verify API key is valid and active |
Timeout (>30s) | Retry or simplify query |
No results found | Try different keywords or change category |
Rate Limiting
- Default quota: Up to 100 requests/day (free tier)
- Request timeout: 30 seconds per request
- Max results: 10 per query
Performance Notes
- First request: 2-5 seconds (API processing)
- Cached results: <100ms (15-minute cache TTL)
- Result quality improves with specific queries
Integration with OpenClaw
This skill is integrated with OpenClaw's:
- Natural language triggers - "联网搜索", "网络搜索"
- Agent system - Automatically called via skill dispatcher
- Context persistence - Results cached within session
- Output formatting - Markdown support for chat display
Advanced: API Reference
See references/api-reference.md for:
- Full API endpoint documentation
- Authentication details
- Request/response schemas
- Error codes and handling
