知识自动沉淀引擎

Polar Sponsor
爱发电 赞助
.NET 9.0

每日知识沉淀引擎(KAPE)。自动完成:下载昨日Get笔记 → 结合对话记录 → 深度分析学习、感悟、工作状态 → 生成重点摘要日志简报 → 同步归档至Get笔记(带标签)+ 飞书知识库 + 飞书文档。触发场景:整理昨天的日志。

KAPE — 知识自动沉淀引擎 v0.1.18

功能概述

KAPE — 知识自动沉淀引擎 v0.1.18是一项面向实际任务的技能,主要用于本 skill 需要以下工具权限:;exec :调用 getnote CLI 获取笔记数据(只读操作);

核心要点

  • feishu_wiki 、 feishu_doc :写入飞书文档;
  • sessions_list 、 sessions_history :读取对话记录;
  • 不会执行任何本地文件写入之外的 shell 命令 ,所有外部 API 调用均为只读。

使用与执行

它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。

KAPE — 知识自动沉淀引擎 v0.1.18

安全说明

本 skill 需要以下工具权限:

  • exec:调用 getnote CLI 获取笔记数据(只读操作)
  • feishu_wiki、feishu_doc:写入飞书文档
  • sessions_list、sessions_history:读取对话记录

不会执行任何本地文件写入之外的 shell 命令,所有外部 API 调用均为只读请求。

重要:禁止直接调用 https://openapi.biji.com/... HTTPS API(会返回 10004 未授权),必须使用 getnote CLI。

凭证配置

Get笔记 API 凭证存储位置:

  • GETNOTE_CLIENT_ID → openclaw.json 的 skills.entries.getnote.env.GETNOTE_CLIENT_ID
  • GETNOTE_API_KEY → secrets.json 的 skills.entries.getnote.apiKey(SecretRef 解析后的实际值)

飞书 appSecret → secrets.json 的 channels.feishu.accounts.main.appSecret

⚠️ 核心约束:cron isolated session 不会自动注入环境变量 GETNOTE_CLIENT_ID 和 GETNOTE_API_KEY,所有调用 Get笔记 CLI 的 shell 命令前必须先从配置文件读取凭证(详见下方「运行时凭证读取」章节)。不读取凭证直接调用 CLI 会导致"API 未授权"错误。

飞书机器人需已加入知识库成员,否则 feishu_wiki(spaces) 返回空。

运行时凭证读取

⚠️ 所有调用 Get笔记 CLI 的步骤(第零步、第一步、第三步等),必须先执行以下凭证读取代码,再执行 CLI 命令。isolated session 无环境变量注入,绝不能省略此步骤。

GETNOTE_CLI="/Users/openclawer/.npm-global/lib/node_modules/@getnote/cli/bin/getnote"

