kb-search Skill#

Knowledge Base Search - 搜索 OpenClaw 知识库文档

---

🎯 解决的痛点#

ProblemSolution遇到问题不知道查文档快速搜索知识库文档太多找不到关键词 + 类型过滤重复踩坑知识库沉淀解决方案

---

✨ 核心功能#

1. 🔍 关键词搜索#

• 搜索 docs.openclaw.ai 文档
• 高亮匹配内容
• 返回文档摘要

2. 📂 类型过滤#

类型说明图标error错误/故障排除❌config配置相关⚙️guide安装/部署📖cliCLI命令💻channel通道配置📱general一般文档📄

3. 📊 智能排序#

• 按相关性排序
• 限制返回数量
• 显示匹配度

---

🚀 快速开始#

触发条件：

• /kb-search <关键词>
• 遇到报错时自动触发

执行方式：

bash

# 简单搜索
/kb-search subagent

# 按类型搜索
/kb-search "401 认证" --type=error

# 限制数量
/kb-search "gateway" --limit=5

---

📁 知识库位置#

text

~/.openclaw/workspace/docs.openclaw.ai/
├── 01-concepts/     # 核心概念
├── 02-config/       # 配置指南
├── 03-cli/          # CLI命令
├── 04-channels/     # 通道配置
├── 05-skills/       # 技能
└── 06-maintenance/   # 运维保障

---

💡 使用示例#

场景1：Subagent 认证失败#

text

用户：/kb-search "401 认证"

返回：
🔍 搜索: 401 认证
📚 类型: error
📊 结果: 3 篇文档

1. ❌ cli_security.md
   📁 gateway/security.md
   📝 ...认证失败通常由于 API Key 无效或过期...

场景2：模型配置问题#

text

用户：/kb-search "模型配置"

返回：
🔍 搜索: 模型配置
📚 类型: config
📊 结果: 5 篇文档

---

📖 故障排查流程#

text

问题发生
    ↓
/kb-search <错误信息>
    ↓
查看相关文档
    ↓
根据文档指导解决问题
    ↓
解决成功（可选：补充到知识库）

---

⚠️ 注意事项#

• 依赖 docs.openclaw.ai 文档库
• 当前基于关键词匹配，后续可升级语义搜索
• 建议配合 System Agent 健康监控使用

---

📝 更新日志#

• 2026-02-19: 初始化版本