kb-search Skill
Knowledge Base Search - 搜索 OpenClaw 知识库文档
🎯 解决的痛点
| Problem | Solution |
|---|---|
| 遇到问题不知道查文档 | 快速搜索知识库 |
| 文档太多找不到 | 关键词 + 类型过滤 |
| 重复踩坑 | 知识库沉淀解决方案 |
✨ 核心功能
1. 🔍 关键词搜索
- 搜索 docs.openclaw.ai 文档
- 高亮匹配内容
- 返回文档摘要
2. 📂 类型过滤
| 类型 | 说明 | 图标 |
|---|---|---|
| error | 错误/故障排除 | ❌ |
| config | 配置相关 | ⚙️ |
| guide | 安装/部署 | 📖 |
| cli | CLI命令 | 💻 |
| channel | 通道配置 | 📱 |
| general | 一般文档 | 📄 |
3. 📊 智能排序
- 按相关性排序
- 限制返回数量
- 显示匹配度
🚀 快速开始
触发条件：
/kb-search <关键词>- 遇到报错时自动触发
执行方式：
# 简单搜索
/kb-search subagent
# 按类型搜索
/kb-search "401 认证" --type=error
# 限制数量
/kb-search "gateway" --limit=5
📁 知识库位置
~/.openclaw/workspace/docs.openclaw.ai/
├── 01-concepts/ # 核心概念
├── 02-config/ # 配置指南
├── 03-cli/ # CLI命令
├── 04-channels/ # 通道配置
├── 05-skills/ # 技能
└── 06-maintenance/ # 运维保障
💡 使用示例
场景1：Subagent 认证失败
用户：/kb-search "401 认证"
返回：
🔍 搜索: 401 认证
📚 类型: error
📊 结果: 3 篇文档
1. ❌ cli_security.md
📁 gateway/security.md
📝 ...认证失败通常由于 API Key 无效或过期...
场景2：模型配置问题
用户：/kb-search "模型配置"
返回：
🔍 搜索: 模型配置
📚 类型: config
📊 结果: 5 篇文档
📖 故障排查流程
问题发生
↓
/kb-search <错误信息>
↓
查看相关文档
↓
根据文档指导解决问题
↓
解决成功（可选：补充到知识库）
⚠️ 注意事项
- 依赖 docs.openclaw.ai 文档库
- 当前基于关键词匹配，后续可升级语义搜索
- 建议配合 System Agent 健康监控使用
📝 更新日志
- 2026-02-19: 初始化版本