13 虚拟人落地从配置到实战这是《Git 仓库蒸馏术从代码仓库到 OpenClaw 虚拟人》系列的第 13 篇。前 12 篇我们完成了蒸馏、虚拟人机制、知识注入与技能绑定——虚拟人已经造出来了。这一篇是实战篇把虚拟人部署起来在真实场景中发挥作用并持续维护更新。一、虚拟人部署与启动1.1 部署前置检查启动前先做一次体检# 1. 检查配置完整性tree .openclaw/personas/repo-guru/# 2. 检查 YAML 语法python-c import yaml, glob for f in glob.glob(.openclaw/**/*.yaml, recursiveTrue): yaml.safe_load(open(f, encodingutf-8)) print(fOK: {f}) # 3. 检查 memory 非空find.openclaw/personas/repo-guru/memory/-name*.md-size0|wc-l# 4. 检查 graph.json 可解析python-cimport json; json.load(open(.openclaw/personas/repo-guru/memory/graph.json))1.2 启动虚拟人# 启动虚拟人交互模式openclaw start--personarepo-guru# 启动后进入对话openclaw ask项目架构是怎样的# 非交互单次提问openclaw ask--personarepo-guru为什么用 Pinia# 查看运行状态openclaw status1.3 启动配置# .openclaw/config.yaml# 全局启动配置persona:repo-guru# 默认虚拟人model:default# 使用的模型memory:auto_reload:true# 仓库变化时自动重载index:true# 建立记忆索引skills:auto_bind:true# 自动绑定技能logging:level:infofile:.openclaw/logs/run.log二、使用场景问答、代码审查、知识检索2.1 场景一知识问答虚拟人最基础的使用场景——回答项目相关问题# 架构类问题openclaw ask项目的模块划分是怎样的# 决策类问题openclaw ask为什么选择 Pinia 而不是 Vuex# 历史类问题openclaw ask项目经历过哪些重要里程碑示例回答项目的模块划分如下来源architecture.mdsrc/views/页面视图层src/components/通用组件层src/stores/状态管理层Piniasrc/api/接口请求层src/utils/工具函数层各层之间单向依赖views → components → stores → api。2.2 场景二代码审查虚拟人结合模式库可以做模式合规审查# 审查一段代码是否符合项目模式openclaw ask这段代码符合项目的 store 模式吗--attachsrc/stores/user.ts# 审查新提交openclaw ask审查一下最近这次提交的代码--attach(gitshow HEAD)示例回答这段代码不完全符合项目的 store 模式来源patterns/✅ 使用了defineStore符合模式要求❌ 缺少reset方法——项目模式要求每个 store 提供 reset❌ 直接修改了 state应通过 action 修改建议补充 reset 方法将状态修改封装为 action。2.3 场景三知识检索虚拟人作为项目知识入口快速定位知识# 检索某个概念openclaw ask什么是模型汇聚# 检索某个坑点openclaw ask迁移 Pinia 时踩过什么坑# 检索决策依据openclaw ask为什么 API 层要统一封装2.4 场景对比场景依赖要素典型问题价值知识问答memory架构/决策/历史新人快速上手代码审查skills memory模式合规保证代码一致性知识检索memory graph概念/坑点/依据知识沉淀复用三、维护与更新3.1 仓库演进后的更新仓库会持续演进虚拟人知识需要同步更新# 1. 重新运行蒸馏工具链cddistill-toolchainmakeall# 2. 重新注入 memorypython scripts/inject_memory.py# 3. 重新绑定技能python scripts/bind_skills.py# 4. 重载虚拟人openclaw reload--personarepo-guru3.2 更新流程自动化#!/bin/bash# scripts/update_persona.sh# 一键更新虚拟人知识set-eecho 1. 重新蒸馏 cddistill-toolchainmakeallecho 2. 注入 memory python scripts/inject_memory.pyecho 3. 绑定技能 python scripts/bind_skills.pyecho 4. 重载虚拟人 openclaw reload--personarepo-guruecho 5. 验证 openclaw ask项目最近有什么变化echo更新完成3.3 维护清单维护项频率操作知识更新每次重要提交后重跑工具链 注入模式库更新新模式出现时更新 patterns/ 重绑技能决策记录更新新决策产生时新增 ADR 重注入图谱更新结构变化时重建 graph.json配置审查定期检查 persona/skills 配置四、输出落地指南4.1 落地步骤总览[部署] → [启动] → [使用] → [维护] → [迭代] 1 2 3 4 54.2 落地指南文档# 虚拟人落地指南 ## 一、部署 1. 检查配置完整性tree / yaml 校验 / memory 非空 2. 启动虚拟人openclaw start --persona repo-guru ## 二、使用场景 1. 知识问答架构/决策/历史问题 2. 代码审查模式合规审查 3. 知识检索概念/坑点/依据定位 ## 三、维护 1. 仓库演进后重跑工具链 注入 绑定 重载 2. 使用 update_persona.sh 一键更新 3. 按维护清单定期检查 ## 四、迭代 1. 收集使用反馈优化 persona 风格 2. 补充缺失知识完善 memory 3. 新增技能扩展能力边界 ## 五、常见问题 | 问题 | 解决 | |------|------| | 回答过时 | 重跑更新流程 | | 回答不准 | 检查 memory 与图谱 | | 技能不触发 | 检查 trigger 配置 |4.3 落地效果评估指标说明目标回答准确率抽查问答结果 90%新人上手时间从入职到独立开发缩短 50%知识检索命中率检索结果相关度 85%代码审查覆盖率新代码被审查比例 80%五、小结这一篇的核心收获部署启动体检 → 启动 → 配置三步完成虚拟人上线。三大场景知识问答、代码审查、知识检索覆盖虚拟人主要价值。维护更新仓库演进后一键更新工具链 → 注入 → 绑定 → 重载。落地指南部署/使用/维护/迭代四阶段 效果评估指标。下一篇是系列收官篇[14 实战案例与总结从仓库到虚拟人的完整旅程](14-Git 仓库蒸馏术从代码仓库到 OpenClaw 虚拟人-实战案例与总结.md)——用一个完整案例串起全系列并做整体总结。上一篇[12 蒸馏产物 → 虚拟人知识注入与技能绑定](12-Git 仓库蒸馏术从代码仓库到 OpenClaw 虚拟人-蒸馏产物转虚拟人.md)下一篇[14 实战案例与总结从仓库到虚拟人的完整旅程](14-Git 仓库蒸馏术从代码仓库到 OpenClaw 虚拟人-实战案例与总结.md)