Install
openclaw skills install @thcjp/knowledge-agent-tool-proopenclaw skills install @thcjp/knowledge-agent-tool-pro功能说明: 本技能涵盖 中文交互、化工作流场景 等核心能力。
本工具是企业级知识管理工具,在免费版核心能力之上,扩展了团队共享知识库、语义检索、自动摘要生成、知识图谱构建、权限管理与监控统计能力,适合企业团队知识库建设、研究机构资料管理、多人协作的知识沉淀场景。专业版与免费版完全兼容:免费版的所有命令、数据格式、工作流均可直接在专业版中使用.
| 能力 | 免费版 | 专业版 |
|---|---|---|
| 多类型知识捕获 | 支持 | 支持 |
| 标签与全文检索 | 支持 | 支持 |
| 自动索引与整理 | 支持 | 支持 |
| Markdown 文件存储 | 支持 | 支持 |
| 团队共享知识库 | 不支持 | 支持 |
| 语义检索 | 不支持 | 支持 |
| 自动摘要生成 | 不支持 | 支持 |
| 知识图谱 | 不支持 | 支持 |
| 权限管理 | 不支持 | 支持 |
| 操作审计 | 不支持 | 支持 |
| 监控统计 | 不支持 | 支持 |
| 优先技术支持 | 不支持 | 支持 |
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | 知识管理工具-专业版处理的输入数据或指令 |
| options | object | 否 | 附加配置选项,如模式选择、格式偏好等 |
| callback_url | string | 否 | 异步处理完成后的回调通知URL |
# 初始化团队共享知识库
know pro init --shared /shared/knowledge-base --team "research-team"
# ...
# 同步本地知识到共享库
know pro sync --push
# ...
# 拉取团队最新知识
know pro sync --pull
# ...
# 查看团队成员
know pro team list
# ...
# 查看某成员的贡献
know pro team stats --member alice
处理: 解析团队共享知识库(专业版新增)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回团队共享知识库(专业版新增)的响应数据,包含状态码、结果和日志.
input_params参数,支持创建/查询/导出操作# 语义搜索(基于含义而非关键词)
know pro search-semantic "如何提升团队协作效率"
# ...
# 智能推荐相关内容
know pro recommend --based-on "2026-ai-agent-guide.md"
# ...
# 跨语言检索
know pro search-semantic "machine learning" --lang auto
处理: 解析语义检索(专业版新增)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回语义检索(专业版新增)的响应数据,包含状态码、结果和日志.
input_params参数,支持创建/查询/导出操作# 为条目自动生成摘要
know pro summarize --id 2026-02-26-ai-agent-guide
# ...
# 批量生成摘要
know pro summarize --batch --tag ai
# ...
# 提取关键词
know pro keywords --id 2026-02-26-ai-agent-guide --top 10
处理: 解析自动摘要与关键词提取(专业版新增)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回自动摘要与关键词提取(专业版新增)的响应数据,包含状态码、结果和日志.
input_params参数,支持创建/查询/导出操作# 构建知识图谱
know pro graph build
# ...
# 查看关联关系
know pro graph relations --id 2026-02-26-ai-agent-guide
# ...
# 可视化导出
know pro graph export --format json > knowledge-graph.json
know pro graph export --format dot > knowledge-graph.dot
处理: 解析知识图谱构建(专业版新增)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回知识图谱构建(专业版新增)的响应数据,包含状态码、结果和日志.
input_params参数,支持创建/查询/导出操作# 设置条目权限
know pro permission set --id 2026-02-26-ai-agent-guide --team research --read --write
# ...
# 查看权限
know pro permission list --id 2026-02-26-ai-agent-guide
# ...
# 按团队设置默认权限
know pro permission default --team research --read
处理: 解析权限管理(专业版新增)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回权限管理(专业版新增)的响应数据,包含状态码、结果和日志.
input_params参数,支持创建/查询/导出操作# 查看操作日志
know pro audit log --limit 50
# ...
# 知识库统计
know pro stats
# 示例
# 总条目数: 1256
# 本月新增: 89
# 热门标签: ai(234), python(156), research(98)
# 活跃成员: alice(45), bob(32), charlie(28)
# ...
# 导出统计报告
know pro stats --export report.json
处理: 解析操作审计与监控统计(专业版新增)的输入参数,完成核心逻辑,返回结构化响应. 输出: 返回操作审计与监控统计(专业版新增)的响应数据,包含状态码、结果和日志. 能力覆盖范围:本skill的核心能力覆盖以下场景关键词:企业级知识管理、支持团队共享、知识图谱与权限管、企业级知识管理工、在免费版核心能力、自动摘要生成、权限管理与监控统、计能力、核心能力、免费版全部能力、完全兼容、团队共享知识库与、语义检索与智能推、知识图谱与关联发、权限管理与操作审等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持.
input_params参数,支持创建/查询/导出操作研究团队共同维护一个知识库,成员各自贡献并共享.
#!/bin/sh
# team-research-kb.sh - 团队研究知识库初始化
SHARED_KB="/shared/research-kb"
TEAM="ai-research"
# ...
# 初始化共享知识库
know pro init --shared "$SHARED_KB" --team "$TEAM"
# ...
# 设置默认权限:研究团队成员可读写
know pro permission default --team "$TEAM" --read --write
# ...
# 邀请成员
know pro team invite --member alice --role editor
know pro team invite --member bob --role editor
know pro team invite --member charlie --role viewer
# ...
# 同步本地知识到共享库
know pro sync --push --tag research,ai
# ...
echo "团队知识库初始化完成"
know pro team list
对大量历史知识条目批量生成摘要,构建知识图谱发现关联.
#!/bin/sh
# auto-summarize-and-graph.sh - 自动摘要与图谱构建
# ...
# 1. 批量生成摘要(对未摘要的条目)
know pro summarize --batch --all --force false
echo "摘要生成完成"
# ...
# 2. 批量提取关键词
know pro keywords --batch --all --top 5
echo "关键词提取完成"
# ...
# 3. 构建知识图谱
know pro graph build
echo "知识图谱构建完成"
# ...
# 4. 导出图谱供可视化
know pro graph export --format json > /shared/knowledge-graph.json
know pro graph export --format dot > /shared/knowledge-graph.dot
# ...
# 5. 查看关联最多的条目
know pro graph hub-nodes --top 10
echo "关联分析完成"
研究员通过语义查询快速找到相关知识,即使不记得精确关键词.
#!/bin/sh
# semantic-search-workflow.sh - 语义检索工作流
# ...
# 1. 语义搜索(基于含义)
echo "=== 语义搜索 ==="
know pro search-semantic "提升模型训练效率的方法"
# ...
# 2. 基于某条目推荐相关内容
echo "=== 智能推荐 ==="
know pro recommend --based-on "2026-02-26-training-optimization.md" --top 5
# ...
# 3. 跨语言检索
echo "=== 跨语言检索 ==="
know pro search-semantic "transformer architecture" --lang auto
# ...
# 4. 按概念聚类
echo "=== 概念聚类 ==="
know pro cluster --tag ai --algorithm semantic
# ...
# 5. 发现知识盲区
echo "=== 知识盲区分析 ==="
know pro gaps --topic "强化学习"
以下场景知识管理工具-专业版不适合处理:
需要数据分析、报表生成、统计洞察、数据可视化时使用。不适用于非本工具能力范围的需求.
# 专业版初始化(保留免费版数据)
know pro init --migrate
# ...
# 配置团队共享
know pro config set shared.path /shared/knowledge-base
know pro config set team.name research-team
know pro config set semantic.enabled true
know pro config set graph.enabled true
# 成员A:添加新知识
know add url https://example.com/paper --title "新论文" --tags "ai,paper"
know pro sync --push
# ...
# 成员B:拉取最新知识
know pro sync --pull
know pro search-semantic "最新论文"
# ...
# 成员C:补充摘要与关键词
know pro summarize --id latest-paper
know pro keywords --id latest-paper
# 构建并导出图谱
know pro graph build
know pro graph export --format dot > knowledge.dot
# ...
# 用 Graphviz 可视化
dot -Tsvg knowledge.dot -o knowledge.svg
# $HOME/.config/know/config.yaml
edition: pro
storage:
local: $HOME/.knowledge-base
shared: /shared/knowledge-base
sync_mode: bidirectional
team:
name: research-team
default_role: editor
semantic:
enabled: true
model: text-embedding-3-small
index_path: $HOME/.knowledge-base/.semantic-index
graph:
enabled: true
build_interval: 3600
export_format: json
permissions:
default: team-read
admin_override: true
audit:
enabled: true
log_path: /var/log/know-audit.log
retention_days: 90
alerts:
on_conflict: true
on_large_change: true
# 知识库整体统计
know pro stats
# ...
# 输出示例:
# === 知识库统计 ===
# 总条目数: 1256
# 本月新增: 89
# 本月搜索: 342
# 热门标签: ai(234), python(156), research(98)
# 活跃成员: alice(45), bob(32), charlie(28)
# 知识图谱节点: 1256, 边: 3421
# 语义索引覆盖率: 92%
# ...
# 导出统计报告
know pro stats --export json > stats.json
know pro stats --export markdown > stats.md
know pro sync --pull / --push,保持知识库一致.know add,不要拖延.know pro summarize 自动生成摘要.know pro graph build 更新知识图谱,发现关联.know pro gaps 发现知识盲区,有针对性地补充.完全兼容。免费版的所有知识条目、标签、索引均可直接在专业版中使用。专业版在原有数据之上扩展语义索引、图谱等元数据.
know pro init --migrate
升级过程保留全部历史知识条目,自动构建语义索引与知识图谱.
专业版采用"最后修改优先"策略,冲突时保留最新版本,历史版本存入 .versions/ 目录。可手动合并:
know pro conflict resolve --id <entry-id> --strategy merge
know pro reindex-semantic 重建语义索引know pro summarize / know pro keywords)# 导出为 DOT 格式
know pro graph export --format dot > graph.dot
# 用 Graphviz 渲染
dot -Tsvg graph.dot -o graph.svg
# 或导出 JSON 供 D3.js / ECharts 可视化
know pro graph export --format json > graph.json
按团队/角色设置权限:
--read:可查看--write:可编辑--admin:可管理权限
核心资料设为团队只读,个人笔记设为可写.| 维度 | 兼容性 |
|---|---|
| 命令语法 | 100% 兼容(免费版命令在专业版中可用) |
| 数据格式 | 100% 兼容(专业版可读取免费版数据) |
| 知识条目 | 100% 兼容(无需迁移即可使用) |
| 标签与索引 | 100% 兼容(专业版额外扩展语义索引) |
| 升级路径 | 平滑升级(保留全部历史数据) |
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| know(pro) | CLI 脚本 | 必需 | 随 Skill 安装 |
| grep | 系统工具 | 必需 | 系统自带 |
| 嵌入模型 | AI 模型 | 语义检索必需 | 本地或 API 服务 |
| Graphviz | 可视化工具 | 可选 | 系统包管理器(知识图谱可视化) |
| Git | 版本控制 | 推荐 | 系统包管理器(团队协作) |
| LLM API | API | 必需 | 由Agent内置LLM提供 |
| 监控系统 | 可观测性 | 可选 | Prometheus / Grafana |
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,参考国内替代方案 |
输出:返回执行结果,包含操作状态和输出数据
用户: 执行核心功能
Skill: 正在执行核心功能...
Skill: 执行完成,结果如下: 操作成功
| 风险类型 | 防范措施 |
|---|---|
| API密钥泄露 | 通过环境变量配置,禁止硬编码到代码或配置文件中 |
| 命令执行风险 | 仅执行白名单命令,避免拼接用户输入到命令行参数中 |
| 网络通信安全 | 使用HTTPS协议,验证SSL证书有效性 |
| 敏感数据暴露 | 输出结果中不包含密钥、令牌等敏感信息 |
使用前请确认已阅读依赖说明章节,确保运行环境满足安全要求。