## 一、Skill 定位

`ByteRover` 是 OpenClaw 生态里最常用的知识库能力之一，核心价值是把分散文档转成“可检索、可引用、可复用”的知识资产。  
在实际工作中，它通常承担三件事：

1. 把团队资料统一索引，减少重复问答。
2. 让回答可回溯到原文来源，便于审核。
3. 为后续自动化流程提供稳定知识底座。

## 二、典型使用场景

1. 新人入职：快速检索项目规范、部署流程、常见故障。
2. 技术支持：从 SOP 和历史案例中检索最接近的处理路径。
3. 产品运营：从活动文档与数据周报中抽取可复用结论。
4. 研发协作：把 ADR、设计文档、接口说明统一沉淀。

## 三、安装与前置准备

### 1) 前置条件

1. 已安装并可正常运行 OpenClaw。
2. 已配置可用模型与基础工具。
3. 准备好知识源目录（Markdown、PDF、网页导出文档等）。

### 2) 安装命令

```bash
# 安装 ByteRover skill
clawhub install byterover

# 同步本地已安装 skills
clawhub sync --all
```

### 3) 建议配置

在项目环境变量中补齐知识库连接参数，例如：

```bash
export BYTEROVER_API_KEY="your_api_key"
export BYTEROVER_INDEX="team-knowledge"
```

## 四、手把手使用方法

### Step 1：建立知识目录结构

推荐采用三层结构：

1. `01-guides`：操作手册与流程。
2. `02-architecture`：架构与技术方案。
3. `03-ops`：运维与故障处理记录。

这样可以显著提升检索召回的稳定性。

### Step 2：执行首次入库

在会话中给出明确任务描述：

```text
/skill byterover
请将 docs/ 目录文档建立索引，按“架构/运维/业务”打标签，并输出入库摘要。
```

### Step 3：做带引用的问答

```text
/skill byterover
基于已索引文档，回答“服务发布失败后如何回滚”，并附来源文件名与章节。
```

### Step 4：做增量更新

每次变更只更新新增内容，避免全量重建导致成本升高。

## 五、排错与注意事项

1. **检索结果空白**：优先检查索引名是否一致、文档是否真的入库。
2. **回答不稳定**：缩小检索范围，给出更清晰的问题上下文。
3. **成本过高**：改为增量索引，限制单次检索文档数量。
4. **敏感信息泄露风险**：入库前先做脱敏，明确禁止目录。
5. **版本污染**：同一知识库要有版本标识，避免旧文档覆盖新规则。

## 六、落地清单（可直接执行）

1. 确定知识源目录与命名规范。
2. 安装 `byterover` 并完成首次索引。
3. 统一问答模板：结论 + 依据 + 来源。
4. 每周做一次增量入库和失效文档清理。
5. 建立“高频问题榜”，持续优化知识结构。

## 七、参考资料

1. OpenClaw Skills 文档：https://docs.openclaw.ai/skills
2. ByteRover Skill 说明：https://github.com/sundial-org/awesome-openclaw-skills/tree/main/skills/byterover
3. OpenClaw 安装文档：https://docs.openclaw.ai/install/index