openviking-memory

Original：🇺🇸 English

Translated

OpenViking long-term memory plugin guide. Once installed, the plugin automatically remembers important facts from conversations and recalls relevant context before responding.

2installs

Sourcevolcengine/openviking

Added on2026-03-10

NPX Install

npx skill4agent add volcengine/openviking openviking-memory

SKILL.md Content

View Translation Comparison →

OpenViking Memory Guide

How It Works

Auto-Capture: At the end of a conversation, automatically extracts memories from user messages
- ```
semantic
```
  mode: captures all qualifying user text, relying on OpenViking's extraction pipeline to filter
- ```
keyword
```
  mode: only captures text matching trigger words (e.g. "remember", "preference", etc.)
Auto-Recall: Before a conversation starts, automatically searches for relevant memories and injects them into context

Available Tools

memory_recall — Search Memories

Searches long-term memories in OpenViking, returns relevant results.

Parameter	Required	Description
`query`	Yes	Search query text
`limit`	No	Maximum number of results (defaults to plugin config)
`scoreThreshold`	No	Minimum relevance score 0-1 (defaults to plugin config)
`targetUri`	No	Search scope URI (defaults to plugin config)

Example: User asks "What programming language did I say I like?"

memory_store — Manual Store

Writes text to an OpenViking session and runs memory extraction.

Parameter	Required	Description
`text`	Yes	Information text to store
`role`	No	Session role (default `user` )
`sessionId`	No	Existing OpenViking session ID

Example: User says "Remember my email is xxx@example.com"

memory_forget — Delete Memories

Delete by exact URI, or search and delete.

Parameter	Required	Description
`uri`	No	Exact memory URI (direct delete)
`query`	No	Search query (find then delete)
`targetUri`	No	Search scope URI
`limit`	No	Search limit (default 5)
`scoreThreshold`	No	Minimum relevance score

Example: User says "Forget my phone number"

Configuration

Field	Default	Description
`mode`	`remote`	`local` (start local server) or `remote` (connect to remote)
`baseUrl`	`http://127.0.0.1:1933`	OpenViking server URL (remote mode)
`apiKey`	—	OpenViking API Key (optional)
`agentId`	`openclaw-<hostname>`	Identifies this agent (auto-generated, persisted to `~/.openviking/.agent-id` )
`configPath`	`~/.openviking/ov.conf`	Config file path (local mode)
`port`	`1933`	Local server port (local mode)
`targetUri`	`viking://user/memories`	Default search scope
`autoCapture`	`true`	Automatically capture memories
`captureMode`	`semantic`	Capture mode: `semantic` / `keyword`
`captureMaxLength`	`24000`	Maximum text length per capture
`autoRecall`	`true`	Automatically recall and inject context
`recallLimit`	`6`	Maximum memories injected during auto-recall
`recallScoreThreshold`	`0.01`	Minimum relevance score for recall
`ingestReplyAssist`	`true`	Add reply guidance when detecting multi-party conversation text

Daily Operations

bash

# Start (local mode: source env first)
source ~/.openclaw/openviking.env && openclaw gateway

# Start (remote mode: no env needed)
openclaw gateway

# Check status
openclaw status

# Disable memory
openclaw config set plugins.slots.memory none

# Enable memory
openclaw config set plugins.slots.memory memory-openviking

Restart the gateway after changing the slot.

Multi-Instance Support

If you have multiple OpenClaw instances, use

--workdir

to target a specific one: