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

该脚本将执行以下操作：

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

必需：Volcengine / Ark API 密钥

获取密钥地址：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"
    }
  }
}

可用工具列表

示例用法

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

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

故障排查

关键文件说明

• ov.conf — 配置文件（含 API 密钥、模型参数等）
• data/ — 向量数据库存储目录
• server.py — MCP 服务端实现