本地知识库集成

支持自动化文档检索、投喂及双轨模式切换,提升本地知识库管理和工作流效率的专业AI辅助工具。

天轰穿

@thcjp

Install

$ openclaw skills install @thcjp/knowledge-toolkit

功能说明: 本技能涵盖 自动化配置和灵活的参数设置、时使用、化配置和灵活的参数设置 等核心能力。

功能说明: 本技能涵盖 化流程、化工作流场景 等核心能力。

Knowledge

付费版进阶功能

能力免费版付费版
基础功能支持支持
Knowledge文档检索不支持支持
复杂工作流可视化编排不支持支持
条件分支与异常重试不支持支持
定时触发与事件驱动不支持支持
执行日志与审计追踪不支持支持

应用场景

场景输入输出
文档处理文件路径与格式选项转换结果与页面信息
本地知识库集成 -目标数据与配置参数处理结果与执行状态
双轨模式切换目标数据与配置参数处理结果与执行状态

不适用于:需要人工判断的复杂决策场景

使用指南

命令说明
"查一下 详情见说明"搜索知识库
"切换到本地知识库"使用本地检索
"切换到 AnythingLLM"使用对话模式
"知识库统计"查看文档数量

结果验证: 任务完成后,查看输出确认状态。成功时返回摘要和数据;失败时根据错误信息排查,参考恢复章节获取修复步骤. 使用步骤:

  1. 阅读依赖说明章节,确认运行环境已就绪
  2. 根据任务需求,参考核心能力章节选择对应能力
  3. 按照能力描述提供输入参数,执行操作
  4. 查看输出结果,确认任务完成状态

参数说明

参数名类型必填说明

| instruction | string | 是 | 用户指令文本 | | context | string | 否 | 上下文信息 |

响应格式

{
  "success": true,
  "data": {
    result: "knowledge 相关配置参数",
    result: "knowledge 相关配置参数"
  },
  "error": null
}

运行环境

运行环境

  • Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
  • 操作系统: Windows / macOS / Linux

依赖说明(补充)

依赖项类型是否必需获取方式
LLM APIAPI必需由Agent内置LLM提供

API Key 配置

可用性分类

  • 分类: MD+execute()
  • 说明: 基于Markdown的AI Skill,

API Key配置方式:

export API_KEY="${API_KEY:?请设置环境变量}"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

限制条件

  • 本地运行,不支持多设备同步
  • 文档处理依赖原文件的格式规范性与完整性
  • 免费版不支持OCR识别与复杂排版还原
  • 批量处理时内存占用较高

差异化分析

效率提升量化分析

操作步骤手动耗时自动化耗时时间节约准确率提升
文档检索30分钟5分钟25分钟5%
文档投喂2小时30分钟1.5小时10%
双轨模式切换15分钟3分钟12分钟8%
信息整理4小时1小时3小时7%
工作流自动化8小时2小时6小时6%

差异化对比

对比维度本技能手动操作Python脚本专业软件
操作便捷性
功能丰富性
学习成本
成本效益
扩展性

核心痛点解决

痛点描述影响范围解决方案量化效果
文档检索效率低大量文档检索需要大量时间影响工作效率自动化检索功能节省25%时间
信息整理困难手动整理信息耗时且易出错影响工作质量自动化整理功能提高信息准确率10%
工作流复杂手动操作工作流复杂且易出错影响工作效率自动化工作流提高工作效率50%

常见问题FAQ

Q1: 本地知识库集成如何进行文档检索?

A: 本地知识库集成支持通过关键词或文件路径进行文档检索,用户只需输入检索指令,系统将自动在本地知识库中查找相关文档。

Q2: 如何将文档投喂到本地知识库?

A: 用户可以通过上传文档或指定文档路径的方式将文档投喂到本地知识库,系统将自动解析文档内容并存储。

Q3: 本地知识库集成支持哪些文件格式?

A: 本地知识库集成支持常见的文档格式,如PDF、Word、Excel等。

Q4: 如何切换到双轨模式?

A: 用户可以通过执行“切换到本地知识库”或“切换到AnythingLLM”的命令来切换到不同的检索模式。

Q5: 本地知识库集成的API如何使用?

A: 本地知识库集成的API提供了丰富的接口,用户可以通过调用相应的API来实现文档检索、投喂等功能。

安全提示

  1. 确保本地知识库中的文档内容安全,避免敏感信息泄露。
  2. 定期备份本地知识库,防止数据丢失。
  3. 限制对本地知识库的访问权限,防止未授权访问。
  4. 使用强密码保护本地知识库的访问。
  5. 定期更新系统软件和依赖库,防止安全漏洞。

安全风险防范

风险项等级防护措施验证方法
API密钥泄露通过环境变量配置,禁止硬编码定期检查代码和配置文件
命令执行风险仅执行白名单命令,避免拼接用户输入使用沙箱环境测试
网络通信安全使用HTTPS协议,验证SSL证书定期检查证书有效期
敏感数据暴露输出结果中不包含密钥、令牌等敏感信息日志脱敏审查
未授权访问限制访问权限,实施认证机制定期审计访问日志

异常恢复方案

针对"本地知识库集成"使用中可能遇到的常见问题,提供以下排查方案:

错误类型原因分析解决方案
API认证失败(401)API密钥错误或过期检查密钥配置,重新生成token
接口限流(429)请求频率超出限制降低调用频率,启用重试退避策略
响应超时(504)网络延迟或服务端负载过高增加超时阈值,检查网络连接
文件不存在路径错误或文件未创建检查路径拼写,确认文件已生成
文件格式不支持扩展名不在支持列表中转换为支持的格式后重试
权限不足当前用户无读写权限检查文件权限,以管理员身份运行
命令执行失败参数错误或环境依赖缺失检查命令语法,确认依赖已安装
进程超时命令执行时间过长增加超时设置,优化命令参数
网络连接失败DNS解析失败或防火墙拦截检查网络配置,确认代理设置

"本地知识库集成"通用排查步骤

  1. 检查输入参数: 确认所有必填参数已提供且格式正确
  2. 查看日志输出: 定位具体错误行和异常类型
  3. 验证环境配置: 确认依赖库版本和运行环境满足要求
  4. 逐步调试: 缩小问题范围,隔离故障模块

Top skills in this category