$npx -y skills add volcengine/OpenViking --skill install-openviking-memoryInstall and configure the OpenViking long-term memory plugin for OpenClaw via natural conversation. Once installed, the plugin automatically captures important facts from chats and recalls relevant context before each reply (auto-capture + auto-recall, cross-session). Covers prer
| 1 | # Install OpenViking Memory — Agent Installation & Reference Skill |
| 2 | |
| 3 | You are about to help a user install and configure the OpenViking memory plugin for OpenClaw. |
| 4 | The user does NOT know how to use a terminal. You will collect a few values through natural conversation, then run **all** commands yourself using your shell tool. |
| 5 | |
| 6 | **Read this entire document before starting. Follow every step in order. Do NOT skip steps.** |
| 7 | |
| 8 | This skill is split into two halves: |
| 9 | |
| 10 | - **Part 1 (STEP 0–10): Natural-language installation walkthrough.** Use this on first install or reconfigure. |
| 11 | - **Part 2: Reference.** Tools, config schema, multi-tenant, multi-instance, daily ops, uninstall, error recovery. Read on demand. |
| 12 | |
| 13 | > **Server scope.** This skill **does not** install the OpenViking server itself. It assumes the server is already running locally on `127.0.0.1:1933` or on another machine. If the user has no server, see "Server not ready" handling in STEP 5. |
| 14 | |
| 15 | --- |
| 16 | |
| 17 | # Part 1 — Natural-Language Installation Walkthrough |
| 18 | |
| 19 | ## STEP 0: Detect Language |
| 20 | |
| 21 | If the user's first message contains Chinese characters, respond in **Chinese** throughout. |
| 22 | Otherwise respond in **English**. |
| 23 | All user-facing messages below have (CN)/(EN) variants — use the matching one. |
| 24 | |
| 25 | Do NOT show this step to the user. |
| 26 | |
| 27 | --- |
| 28 | |
| 29 | ## STEP 1: Detect Operating System (silently) |
| 30 | |
| 31 | Run this command and remember the result. Do NOT show it to the user. |
| 32 | |
| 33 | ```bash |
| 34 | uname -s 2>/dev/null || echo WINDOWS |
| 35 | ``` |
| 36 | |
| 37 | - Output contains `Darwin` → `OS=mac` |
| 38 | - Output contains `Linux` → `OS=linux` |
| 39 | - Output is `WINDOWS` or the command fails → `OS=windows` |
| 40 | |
| 41 | --- |
| 42 | |
| 43 | ## STEP 2: Check Prerequisites (silently) |
| 44 | |
| 45 | Run silently: |
| 46 | |
| 47 | ```bash |
| 48 | node -v |
| 49 | openclaw --version |
| 50 | ``` |
| 51 | |
| 52 | **If `node` is missing:** |
| 53 | |
| 54 | > (CN) 你的系统没有安装 Node.js。OpenClaw 和 OpenViking 插件需要 Node.js >= 22。请先安装 Node.js,然后再回来找我。 |
| 55 | > (EN) Node.js is not installed. OpenClaw and the OpenViking plugin require Node.js >= 22. Please install Node.js first, then come back. |
| 56 | |
| 57 | **Stop. Do NOT continue.** |
| 58 | |
| 59 | **If `openclaw` is missing:** |
| 60 | |
| 61 | > (CN) 你的系统没有安装 OpenClaw。请先安装 OpenClaw(>= 2026.5.27),然后再回来找我。 |
| 62 | > (EN) OpenClaw is not installed. Please install OpenClaw (>= 2026.5.27) first, then come back. |
| 63 | |
| 64 | **Stop. Do NOT continue.** |
| 65 | |
| 66 | If both exist, proceed to STEP 3 silently. |
| 67 | |
| 68 | --- |
| 69 | |
| 70 | ## STEP 3: Greet and Ask for 3 Values |
| 71 | |
| 72 | Send this message: |
| 73 | |
| 74 | > (CN) 好,我来帮你接入 OpenViking 长期记忆。装好之后,我会自动记住对话里的重要信息,下次聊也能回忆起来。 |
| 75 | > |
| 76 | > 我需要 3 条信息,不知道的可以问你的管理员: |
| 77 | > 1. **OpenViking 服务地址** —— 例如 `https://ov.example.com` 或 `http://192.168.1.100:1933`,本机服务可以直接说"本机" |
| 78 | > 2. **API Key** —— 用来鉴权;服务没开认证可以说"没有" |
| 79 | > 3. **Agent 标识前缀**(可选) —— 用于区分多个 agent 的记忆命名空间,留空就用默认 |
| 80 | > |
| 81 | > 先告诉我服务地址吧? |
| 82 | |
| 83 | > (EN) I'll set up OpenViking long-term memory for you. Once configured, I'll automatically remember important info from our chats and recall it later. |
| 84 | > |
| 85 | > I need 3 things (ask your admin if unsure): |
| 86 | > 1. **OpenViking server URL** — e.g. `https://ov.example.com` or `http://192.168.1.100:1933`. For a local server, just say "local". |
| 87 | > 2. **API Key** — for auth. Say "none" if the server has no auth. |
| 88 | > 3. **peer prefix** (optional) — used to namespace memories across agents. Leave blank for default. |
| 89 | > |
| 90 | > What's the server URL? |
| 91 | |
| 92 | --- |
| 93 | |
| 94 | ## STEP 4: Collect Values |
| 95 | |
| 96 | Collect 3 values through natural conversation. Be flexible: if the user gives several at once, parse them all. If they correct something, accept the new value. |
| 97 | |
| 98 | ### 4a. `BASE_URL` (REQUIRED) |
| 99 | |
| 100 | - "local" / "本机" / "localhost" → use `http://127.0.0.1:1933`. |
| 101 | - `ov.example.com` without protocol → prepend `https://`. |
| 102 | - Strip trailing `/`, `/health`, or `/api`. |
| 103 | - After normalization must start with `http |