# 从配置文件读取凭证(isolated session 不会自动注入环境变量)
GETNOTE_CFG=$(python3 -c "
import json
with open('/Users/openclawer/.openclaw/openclaw.json') as f:
    oc = json.load(f)
with open('/Users/openclawer/.openclaw/secrets.json') as f:
    sec = json.load(f)

# GETNOTE_CLIENT_ID:从 openclaw.json 直接读取
client_id = oc.get('skills',{}).get('entries',{}).get('getnote',{}).get('env',{}).get('GETNOTE_CLIENT_ID','')

# GETNOTE_API_KEY:从 secrets.json 读取(SecretRef 解析)
apikey_ref = oc.get('skills',{}).get('entries',{}).get('getnote',{}).get('apiKey',{})
if isinstance(apikey_ref, dict) and apikey_ref.get('source') == 'file':
    key_path = apikey_ref.get('id','')
    apikey = sec
    for k in key_path.split('/'):
        if k:
            apikey = apikey.get(k, {})
    api_key = apikey if isinstance(apikey, str) else apikey.get('apiKey','')
else:
    api_key = str(apikey_ref)

print(f'{client_id}n{api_key}')
")

GETNOTE_CLIENT_ID=$(echo "$GETNOTE_CFG" | sed -n '1p')
GETNOTE_API_KEY=$(echo "$GETNOTE_CFG" | sed -n '2p')

# 验证读取结果(不打印完整 key)
echo "CLIENT_ID: ${GETNOTE_CLIENT_ID:0:10}..."
echo "API_KEY: ${GETNOTE_API_KEY:0:10}..."

共享文件夹配置

飞书文档统一存放在共享文件夹「牛管家日志」,确保张公子有删除权限。

配置项 值
文件夹名称 牛管家日志
文件夹 token FQfXfYBGGllxxydJ1SgcJZWqnpf
文件夹 URL https://qcnu4qzh46f0.feishu.cn/drive/folder/FQfXfYBGGllxxydJ1SgcJZWqnpf
张公子权限 full_access(可删除文档)

核心工作流

每天自动生成日志简报,三端同步归档。每个平台每次只执行一次原子操作,不允许先创建空文档再单独写入。

第零步:Get笔记 凭证读取与授权检查

⚠️ 重要:必须先读取凭证,再检查/执行授权。isolated session 无环境变量注入,不读取凭证会导致"API 未授权"。

第一步:读取凭证 + 检查认证状态

GETNOTE_CLI="/Users/openclawer/.npm-global/lib/node_modules/@getnote/cli/bin/getnote"

# 读取凭证
GETNOTE_CFG=$(python3 -c "
import json
with open('/Users/openclawer/.openclaw/openclaw.json') as f:
    oc = json.load(f)
with open('/Users/openclawer/.openclaw/secrets.json') as f:
    sec = json.load(f)
client_id = oc.get('skills',{}).get('entries',{}).get('getnote',{}).get('env',{}).get('GETNOTE_CLIENT_ID','')
apikey_ref = oc.get('skills',{}).get('entries',{}).get('getnote',{}).get('apiKey',{})
if isinstance(apikey_ref, dict) and apikey_ref.get('source') == 'file':
    key_path = apikey_ref.get('id','')
    apikey = sec
    for k in key_path.split('/'):
        if k:
            apikey = apikey.get(k, {})
    api_key = apikey if isinstance(apikey, str) else apikey.get('apiKey','')
else:
    api_key = str(apikey_ref)
print(f'{client_id}n{api_key}')
")
GETNOTE_CLIENT_ID=$(echo "$GETNOTE_CFG" | sed -n '1p')
GETNOTE_API_KEY=$(echo "$GETNOTE_CFG" | sed -n '2p')

# 检查认证状态
${GETNOTE_CLI} auth status

第二步:根据认证状态决定操作

  • 若返回 Not authenticated:
    ${GETNOTE_CLI} auth login --api-key "${GETNOTE_API_KEY}" --client-id "${GETNOTE_CLIENT_ID}"
    
    等待 Logged in successfully. 确认后再继续。
  • 若返回 Authenticated:直接继续,不做任何操作。

第一步:确定日期范围

  • 目标日期:昨天
  • 获取方式:
    1. 使用 date 命令获取当前日期:date +%Y-%m-%d
    2. 用 date 命令计算昨天的日期:date -v-1d +%Y-%m-%d
    3. 用 date 命令验证星期:date -jf "%Y-%m-%d" "<目标日期>" +%A
  • 输出要求:在生成简报前,先输出 目标日期:YYYY-MM-DD(周X),并用 date 命令确认
  • 日期格式:YYYY-MM-DD(用于字符串前缀匹配)

第二步:获取数据(并行)

Get笔记读取

⚠️ 重要:Get笔记 API 必须通过 getnote CLI 调用,禁止直接调用 https://openapi.biji.com/...(会返回 10004 未授权)。

读取步骤:

  1. 设置 CLI 路径 + 读取凭证(必须先读取凭证,因为 isolated session 无环境变量):

    GETNOTE_CLI="/Users/openclawer/.npm-global/lib/node_modules/@getnote/cli/bin/getnote"
    
    # 读取凭证(isolated session 不会自动注入环境变量)
    GETNOTE_CFG=$(python3 -c "
    import json
    with open('/Users/openclawer/.openclaw/openclaw.json') as f:
        oc = json.load(f)
    with open('/Users/openclawer/.openclaw/secrets.json') as f:
        sec = json.load(f)
    client_id = oc.get('skills',{}).get('entries',{}).get('getnote',{}).get('env',{}).get('GETNOTE_CLIENT_ID','')
    apikey_ref = oc.get('skills',{}).get('entries',{}).get('getnote',{}).get('apiKey',{})
    if isinstance(apikey_ref, dict) and apikey_ref.get('source') == 'file':
        key_path = apikey_ref.get('id','')
        apikey = sec
        for k in key_path.split('/'):
            if k:
                apikey = apikey.get(k, {})
        api_key = apikey if isinstance(apikey, str) else apikey.get('apiKey','')
    else:
        api_key = str(apikey_ref)
    print(f'{client_id}n{api_key}')
    ")
    GETNOTE_CLIENT_ID=$(echo "$GETNOTE_CFG" | sed -n '1p')
    GETNOTE_API_KEY=$(echo "$GETNOTE_CFG" | sed -n '2p')
    
  2. 检查认证状态(如未认证则登录):

    ${GETNOTE_CLI} auth status
    
    • 若返回 Not authenticated:
      ${GETNOTE_CLI} auth login --api-key "${GETNOTE_API_KEY}" --client-id "${GETNOTE_CLIENT_ID}"
      
    • 若返回 Authenticated:直接继续
  3. 读取并过滤目标日期笔记(必须完成全部分页读取):

    # ⚠️ CLI 输出格式:ID | Title | Type | Created(日期在最后一列,行首是笔记ID)
    # ⚠️ 正确写法:grep "2026-05-28 "(尾部空格),匹配最后一列的日期
    # ❌ 错误写法:grep "^2026-05-28" —— 日期不在行首,永远匹配不到,**严禁使用**
    TARGET_DATE="2026-05-28"  # 昨日日期,格式 YYYY-MM-DD
    ${GETNOTE_CLI} notes --since-id 0 --limit 200 2>/dev/null | grep "${TARGET_DATE} "
    
  4. 分页读取(防止遗漏):当笔记数超过 200 条时,用最后一条笔记 ID 作为下次 since-id 继续读取,循环直至 has_more=false:

    # 第一页
    ${GETNOTE_CLI} notes --since-id 0 --limit 200 2>/dev/null | grep "${TARGET_DATE} "
    # 下一页:用上一步最后一条笔记 ID 替换 0
    ${GETNOTE_CLI} notes --since-id  --limit 200 2>/dev/null | grep "${TARGET_DATE} "
    # 循环继续直至 has_more=false
    
  5. 获取单条笔记详情:

    ${GETNOTE_CLI} note  --field content  # 获取正文
    ${GETNOTE_CLI} note  --field title   # 获取标题
    

对话记录获取

  1. 用 sessions_list 获取所有 session(设置足够的 activeMinutes 覆盖目标日期)
  2. 判断 session 在目标日期有活动的条件:updatedAt >= 目标日期开始时间 AND updatedAt < 今日开始时间
  3. 用 sessions_history 读取符合条件的 session 内容(includeTools=false)
  4. 解析用户消息(role: user)作为对话记录

词汇存档(若有)

  • 容错读取:用 exec + cat 读取 workspace/vocabulary/{target_date}.md,若文件不存在或读取失败则跳过,不阻断流程
  • 统计当日新增单词数量(如有)

⚠️ 路径处理规范:所有从 memory_search 或 sessions_list 等工具返回的路径,返回格式可能为 Markdown 链接(如 [2026-04-05.md](http://...)或纯路径。传给 read 工具前,必须先去除 Markdown 链接格式,只提取纯路径部分。

第三步:深度分析与整理

⚠️ 内容过滤规则(v0.1.6 新增,必须执行) 整理前需剔除【科技新闻日报】自动生成的内容:

  • 排除文件:memory/YYYY-MM-DD-tech-news.md
  • 排除文档:飞书文档标题含「科技新闻日报」或「科技新闻热榜」
  • 排除笔记:Get笔记标签或来源为「科技新闻日报」相关条目
  • 仅保留张公子个人学习、播客、录音、网页剪藏、手动笔记等主动获取内容

生成日志简报结构(见 references/briefing-template.md)

⚠️ 强制完整输出规则(v0.1.7 新增):无论输入数据多少,哪怕只有1条笔记,也必须生成完整模板的所有区块。简报不是摘要,是完整的结构化记录。

生成主题关联图(v0.1.5 新增): 根据当日笔记和对话记录,自动提取3-5个核心主题,标注主题间的关联关系。

关联类型标签:

  • → 因果关系(A导致B)
  • ⟶ 支撑关系(A证实/支持B)
  • ⇄ 竞争关系(A与B竞争)
  • ↙ 衍生关系(A衍生出B)

飞书文档中使用列表格式替代 ASCII 图形。

第四步:写入本地文件

必须先确保目录存在:

mkdir -p /Users/openclawer/.openclaw/workspace/日志管理

文件路径:/Users/openclawer/.openclaw/workspace/日志管理/{target_date}-日志简报.md

第五步:三端同步归档(一次性操作到位)

⚠️ 核心原则:每个平台每次只执行一次原子操作。不允许先创建空文档/空笔记,再单独写入内容的分步操作。如果写入失败,先删除已创建的半成品,再重新执行完整的原子操作。

CLI 路径常量(所有 lark-cli 命令必须使用完整路径):

LARK_CLI="/Users/openclawer/.npm-global/bin/lark-cli"

① Get笔记(使用 getnote save 原子操作)

GETNOTE_CLI="/Users/openclawer/.npm-global/lib/node_modules/@getnote/cli/bin/getnote"

# 读取凭证(isolated session 不会自动注入环境变量)
GETNOTE_CFG=$(python3 -c "
import json
with open('/Users/openclawer/.openclaw/openclaw.json') as f:
    oc = json.load(f)
with open('/Users/openclawer/.openclaw/secrets.json') as f:
    sec = json.load(f)
client_id = oc.get('skills',{}).get('entries',{}).get('getnote',{}).get('env',{}).get('GETNOTE_CLIENT_ID','')
apikey_ref = oc.get('skills',{}).get('entries',{}).get('getnote',{}).get('apiKey',{})
if isinstance(apikey_ref, dict) and apikey_ref.get('source') == 'file':
    key_path = apikey_ref.get('id','')
    apikey = sec
    for k in key_path.split('/'):
        if k:
            apikey = apikey.get(k, {})
    api_key = apikey if isinstance(apikey, str) else apikey.get('apiKey','')
else:
    api_key = str(apikey_ref)
print(f'{client_id}n{api_key}')
")
GETNOTE_CLIENT_ID=$(echo "$GETNOTE_CFG" | sed -n '1p')
GETNOTE_API_KEY=$(echo "$GETNOTE_CFG" | sed -n '2p')

# content 必须是完整简报正文,不允许简写
${GETNOTE_CLI} save "<完整简报正文>" 
  --title "日志简报 {target_date} | 张公子" 
  --tag AI整理 
  --tag 日志简报

⚠️ 禁止直接调用 https://openapi.biji.com/... HTTPS API,必须使用 getnote save CLI。

② 飞书知识库(先创建节点 → 再写入内容,两步都是原子的)

⚠️ 节点层级结构:

  • 个人知识库(space_id: 7621391289904516315)
  • 日志简报 节点(node_token: SERDwHBAniUqqBkx5vNctvgKn6f)
  • 每日日志简报文档(创建在此节点下)

步骤 1:创建 wiki 节点(原子操作)

cd /Users/openclawer/.openclaw/workspace/日志管理
${LARK_CLI} wiki +node-create 
  --space-id 7621391289904516315 
  --parent-node-token SERDwHBAniUqqBkx5vNctvgKn6f 
  --title "日志简报 {target_date} | 张公子"
  • 从返回的 obj_token 提取新文档的 doc token
  • 从返回的 node_token 提取新 wiki 节点 token

步骤 2:写入简报内容(原子操作)

${LARK_CLI} docs +update 
  --api-version v2 
  --doc "" 
  --command overwrite 
  --doc-format xml 
  --content @./2026-05-25-日志简报.md

⚠️ --doc-format xml 必须明确指定(默认 xml)。 ⚠️ 重要:飞书文档 不支持 Markdown 表格(写入时表格内容会丢失)。如简报包含表格,必须使用 --doc-format xml 并提供 XML 格式内容,XML 表格结构为

...
...
。

步骤 3:记录知识库 URL

③ 飞书文档(创建+写入一次完成,再授权)

步骤 1:获取 tenant_access_token

python3 -c "
import json, urllib.request
with open('/Users/openclawer/.openclaw/openclaw.json') as f:
    d = json.load(f)
# appSecret 从 secrets.json 读取
with open('/Users/openclawer/.openclaw/secrets.json') as f:
    sec = json.load(f)
app_secret = sec.get('channels',{}).get('feishu',{}).get('accounts',{}).get('main',{}).get('appSecret','')
req = urllib.request.Request(
    'https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal',
    data=json.dumps({'app_id':'cli_a94b4a1e43781cc7','app_secret':app_secret}).encode(),
    headers={'Content-Type':'application/json'}
)
resp = urllib.request.urlopen(req, timeout=10)
print(resp.read().decode())
"

步骤 2:创建文档并写入内容(原子操作)

cd /Users/openclawer/.openclaw/workspace/日志管理
${LARK_CLI} docs +create 
  --api-version v2 
  --parent-token FQfXfYBGGllxxydJ1SgcJZWqnpf 
  --doc-format xml 
  --content @./2026-05-25-日志简报.md

⚠️ 禁止先创建空文档再单独写入。必须在 --content 中直接提供完整内容。 ⚠️ 重要:飞书文档 不支持 Markdown 表格,如简报包含表格,必须改用 --doc-format xml 并提供 XML 格式内容。

步骤 3:提取 document_id(从返回的 document.document_id)

步骤 4:授予张公子 full_access 权限

curl -X POST 'https://open.feishu.cn/open-apis/drive/v1/permissions//members?type=docx' 
  -H 'Authorization: Bearer {tenant_access_token}' 
  -H 'Content-Type: application/json' 
  -d '{"member_type":"openid","member_id":"ou_d8ace8a146610ca26bc07d8e68a5620f","perm":"full_access"}'

步骤 5:记录文档 URL

第六步:用户反馈

向用户发送完成通知,包含:

  • Get笔记数量(分类统计:录音/播客/纯文本等)
  • 参考对话记录数量
  • 简报核心发现摘要(1-3句话)
  • 各端存储结果链接

错误处理原则

  1. 任何一步失败不影响其他步骤:三端归档是独立的,写入本地文件是最基本的保障
  2. 明确告知用户失败原因:如果某个平台失败,需要在反馈中说明
  3. 不要静默失败:如果关键步骤(如获取数据)失败,必须通知用户
  4. 写入前先查重:写入前先检查目标日期是否已有同名笔记/文档,若有则先删除再创建

相关专题

更多
Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

2026.11.12

0

15

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.12

0

15

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

2026.11.12

0

15

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

2026.11.06

0

12

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

2026.11.06

0

13

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

2026.11.06

0

10

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

2026.11.05

0

12

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

2026.11.05

0

12

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

2026.11.04

0

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.3万人学习