一、Skill 定位 #
ByteRover 是 OpenClaw 生态里最常用的知识库能力之一，核心价值是把分散文档转成“可检索、可引用、可复用”的知识资产。
在实际工作中，它通常承担三件事：
- 把团队资料统一索引，减少重复问答。
- 让回答可回溯到原文来源，便于审核。
- 为后续自动化流程提供稳定知识底座。
二、典型使用场景 #
- 新人入职：快速检索项目规范、部署流程、常见故障。
- 技术支持：从 SOP 和历史案例中检索最接近的处理路径。
- 产品运营：从活动文档与数据周报中抽取可复用结论。
- 研发协作：把 ADR、设计文档、接口说明统一沉淀。
三、安装与前置准备 #
1) 前置条件 #
- 已安装并可正常运行 OpenClaw。
- 已配置可用模型与基础工具。
- 准备好知识源目录（Markdown、PDF、网页导出文档等）。
2) 安装命令 #
# 安装 ByteRover skill
clawhub install byterover
# 同步本地已安装 skills
clawhub sync --all
3) 建议配置 #
在项目环境变量中补齐知识库连接参数，例如：
export BYTEROVER_API_KEY="your_api_key"
export BYTEROVER_INDEX="team-knowledge"
四、手把手使用方法 #
Step 1：建立知识目录结构 #
推荐采用三层结构：
01-guides：操作手册与流程。02-architecture：架构与技术方案。03-ops：运维与故障处理记录。
这样可以显著提升检索召回的稳定性。
Step 2：执行首次入库 #
在会话中给出明确任务描述：
/skill byterover
请将 docs/ 目录文档建立索引，按“架构/运维/业务”打标签，并输出入库摘要。
Step 3：做带引用的问答 #
/skill byterover
基于已索引文档，回答“服务发布失败后如何回滚”，并附来源文件名与章节。
Step 4：做增量更新 #
每次变更只更新新增内容，避免全量重建导致成本升高。
五、排错与注意事项 #
- 检索结果空白：优先检查索引名是否一致、文档是否真的入库。
- 回答不稳定：缩小检索范围，给出更清晰的问题上下文。
- 成本过高：改为增量索引，限制单次检索文档数量。
- 敏感信息泄露风险：入库前先做脱敏，明确禁止目录。
- 版本污染：同一知识库要有版本标识，避免旧文档覆盖新规则。
六、落地清单（可直接执行） #
- 确定知识源目录与命名规范。
- 安装
byterover并完成首次索引。 - 统一问答模板：结论 + 依据 + 来源。
- 每周做一次增量入库和失效文档清理。
- 建立“高频问题榜”，持续优化知识结构。
七、参考资料 #
- OpenClaw Skills 文档：https://docs.openclaw.ai/skills
- ByteRover Skill 说明：https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/byterover
- OpenClaw 安装文档：https://docs.openclaw.ai/install/index