OpenViking_知识管理 skill-PHP中文网

OpenViking

Polar Sponsor

爱发电赞助

.NET 9.0

立即下载

通过 OpenViking ContextDatabase MCP 服务器实现 RAG 与语义搜索，支持文档查询、知识库搜索、向量化存储添加文件/URL。用于文档问答、知识管理、AI 代理记忆、文件搜索和语义检索。触发关键词："openviking", "search documents", "semanticsearch", "knowledge base", "vector database", &qu

OpenViking - AI Agents的上下文数据库.

功能概述

OpenViking - AI Agents的上下文数据库.是一项面向实际任务的技能，主要用于OpenViking是ByteDance为AI Agents设计的开源上下文数据库——下一代RAG系统,它用平面矢量存储器取代了平面矢量存储器.。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。

核心要点

使用时应结合输入条件选择合适的执行方式，核对必要参数、依赖环境与输出内容，并按原始要求处理异常情况。
该技能适合需要稳定复用相关能力的场景，可作为自动化工作流的一部分，也便于后续检查、调整和扩展。
从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。

OpenViking — AI Agent 的上下文数据库

OpenViking 是字节跳动推出的开源 上下文数据库（Context Database），专为 AI Agent 设计 —— 这是一套新一代 RAG 系统，以文件系统范式替代传统的扁平化向量存储，用于管理记忆（memories）、资源（resources）和技能（skills）。

核心特性：

文件系统范式：像管理文件一样组织上下文，支持 URI 地址（例如：viking://resources/...）
分层上下文（L0/L1/L2）：抽象层 → 概览层 → 完整内容层，按需加载
目录递归检索：相比扁平化向量搜索，准确率更高
内置 MCP 服务器：通过 Model Context Protocol 提供完整的 RAG 流水线

快速检查：是否已配置完成？

test -f ~/code/openviking/examples/mcp-query/ov.conf && echo "Ready" || echo "Needs setup"
curl -s http://localhost:2033/mcp && echo "Running" || echo "Not running"

若尚未配置 → 执行初始化

运行初始化脚本（仅需一次）：

bash ~/.openclaw/skills/openviking-mcp/scripts/init.sh

该脚本将执行以下操作：

从 https://github.com/volcengine/OpenViking 克隆 OpenViking 仓库
使用 uv sync 安装依赖
生成 ov.conf 配置模板
暂停执行，等待您手动填入 API 密钥（embedding.dense.api_key、vlm.api_key）

必需：Volcengine / Ark API 密钥

配置项	用途
`embedding.dense.api_key`	语义搜索所用的嵌入模型密钥
`vlm.api_key`	用于答案生成的 LLM 密钥

获取密钥地址：https://console.volcengine.com/ark

启动服务端

cd ~/code/openviking/examples/mcp-query
uv run server.py

支持的命令行选项：

--port 2033 — 监听端口
--host 127.0.0.1 — 绑定地址
--data ./data — 数据目录路径

服务地址为：http://127.0.0.1:2033/mcp

连接 Claude

claude mcp add --transport http openviking http://localhost:2033/mcp

或手动添加至 ~/.mcp.json：

{
  "mcpServers": {
    "openviking": {
      "type": "http",
      "url": "http://localhost:2033/mcp"
    }
  }
}

可用工具列表

工具名	说明
`query`	完整 RAG 流水线 —— 包含检索 + LLM 答案生成
`search`	仅执行语义搜索，返回匹配文档
`add_resource`	添加文件、目录或 URL 到知识库

示例用法

通过 MCP 成功连接后，可直接使用自然语言指令：

"Query: What is OpenViking?"
"Search: machine learning papers"
"Add https://example.com/article to knowledge base"
"Add ~/documents/report.pdf"

故障排查

问题现象	解决方法
端口被占用	`uv run server.py --port 2034`
认证失败（Auth errors）	检查 `ov.conf` 中的 API 密钥配置
无法访问服务端	确认服务正在运行：`curl localhost:2033/mcp`