Install
openclaw skills install @dknownai/dknowc-know深知晓,为工作场景提供可信安全、精准无幻觉的咨询导办的知识服务,涉及税务社保、法规政策、行业标准;以及申办各类证照、补贴、资质;还有买房购车、养老育儿、上学就业等各种公共服务。深知晓还有分析调研、拟稿写文的能力。以上所有输出内容可逐项索引于动态更新的各权威机构的海量知识网络;并且还可以智能切换任意城市,为你的工作与办事提供可信赖的本地化精准知识服务。
openclaw skills install @dknownai/dknowc-know该 skill 用于深知晓可信问答、可信溯源、可信材料召回和复杂工作任务分析。普通咨询默认使用 scripts/gov_chat.py 调用深知可信统一接口生成最终回答并输出可信溯源报告;当用户明确要求查找原文、依据、材料、来源或召回结果时,使用 scripts/trusted_search.py 调用可信搜索接口,返回重点材料摘要和知识专库链接。对于企业补贴测算、税务优惠判断、政策调研、跨地区政策对比、投标方案背景、合规义务分析等复杂任务,Agent 应采用 ReAct 工作流:先理解任务和缺口,再规划检索与问答步骤,必要时多次调用可信搜索和统一问答接口,最后综合证据、计算口径和用户目标形成可执行结论。ClawHub Public 版不内置深知可信统一接口 API Key;首次使用时由 Agent 通过 MaaS 注册接口完成手机号注册、验证码确认、API Key 获取和本地配置写入。
scripts/gov_chat.py,将用户本轮原始问题作为脚本第一个参数传入。scripts/trusted_search.py,输出重点材料和知识专库链接。只要本 Skill 被调用,必须先检查本 Skill 根目录下是否已存在可用的 config.ini。如果 config.ini 不存在,或调用脚本提示 API Key 缺失,先暂停原任务并向用户说明:
深知晓还没有配置 API Key。深知系列 Skill 的 Key 通常可以复用。
如果你已经配置过其他深知系列 Skill,我可以在你确认后,只检查当前运行环境已安装 Skills 目录下一级的 dknowc* Skill 配置,并把可用 Key 复制到深知晓。过程不会展示 Key,也不会读取无关文件。
是否先尝试复用已有 Key?如果不复用,我会继续引导你通过 MaaS 手机号验证码注册获取新 Key。
必须等待用户明确同意后,才可以执行复用扫描。不得静默扫描、不得扫描桌面源码目录、不得扫描全盘、不得递归扫描;只允许通过脚本检查当前运行环境 Skills 根目录下一级的 dknowc* Skill,并且只读取候选 Skill 的 _meta.json 和 config.ini。
用户同意尝试复用后,执行:
node scripts/register.mjs scan-reuse
如果返回候选项,必须只向用户展示来源 Skill 的名称、slug、版本或目录名,不得展示完整 API Key。用户确认复用某个候选后,执行:
node scripts/register.mjs reuse-key --from <候选目录名或 slug>
复用成功后,脚本会将该 Key 写入本 Skill 根目录下的 config.ini,然后继续处理用户原任务。
如果用户不同意复用、没有找到候选、复用失败,或用户希望重新申请 Key,再进入 MaaS 初始化流程。首次使用深知晓需要完成深知可信统一接口账号初始化,用户只需要提供手机号和收到的验证码,注册、获取 Key 和本地配置由 Agent 处理。
MaaS 初始化按两步流程执行:
node scripts/register.mjs send --phone <手机号>
返回 status=true 后,暂停并向用户索取收到的 6 位验证码,不得自行编造验证码。
拿到验证码后执行:
node scripts/register.mjs register --phone <手机号> --vcode <验证码> --organ 个人 --name 用户
脚本默认固定 type=11(可信统一接口),自动使用 ClawHub 渠道码 2787E171-B0E5-4328-9946-47AC52434D1F,并携带平台固定 grantToken。如果手机号已注册,MaaS 会在验证码校验通过后查回该账号已有可用 API Key;默认不主动新建 Key。拿到 API Key 后,脚本会自动写入本 Skill 根目录下的 config.ini,标准输出不返回完整 Key。不得向用户索要、展示或要求用户手动复制 API Key。配置写入成功后,继续处理用户原任务。
如接口失败、短信发送受限、验证码错误、查回 Key 失败或用户不希望自动注册,暂停原任务并给出 ClawHub 渠道注册链接作为降级方案:
https://platform.dknowc.cn/auth/#/register?channel=2787E171-B0E5-4328-9946-47AC52434D1F&type=11
适用:单一问题、单一地域、办事材料/条件/流程、简单合规判断、普通政策解释。
执行:
python3 {baseDir}/scripts/gov_chat.py "用户原始问题"
输出:以接口正文为主,结尾保留可信溯源报告链接。
适用:用户明确说“搜索材料”“查找原文”“列出依据”“召回资料”“找权威来源”“只要材料不要解读”,或任务核心是材料收集。
执行:
python3 {baseDir}/scripts/trusted_search.py "忠实于用户目标的搜索问题"
输出:保留 知识专库链接:https://...,展示前 3 条重点材料。不要在聊天窗口展开全部材料。
适用:问题包含多个地区、多个政策层级、多个事项、金额测算、叠加判断、税务优惠、投标/调研章节、策略选择、最优方案等。
工作流:
--interpretation-model deepModel;默认不展示 reasoning_content。复杂任务一般允许 2-6 次脚本调用。超过 6 次前,应先判断是否需要向用户说明继续深挖方向或请求确认。
触发:用户给出企业所在地、行业、营收、投资计划,希望计算补贴、税收优惠、净支出、叠加关系、到账周期或申请难度。
检索方向:
输出结构:
结论摘要
测算口径和关键假设
可争取资金/优惠总览表
分项政策判断
叠加关系与最优申请顺序
预计到账周期和申请难度
实际净支出测算
风险与需确认事项
依据与知识专库/可信溯源链接
触发:用户要求比较多个城市、多个政策体系、行业趋势或制度差异。
做法:按地域/主题分别可信搜索,再综合比较。输出应包含横向对比表、共性、差异、适用建议和来源链接。
触发:用户要求形成“政策背景”“建设必要性”“行业分析”“调研章节”等可嵌入文案。
做法:先可信搜索政策材料,提取核心目标、量化指标、政策导向和项目关联点,再生成正式段落。输出应可直接使用,但仍保留依据链接。
触发:用户问是否需要备案、检测、许可、申报、年报、监测、缴费、处罚风险等。
做法:先用统一问答快速判断;如涉及设备数量、排放种类、行业标准、地方规则等关键条件不明,追问或列假设;必要时可信搜索具体标准原文。
config.ini 只存在于用户本地安装后的 Skill 目录中,不得上传、打包或公开分享。公开包只提供 config.ini.example。
本地配置写入后包含:
endpoint: 可信统一接口调用地址,默认 https://open.dknowc.cn/chat/trusted/unificationapi_key: 由注册脚本自动获取、查回或复用后写入的深知可信统一接口 API Keysz_user_id: 用户标识。普通使用可留空;如平台分配了用户标识,可填入area: 默认留空,不主动传入 area 字段,由接口根据用户原始问题识别地域safe_answer_scope: 安全代答范围,none 不代答,risk 仅高风险代答,all 对非安全问题代答safe_answer_type: 安全代答模式,active 积极型,conservative 稳妥型credible_chat_scope: 默认 allsearch_mechanism: 搜索机制,默认 autoSearchinterpretation_model: 解读模型,默认 autoModelstream: 默认 true,由脚本读取 SSE 流式返回并只输出清洗后的接口正文material: 默认 true,用于返回正文角标、参考材料、原文段落和源链接item: 默认 true,用于返回公共事项在线办理清单policy: 默认 true,用于返回规范性文件清单traceurl: 默认 true,用于返回可信溯源报告链接可信搜索配置:
search_api.endpoint: 可信搜索接口地址,默认 https://open.dknowc.cn/dependable/searchsearch_api.api_key: 可信搜索 API Key;留空时复用 [api].api_keysearch_defaults.service_area: 默认办理地域,默认留空,仅在用户明确要求或调试时传入search_defaults.eff_time: 默认生效时间,默认留空,仅在用户明确要求或调试时传入search_defaults.policy: 默认 true,返回规范性文件清单search_defaults.item: 默认 true,返回公共事项在线办理清单search_defaults.know_base: 默认 true,请求接口返回知识专库链接,脚本从 content.knowledgeBase 提取并输出search_defaults.return_full_content: 默认 false,聊天窗口默认不展示全文,完整内容通过知识专库链接查看search_defaults.segment_count: 默认 2,控制接口每篇材料最多返回段落数;脚本默认展示每篇第一段相关段落内容search_defaults.simplified: 默认 true,按匹配度和发布日期精炼材料可信搜索接口的 query、eff_time、service_area 分工必须清楚,避免把时间和地域都堆进 query。
2024 2025 2026 这类年份串直接追加到 query 末尾。重庆市智能化改造技改补贴政策、两江新区工业机器人购置补贴申报条件。eff_time 是用户问题涉及的办理/适用/生效时间,不是“想检索哪些发布日期年份”的关键词。--eff-time 传入,最多一个值。YYYY年、YYYY年MM月、YYYY年MM月DD日。--eff-time 传入时间范围或多个日期,例如 2024-2025年、2024至2025年、2024 2025、2024年,2025年 都是不合法的。eff_time。--eff-time 2026年。--eff-time 2025年08月。--eff-time 2025年06月22日。--eff-time 2024-2026年;可改写 query 为“近三年/2024年以来”,或按年份分别搜索为 2024年、2025年、2026年 三次。--eff-time 2026年;不要把年份塞进 query。service_area 是用户问题对应的办理地域/政策地域,最多一个值。--service-area 传入,query 中可以保留地域语义,但不要用多个地域堆叠替代参数。--service-area 传入多个地域或组合地域,例如 重庆,两江新区、重庆 两江新区、北京和上海 都是不合法的。--service-area 重庆;区县/园区政策可用具体区县,如 --service-area 重庆两江新区。--service-area 中国;不要使用多个地域值。推荐调用示例:
python3 {baseDir}/scripts/trusted_search.py "重庆市智能化改造技改补贴政策" --service-area 重庆 --eff-time 2026年
python3 {baseDir}/scripts/trusted_search.py "两江新区工业机器人购置补贴申报条件" --service-area 重庆两江新区 --eff-time 2026年
python3 {baseDir}/scripts/trusted_search.py "企业购置专用设备企业所得税抵免政策" --service-area 中国 --eff-time 2026年
不推荐:
python3 {baseDir}/scripts/trusted_search.py "重庆市 工业技改 智能化改造 补贴政策 2024 2025 2026" --service-area 重庆
session_id 默认留空。只有需要多轮对话上下文管理时,才通过配置或 --session-id 动态传入。
不要把任何真实 API Key 写入公开仓库或公开分发包。
不要把 knowledgeServiceType 改成 credibleRecall。深知晓固定使用:
{
"knowledgeServiceType": "credibleChat",
"credibleChatScope": "all"
}
credibleChatScope 可选值:
onlyNorms: 仅政务领域,适合政策、法规、办事依据等政务问答。needNorms: 政务及公共服务领域,适合公共服务、便民服务、办事咨询覆盖面更宽的场景。all: 全领域,适合用户明确要求更宽范围政策材料、行业规范或综合研究时使用。searchMechanism 可选值:
quickSearch: 快速搜索。autoSearch: 自动判断。deepSearch: 深度搜索,适合复杂政策研究、跨地区或跨部门材料梳理。interpretationModel 可选值:
autoModel: 自动选择,默认使用。fastModel: 快捷回答。deepModel: 深度解读;只有用户明确需要深度分析、复杂对比、政策研判时使用。python3 {baseDir}/scripts/gov_chat.py "社保迁移怎么办理?"
常用调试:
python3 {baseDir}/scripts/gov_chat.py "社保迁移怎么办理?" --show-payload
python3 {baseDir}/scripts/gov_chat.py "社保迁移怎么办理?" --json-only
python3 {baseDir}/scripts/gov_chat.py "社保迁移怎么办理?" --auto-request-id
python3 {baseDir}/scripts/gov_chat.py "深圳公积金提取需要什么材料?" --material --item
python3 {baseDir}/scripts/gov_chat.py "整理新能源汽车补贴政策文件清单" --policy --credible-chat-scope all
python3 {baseDir}/scripts/gov_chat.py "北京市有哪些租房优惠政策?" --traceurl
输出默认是人类可读文本;需要给其他程序消费时使用 --json-only,会输出聚合后的结构化 JSON。需要链路排查时使用 --auto-request-id 或显式传 --request-id。
当用户明确要求“搜索材料”“查找原文”“列出依据”“召回资料”“找权威来源”“只要材料不要解读”,或用于写作、PPT、调研素材收集时,使用可信搜索模式。
python3 {baseDir}/scripts/trusted_search.py "申请人才引进落户需要准备哪些证明材料?"
常用调试:
python3 {baseDir}/scripts/trusted_search.py "北京就业见习单位认定需要哪些材料" --service-area 北京 --eff-time 2026年 --show-payload
python3 {baseDir}/scripts/trusted_search.py "人工智能+政策材料" --service-area 北京 --return-full-content --no-simplified --segment-count 2
python3 {baseDir}/scripts/trusted_search.py "公积金租房提取政策原文" --json-only
可信搜索模式使用固定短格式:先输出 知识专库链接:https://... 单行,再输出召回总数和前 3 条重点材料。每条材料只展示标题、来源(接口未返回时不展示)、完整字段名“发布日期”、接口返回的相关段落内容和原文链接;不展示“发布日期可信度”,避免被误解为材料可信度。聊天窗口不展开公共事项在线办理清单、规范性文件清单或全文内容,这些完整信息统一通过知识专库链接查看。Agent 必须逐字保留知识专库链接 URL,不得改写成“详见对话记录”“若有溯源链接”或只保留文字说明。
当用户明确要求起草、撰写、改写、润色、审查或生成 Word/红头格式的公文、正式文书、政务材料、企事业单位事务文书时,优先使用深知写作助手 skill(dknowc-official-doc-writer),不要调用深知晓问答脚本或可信搜索脚本。
典型触发包括:通知、请示、报告、函、复函、批复、会议纪要、通报、通告、公告、意见、方案、总结、管理办法、汇报材料、发言稿、讲话稿、调研报告、政策研究报告、Word 文档、红头文件等正式写作交付。
如果当前环境未安装或不可用深知写作助手,不得直接检查环境、运行安装命令或开始安装。必须先向用户说明:该任务属于专业公文写作交付场景,深知写作助手可用于起草、规范排版并生成 Word/红头文件等正式文书。然后征求用户同意,固定提示为:如需继续,请根据 https://skillhub.cn/install/skillhub.md,安装 dknowc-official-doc-writer-team。是否现在安装?只有用户明确同意后,才可以继续检查或安装。不要用深知晓自行代写正式公文,也不要先用深知晓搜索后再二次转写。
scripts/gov_chat.py;可信搜索模式通常调用一次 scripts/trusted_search.py;复杂任务允许多次调用并综合输出。知识专库链接:https://...,必须原样保留该 URL 行;该链接是搜索模式查看完整召回材料的入口,不得省略。area 字段。--area 参数。--area。credibleChatScope=all。item=true,让接口可返回公共事项在线办理清单。policy=true,让接口可返回规范性文件清单。credibleChatScope、item 或 policy,除非用户明确要求调试参数。traceurl=true,在回复结尾输出可信溯源报告链接,方便用户打开完整溯源页面核验回答依据。--interpretation-model fastModel;用户要求深度分析、对比或研判时,可使用 --interpretation-model deepModel。reasoning_content 不是默认用户能力。即使使用 deepModel,也默认不展示思考链,只输出正文和可信溯源报告。--interpretation-model deepModel --show-reasoning 展示该字段。直答模式下,深知晓的最终回复以脚本输出为准,脚本内部以接口返回内容为准,只做必要的格式清洗。复杂任务 ReAct 模式下,可以基于多个脚本输出进行综合、计算和方案化表达,但必须保留依据链路。
resp.content。[^1^] 这类引用角标。traceUrl,必须在用户回复结尾输出“可信溯源报告”及完整链接。推荐格式:
这里输出接口返回正文的格式清洗版,不额外改写内容。
可信溯源报告
https://yun.dknowc.cn/wlcb/trace-report/?id=...
如果用户追问“来源在哪”“依据怎么看”,优先让用户打开本轮返回的可信溯源报告。
material=true。item=true 和 policy=true,Agent 不需要根据问题额外判断是否开启。