SkillsAdd

swizardlv/openclaw_openviking_skill · Archived

openviking

Semantic search, context management, and document indexing via OpenViking. Use when the user asks to: index/import documents or files into a knowledge base, perform semantic search across indexed content, browse or explore indexed resources, get summaries/overviews of indexed documents, manage an OpenViking instance, or integrate structured context retrieval into workflows. Also use when sub-agents need to retrieve relevant context from a large document collection.

First seen Mar 5, 2026

Installation

$ npx skills add swizardlv/openclaw_openviking_skill --skill openviking
View on skills.sh ↗ GitHub repository ↗

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

huawei-cloud-openviking-agent-integration Similar · more installs
huaweicloud/huaweicloud-skills

Integrate and unbind OpenViking long-term memory with coding agents. Supports 8 agents (CodeArt…

5K installs
huawei-cloud-openviking-embedding-switch Similar · more installs
huaweicloud/huaweicloud-skills

Switch OpenViking's embedding model to a local llama-server (or any OpenAI-compatible embedding…

5K installs
openviking Similar · more installs
volcengine/openviking

Activate when the user asks about any repository listed in the system prompt under 'OpenViking …

900 installs
openviking-memory Similar · more installs
volcengine/openviking

Recall and persist long-term memory through the OpenViking MCP tools. Use at the start of any s…

446 installs
More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 23
License LICENSE
Default branch main
Open issues 0
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,545 B
  • docs SUMMARY.md 487 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 36 installs

SKILL.md

OpenViking Skill

Manage an OpenViking context database: index documents, semantic search, browse, and retrieve summaries.

Prerequisites

  • Python 3.9+ with openviking package installed (pip install openviking)
  • Config file at ~/.openviking/ov.conf with valid embedding and VLM credentials
  • Environment variable OPENVIKINGCONFIGFILE=~/.openviking/ov.conf

If prerequisites are not met, guide the user through setup. See references/setup-guide.md.

Quick Reference

Index a file

python3 scripts/viking.py add /path/to/file.md

Index all files in a directory (recursive)

python3 scripts/viking.py add-dir /path/to/directory --pattern "*.md"

Semantic search

python3 scripts/viking.py search "query text" --limit 5

Browse resources

python3 scripts/viking.py ls [viking://resources/path]

Get summary

python3 scripts/viking.py abstract viking://resources/my_doc
python3 scripts/viking.py overview viking://resources/my_doc

Read full content

python3 scripts/viking.py read viking://resources/my_doc/section.md

Usage Notes

  • Data directory: Defaults to ./openviking_data in the current working directory. Override with --data-dir.
  • File name collisions: OpenViking uses file names (not full paths) as URIs. Avoid indexing files with identical names from different directories simultaneously.
  • VLM model: Use non-reasoning models (e.g. meta/llama-3.3-70b-instruct) for the VLM. Reasoning models return content in the wrong field.
  • Embedding model: nvidia/nv-embed-v1 (symmetric, 4096-dim) works without extra parameters. Asymmetric models (e.g. nv-embedqa-e5-v5) require input_type which OpenViking doesn't pass.

When to Use Python API vs CLI Script

  • CLI script (scripts/viking.py): For quick one-off operations from the shell.
  • Python API: For complex workflows, batch operations, or integration into other scripts. See references/python-api.md.