搜索飞书（Feishu）公开云文档，获取中文知识、教程、资料。触发词：飞搜、飞书搜索、搜索飞书、feisou、feishu search、飞书文档、找中文教程/资料。适用于查找托管在飞书上的中文知识库、运营手册、技术文档。
调用飞搜 API 搜索公开飞书云文档，专为获取中文高质量内容（运营、教程、知识库）。
存储在 ~/.openclaw/personal-secrets.json 的 FEISOU_API_KEY。
取用方式（env 未注入时从 JSON 读）：
KEY=$(python3 -c "import json; print(json.load(open('$HOME/.openclaw/personal-secrets.json'))['FEISOU_API_KEY'])")
KEY=$(python3 -c "import json; print(json.load(open('$HOME/.openclaw/personal-secrets.json'))['FEISOU_API_KEY'])")
curl -sG "https://feisou.app/api/skill/search" \
--data-urlencode "key=$KEY" \
--data-urlencode "q=关键词" \
--data-urlencode "limit=20" | jq
| 参数 | 必填 | 说明 |
|---|---|---|
key | ✅ | API key（fs_...） |
q | ✅ | 搜索词（建议中文） |
limit | - | 默认 20，最大 50 |
{
"query": "小红书运营",
"total": 15,
"results": [
{
"title": "...",
"url": "https://xxx.feishu.cn/docx/...",
"snippet": "...",
"kb_name": "知识库名",
"relevance_score": 0.95
}
],
"usage": { "used": 3, "limit": 6 }
}
KEY=$(python3 -c "import json; print(json.load(open('$HOME/.openclaw/personal-secrets.json'))['FEISOU_API_KEY'])")
curl -sG "https://feisou.app/api/skill/usage" \
--data-urlencode "key=$KEY" | jq
| Code | 含义 |
|---|---|
| 401 | Key 无效或失效 |
| 429 | 今日额度用完 |
| 500 | 服务端错误 |
kb_name 判断来源知识库relevance_score 过滤低质量结果（阈值 0.6+）web_fetch / defuddle 读全文用户："帮我找一些 Python 爬虫的飞书教程"
→ 1. curl search q=Python爬虫教程 limit=10
→ 2. 过滤 relevance_score > 0.6
→ 3. 展示 Top 5（标题+摘要+链接）
→ 4. 可选：web_fetch 第一条读全文做摘要