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: 初始化版本