clawbot知识库更新后需手动刷新向量嵌入。一、执行clawdbot embed --force强制重嵌入并重启服务；二、配置watcher启用自动增量嵌入；三、异常时清空缓存并运行clawdbot init --rebuild-embeddings重建索引。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
ClawBot的知识库更新后不会自动重新训练模型，而是依赖于知识库索引的重建与向量嵌入的刷新机制。以下是针对该问题的多种处理方式：
一、触发向量数据库重嵌入（推荐操作）
ClawBot使用向量数据库（如Chroma、Qdrant或本地SQLite+Embedding）存储知识片段的语义表示。知识库文件更新后，原有向量未同步变更，将导致检索结果滞后或缺失。需主动执行嵌入刷新流程。
1、进入ClawBot项目根目录，确认已激活虚拟环境或正确加载OpenClaw运行时。
2、执行命令：clawdbot embed --force，该参数强制对全部文档重新切片并生成新向量。
3、观察终端输出中是否出现Embedding completed for X documents及Index rebuilt successfully提示。
4、重启ClawBot服务或执行clawdbot reload使新索引生效。
二、启用自动监听与增量嵌入（需配置支持）
部分部署模式（如MacOS/Linux本地+Watchdog插件、阿里云部署启用FileWatcher）支持文件系统事件监听。当知识库目录内发生新增、修改、删除操作时，可自动触发增量嵌入，避免全量重建开销。
1、检查配置文件config.yaml中watcher.enabled是否设为true。
2、确认watcher.paths包含知识库实际路径，例如./data/kb/。
3、确保embed.batch_size不为0且embed.incremental为true。
4、启动服务时添加--watch标志：clawdbot serve --watch。
三、手动清空缓存并重建索引（故障恢复场景）
当嵌入过程异常中断、向量维度错配或模型版本升级后，旧索引可能无法兼容新embedding模型，必须清除历史缓存并强制重建。
1、定位向量数据库存储路径，通常为./storage/chroma/或./.clawdbot/embeddings/。
2、执行：rm -rf ./storage/chroma/*（Linux/macOS）或在Windows中删除对应文件夹全部内容。
3、运行clawdbot init --rebuild-embeddings，该命令会重新初始化数据库结构并执行全量嵌入。
4、验证日志中是否出现Vector dimension: 384（或当前模型对应维数）且无Dimension mismatch报错。
