OpenViking 记忆插件指南：AI助手长期记忆管理与自动上下文注入

openviking-memory by volcengine/openviking

135 周安装量

18,800 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/volcengine/openviking --skill openviking-memory

AI/机器学习聊天机器人插件自然语言处理

🇨🇳中文介绍

OpenViking 记忆指南

工作原理

自动捕获 : 在 afterTurn（一个用户轮次运行结束时），自动从用户/助手消息中提取记忆
- semantic 模式：捕获所有符合条件的用户文本，依赖 OpenViking 的提取管道进行过滤
- keyword 模式：仅捕获匹配触发词（例如“记住”、“偏好”等）的文本
自动回忆 : 在 before_prompt_build 时，自动搜索相关记忆并将其注入上下文

可用工具

memory_recall — 搜索记忆

在 OpenViking 中搜索长期记忆，返回相关结果。

参数	必需	描述
`query`

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

相关 Skills

find-skills 技能搜索工具 - Vercel Labs 开源智能体技能包管理器

855,400 周安装

React 组合模式指南：Vercel 组件架构最佳实践，提升代码可维护性

115,300 周安装

AI Elements：基于shadcn/ui的AI原生应用组件库，快速构建对话界面

65,000 周安装

超能力技能使用指南：AI助手技能调用优先级与工作流程详解

47,800 周安装

参数	必需	描述
`text`	是	要存储的信息文本
`role`	否	会话角色（默认 `user`）
`sessionId`	否	现有的 OpenViking 会话 ID

参数	必需	描述
`uri`	否	精确的记忆 URI（直接删除）
`query`	否	搜索查询（查找后删除）
`targetUri`	否	搜索范围 URI
`limit`	否	搜索限制（默认 5）
`scoreThreshold`	否	最低相关性分数

字段	默认值	描述
`mode`	`remote`	`local`（启动本地服务器）或 `remote`（连接远程服务器）
`baseUrl`	`http://127.0.0.1:1933`	OpenViking 服务器 URL（远程模式）
`apiKey`	—	OpenViking API 密钥（可选）
`agentId`	`default`	向 OpenViking 标识此代理
`configPath`	`~/.openviking/ov.conf`	配置文件路径（本地模式）
`port`	`1933`	本地服务器端口（本地模式）
`targetUri`	`viking://user/memories`	默认搜索范围
`autoCapture`	`true`	自动捕获记忆
`captureMode`	`semantic`	捕获模式：`semantic` / `keyword`
`captureMaxLength`	`24000`	每次捕获的最大文本长度
`autoRecall`	`true`	自动回忆并注入上下文
`recallLimit`	`6`	自动回忆期间注入的最大记忆数
`recallScoreThreshold`	`0.01`	回忆的最低相关性分数
`ingestReplyAssist`	`true`	检测到多方对话文本时添加回复指导

症状	原因	解决方法
`extracted 0 memories`	API 密钥或模型名称错误	检查 `ov.conf` 中的 `api_key` 和 `model`
`port occupied`	端口被其他进程占用	更改端口：`openclaw config set plugins.entries.openviking.config.port 1934`
插件未加载	环境变量文件未 source 或插槽未配置	检查 `openclaw status` 输出
回忆不准确	recallScoreThreshold 过低	提高阈值或调整 recallLimit

🇺🇸English

OpenViking Memory Guide

How It Works

Auto-Capture : At afterTurn (end of one user turn run), automatically extracts memories from user/assistant 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 : At before_prompt_build, 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)

Daily Operations

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

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

# Check status
openclaw status
openclaw config get plugins.slots.contextEngine

# Disable memory
openclaw config set plugins.slots.contextEngine legacy

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

Restart the gateway after changing the slot.

Multi-Instance Support

If you have multiple OpenClaw instances, use --workdir to target a specific one:

# Install script
curl -fsSL ... | bash -s -- --workdir ~/.openclaw-openclaw-second

# Setup helper
npx ./examples/openclaw-plugin/setup-helper --workdir ~/.openclaw-openclaw-second

# Manual config (prefix openclaw commands)
OPENCLAW_STATE_DIR=~/.openclaw-openclaw-second openclaw config set ...

Troubleshooting

Symptom	Cause	Fix
`extracted 0 memories`	Wrong API Key or model name	Check `api_key` and `model` in `ov.conf`
`port occupied`	Port used by another process	Change port: `openclaw config set plugins.entries.openviking.config.port 1934`
Plugin not loaded	Env file not sourced or slot not configured	Check `openclaw status` output

Weekly Installs

135

Repository

volcengine/openviking

GitHub Stars

18.8K

First Seen

Mar 9, 2026

Security Audits

Gen Agent Trust HubFail SocketWarn SnykPass

Installed on

gemini-cli134

codex134

kimi-cli134

github-copilot134

amp134

cline134