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