本地知识库集成
支持自动化文档检索、投喂及双轨模式切换,提升本地知识库管理和工作流效率的专业AI辅助工具。
天轰穿
@thcjp
Install
$ openclaw skills install @thcjp/knowledge-toolkit功能说明: 本技能涵盖 自动化配置和灵活的参数设置、时使用、化配置和灵活的参数设置 等核心能力。
功能说明: 本技能涵盖 化流程、化工作流场景 等核心能力。
Knowledge
付费版进阶功能
| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| Knowledge文档检索 | 不支持 | 支持 |
| 复杂工作流可视化编排 | 不支持 | 支持 |
| 条件分支与异常重试 | 不支持 | 支持 |
| 定时触发与事件驱动 | 不支持 | 支持 |
| 执行日志与审计追踪 | 不支持 | 支持 |
应用场景
| 场景 | 输入 | 输出 |
|---|---|---|
| 文档处理 | 文件路径与格式选项 | 转换结果与页面信息 |
| 本地知识库集成 - | 目标数据与配置参数 | 处理结果与执行状态 |
| 双轨模式切换 | 目标数据与配置参数 | 处理结果与执行状态 |
不适用于:需要人工判断的复杂决策场景
使用指南
| 命令 | 说明 |
|---|---|
| "查一下 详情见说明" | 搜索知识库 |
| "切换到本地知识库" | 使用本地检索 |
| "切换到 AnythingLLM" | 使用对话模式 |
| "知识库统计" | 查看文档数量 |
结果验证: 任务完成后,查看输出确认状态。成功时返回摘要和数据;失败时根据错误信息排查,参考恢复章节获取修复步骤. 使用步骤:
- 阅读依赖说明章节,确认运行环境已就绪
- 根据任务需求,参考核心能力章节选择对应能力
- 按照能力描述提供输入参数,执行操作
- 查看输出结果,确认任务完成状态
参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|
| 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 API | API | 必需 | 由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来实现文档检索、投喂等功能。
安全提示
- 确保本地知识库中的文档内容安全,避免敏感信息泄露。
- 定期备份本地知识库,防止数据丢失。
- 限制对本地知识库的访问权限,防止未授权访问。
- 使用强密码保护本地知识库的访问。
- 定期更新系统软件和依赖库,防止安全漏洞。
安全风险防范
| 风险项 | 等级 | 防护措施 | 验证方法 |
|---|---|---|---|
| API密钥泄露 | 高 | 通过环境变量配置,禁止硬编码 | 定期检查代码和配置文件 |
| 命令执行风险 | 高 | 仅执行白名单命令,避免拼接用户输入 | 使用沙箱环境测试 |
| 网络通信安全 | 中 | 使用HTTPS协议,验证SSL证书 | 定期检查证书有效期 |
| 敏感数据暴露 | 高 | 输出结果中不包含密钥、令牌等敏感信息 | 日志脱敏审查 |
| 未授权访问 | 中 | 限制访问权限,实施认证机制 | 定期审计访问日志 |
异常恢复方案
针对"本地知识库集成"使用中可能遇到的常见问题,提供以下排查方案:
| 错误类型 | 原因分析 | 解决方案 |
|---|---|---|
| API认证失败(401) | API密钥错误或过期 | 检查密钥配置,重新生成token |
| 接口限流(429) | 请求频率超出限制 | 降低调用频率,启用重试退避策略 |
| 响应超时(504) | 网络延迟或服务端负载过高 | 增加超时阈值,检查网络连接 |
| 文件不存在 | 路径错误或文件未创建 | 检查路径拼写,确认文件已生成 |
| 文件格式不支持 | 扩展名不在支持列表中 | 转换为支持的格式后重试 |
| 权限不足 | 当前用户无读写权限 | 检查文件权限,以管理员身份运行 |
| 命令执行失败 | 参数错误或环境依赖缺失 | 检查命令语法,确认依赖已安装 |
| 进程超时 | 命令执行时间过长 | 增加超时设置,优化命令参数 |
| 网络连接失败 | DNS解析失败或防火墙拦截 | 检查网络配置,确认代理设置 |
"本地知识库集成"通用排查步骤
- 检查输入参数: 确认所有必填参数已提供且格式正确
- 查看日志输出: 定位具体错误行和异常类型
- 验证环境配置: 确认依赖库版本和运行环境满足要求
- 逐步调试: 缩小问题范围,隔离故障模块
Top skills in this category
Self-Improving + Proactive Agent
@ivangdavilaSelf-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
ontology
@oswalpalashTyped knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
Humanizer
@biostartechnologyRemove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases.
Obsidian
@steipeteWork with Obsidian vaults (plain Markdown notes) and automate via obsidian-cli.
YouTube Watcher
@michaelgatharaFetch and read transcripts from YouTube videos. Use when you need to summarize a video, answer questions about its content, or extract information from it.