OpenViking

Name: OpenViking
Author: Zayn Jarvis

RAG and semantic search via OpenViking Context Database MCP server. Query documents, search knowledge base, add files/URLs to vector memory. Use for document Q&A, knowledge managem…

Zayn Jarvis

@zaynjarvis

Install

$ openclaw skills install @zaynjarvis/openviking-skill

OpenViking - Context Database for AI Agents

OpenViking is ByteDance's open-source Context Database designed for AI Agents — a next-generation RAG system that replaces flat vector storage with a filesystem paradigm for managing memories, resources, and skills.

Key Features:

Filesystem paradigm: Organize context like files with URIs (viking://resources/...)
Tiered context (L0/L1/L2): Abstract → Overview → Full content, loaded on demand
Directory recursive retrieval: Better accuracy than flat vector search
MCP server included: Full RAG pipeline via Model Context Protocol

Quick Check: Is It Set Up?

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"

If Not Set Up → Initialize

Run the init script (one-time):

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

This will:

Clone OpenViking from https://github.com/volcengine/OpenViking
Install dependencies with uv sync
Create ov.conf template
Pause for you to add API keys (embedding.dense.api_key, vlm.api_key)

Required: Volcengine/Ark API Keys

Config Key	Purpose
`embedding.dense.api_key`	Semantic search embeddings
`vlm.api_key`	LLM for answer generation

Get keys from: https://console.volcengine.com/ark

Start the Server

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

Options:

--port 2033 - Listen port
--host 127.0.0.1 - Bind address
--data ./data - Data directory

Server will be at: http://127.0.0.1:2033/mcp

Connect to Claude

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

Or add to ~/.mcp.json:

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

Tools Available

Tool	Description
`query`	Full RAG pipeline — search + LLM answer
`search`	Semantic search only, returns docs
`add_resource`	Add files, directories, or URLs

Example Usage

Once connected via MCP:

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

Troubleshooting

Issue	Fix
Port in use	`uv run server.py --port 2034`
Auth errors	Check API keys in ov.conf
Server not found	Ensure it's running: `curl localhost:2033/mcp`

Files

ov.conf - Configuration (API keys, models)
data/ - Vector database storage
server.py - MCP server implementation

Related skills

WeKnora

@lyingbug

Import documents and perform knowledge retrieval via WeKnora API. Use when uploading files, URLs, or Markdown to a knowledge base, searching knowledge with hybrid retrieval (vector + keyword), or querying knowledge details. Triggers: (1) uploading documents to a knowledge base, (2) hybrid search acr

121.3k

Vector Memory Hack

@mig6671

Fast semantic search for AI agent memory files using TF-IDF and SQLite. Enables instant context retrieval from MEMORY.md or any markdown documentation. Use when the agent needs to (1) Find relevant context before starting a task, (2) Search through large memory files efficiently, (3) Retrieve specific rules or decisions without reading entire files, (4) Enable semantic similarity search instead of keyword matching. Lightweight alternative to heavy embedding models - zero external dependencies, <10ms search time.

93.8k

PARA Second Brain

@halthelobster

Organize your agent's knowledge using PARA (Projects, Areas, Resources, Archive) — then make it ALL searchable. The symlink trick enables full semantic search across your entire knowledge base, not just MEMORY.md. Includes session transcript indexing and memory flush protocol. Your agent finally has a real second brain.

527.7k

ontology

@oswalpalash

Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...

653195k

Cognitive Memory

@icemilo414

Intelligent multi-store memory system with human-like encoding, consolidation, decay, and recall. Use when setting up agent memory, configuring remember/forget triggers, enabling sleep-time reflection, building knowledge graphs, or adding audit trails. Replaces basic flat-file memory with a cognitive architecture featuring episodic, semantic, procedural, and core memory stores. Supports multi-agent systems with shared read, gated write access model. Includes philosophical meta-reflection that deepens understanding over time. Covers MEMORY.md, episode logging, entity graphs, decay scoring, reflection cycles, evolution tracking, and system-wide audit.

2911k

Supermemory

@clawdbot51-oss

Store and retrieve memories using the SuperMemory API. Add content, search memories, and chat with your knowledge base.

178.8k