Query Kb

Answer questions from personal and team knowledge bases with strict source grounding, no-answer behavior when the knowledge base lacks evidence, answer validation, and query logging.

Skill: query_kb - 来源约束知识库查询

用途

基于个人知识库、团队知识库、项目空间或跨库范围回答问题。所有回答必须依赖知识库来源；知识库没有答案时直接说明没有答案，不补通用知识。

触发条件

Activate when:

• 用户问“我之前/我们团队/某项目/某人/知识库里有没有……”
• 用户要求查询会议、实验、论文、项目进展、人物贡献
• 用户追问依赖已存知识库内容

Do NOT activate when:

• 用户要存资料，交给 ingest_document
• 用户要批量编译资料源，交给 batch_compile
• 用户要写综述/研究缺口/实验建议，交给 kb_review

执行流程

1. 解析查询范围

OpenClaw 字段映射：

• SenderId：发消息的人 open_id
• ChatType：direct 或 group
• GroupSubject：群聊 chat_id；私聊为空

bash

python3 scripts/resolve_scope.py \
  --sender_id <SenderId> \
  --chat_type <ChatType> \
  --chat_id <GroupSubject> \
  --question "<用户问题>"

范围规则：

• 私聊：SenderId -> users.json -> 个人库 / 用户所属团队
• 群聊：GroupSubject -> chat_bindings.json -> team_id -> 团队库
• 群聊未绑定团队：不回答知识问题，提示管理员绑定本群
• 群聊默认只查团队知识库，不查个人知识库
• 群聊中问“我/我的/个人资料”：拒绝并提示私聊查询
• 私聊中“我/我的/我之前” -> 个人库
• 私聊中“我们/团队/组会/成员/项目” -> 团队库
• 私聊范围不明确 -> 同时查个人库和团队库目录
• 项目问题优先读项目聚合页
• 人物问题优先读 people/<姓名>.md

2. 读取目录

bash

python3 scripts/kb_list.py --owner <owner> --repo <repo> --kind all

3. OpenClaw 判断相关页

优先级：

• 项目问题：projects/<project>/index/timeline/decisions/open_questions/people
• 人物问题：people/<姓名>.md
• 概念问题：concepts/
• 资源问题：resources/
• 资料问题：summaries/

4. 精读页面

bash

python3 scripts/kb_read.py --owner <owner> --repo <repo> --path "<page path>"

5. 生成回答

回答只能基于精读内容。

必须包含：

text

来源：
1. 《页面名》（个人知识库/团队知识库/项目）链接

没有命中：

text

我在知识库中没有找到与「xxx」相关的资料，因此无法基于知识库回答。

来源：无

资料不足：

text

我找到了相关资料，但其中没有足够信息回答该问题，因此目前不能得出结论。

来源：
1. 《页面名》链接

6. 回答前校验

发送给用户前必须调用：

bash

python3 scripts/validate_answer.py --answer_file /tmp/paperkb/answer.md \
  --allowed_sources_file /tmp/paperkb/read_pages.json

校验规则：

• 缺少 来源： 直接失败。
• 非“没有答案”场景下，来源不能为空。
• “没有答案”场景也必须显式写 来源：无。
• “没有答案”场景不能列出知识库页面作为来源；如果读到相关页面但信息不足，应使用“资料不足”话术并列出实际来源。
• 如果传入 allowed_sources 或 allowed_sources_file，回答中的来源必须来自本次实际读取的页面。

7. 写查询日志

查了哪个库就写哪个库；跨库两个都写：

bash

python3 scripts/log_query.py --owner <owner> --repo <repo> \
  --open_id <SenderId> --question "<用户问题>" --scope "<scope>" --hits "<命中页面>"

脚本清单

• resolve_scope.py：判断个人库/团队库/跨库范围
• chat_context.py：解析 OpenClaw 群聊上下文和群绑定
• kb_list.py：读取目录
• kb_read.py：读取具体页面
• validate_answer.py：机械校验回答是否满足来源约束
• log_query.py：记录查询日志