New to Claude Skills? Learn how to install them →

Get Claude Skills
volcengine on GitHub

OV Dream

Free

Sync and recall OpenViking sessions manually.

by volcengine28.2k stars on volcengine/openviking
2 views
Updated Aug 10, 2026
Get this skill

Free · Opens the source repo

What OV Dream does

OV Dream is a specialized skill designed for users of OpenViking, enabling manual synchronization and recall of chat sessions without interfering with the OpenClaw context engine. This skill is particularly useful for developers and designers who need to manage chat transcripts effectively without automatic context injection. By using specific commands, users can control when to sync their chat data and when to retrieve specific memories, ensuring a streamlined workflow.

The skill operates through two main commands: ov dream for syncing and ov recall <query> for retrieving memories. The sync command reads session metadata from OpenClaw, allowing users to sync eligible chat transcripts to OpenViking. It effectively handles various chat-like session keys while avoiding non-chat sessions, ensuring that only relevant data is processed. The recall command allows users to search for specific memories stored in OpenViking, executing the query immediately without any additional conversation context.

This manual approach is beneficial for users who prefer explicit control over their data management. It prevents the skill from automatically injecting retrieved memories into the prompt context, which can be useful for maintaining focus on current tasks without distractions. Additionally, the skill is designed to work seamlessly with the OpenViking serverless configuration, making it adaptable for various deployment scenarios.

Overall, OV Dream is an essential tool for those who require precise control over their chat session management within the OpenViking environment. Its manual-only functionality ensures that users can execute commands deliberately, making it a valuable addition for developers and designers working with chat data.

When to use it

Use this skill when you need to manually sync chat sessions or retrieve specific memories from OpenViking.

When not to use it

This skill is not suitable for automated session management or for users who prefer automatic context injection during conversations.

What you can build with it

Syncing Chat Transcripts

When you want to ensure that your recent chat transcripts are saved to OpenViking, use the `ov dream` command.

Retrieving Specific Memories

If you need to recall a specific memory, use the `ov recall <query>` command to fetch relevant data without context interference.

Manual Data Management

For users who prefer explicit control over their data, OV Dream provides a way to manage chat session data without automation.

How to install OV Dream

View source

1. Install with the skills CLI

npx skills add volcengine/openviking/ov_dream --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by volcengine

OV Dream

Use this skill for manual OpenViking sync and recall without occupying the OpenClaw contextEngine slot.

When To Use

Use this skill when the user message begins with one of these exact prefixes:

  • ov dream
  • ov recall

Do not treat those messages as normal conversation. They are explicit operator commands.

Commands

  • ov dream Manual sync. Read OpenClaw's sessions.json, sync eligible chat transcripts to OpenViking, then commit each session when new messages exist.

  • ov recall <query> Manual recall. Search OpenViking under the default user root URI, viking://user/default.

Sync Behavior

Trigger when the user message is exactly ov dream.

Execution flow:

  1. Run:

    python3 scripts/dream.py dream

  2. Return the sync summary.

The sync command reads OpenClaw session metadata from ~/.openclaw/agents/main/sessions/sessions.json when available. It syncs chat-like session keys such as agent:main:main, :direct:, :channel:, :group:, and :room:.

It must not sync explicitly non-chat sessions, including keys containing :cron:, :heartbeat, :subagent:, :acp:, or :hook:.

Each source session keeps an independent sync cursor in ~/.openclaw/memory/ov_dream_sync.json.

Recall Behavior

Trigger when the user message starts with ov recall .

This is a hard routing rule for this skill:

  • If the user says ov recall <query>, do not answer from general reasoning.
  • Do not summarize what recall would do.
  • Do not ask whether recall should be run.
  • Immediately execute the local recall command.

Execution flow:

  1. Extract everything after ov recall as the recall query.

  2. Run:

    python3 scripts/dream.py recall "<query>"

  3. Return the relevant memory rows to the user.

  4. If no memories are found, return No memories found.

Rules:

  • Treat ov recall ... as a manual recall request, not a normal conversation turn.
  • Treat the command text after ov recall as the exact recall query.
  • Run the recall command from the skill directory so scripts/dream.py resolves correctly.
  • Do not auto-inject retrieved memories into prompt context.
  • Do not trigger ov dream unless the user separately asks for sync.
  • If the query is empty, ask the user for the recall query instead of guessing.

Notes

  • This skill is manual-only in the first version.
  • It does not auto-inject recall into prompts.
  • It does not replace the OpenViking context-engine plugin.
  • Disk-based sync is for recently recorded chat transcripts. It is not a precise "currently running sessions" detector.
  • For OpenViking serverless, configure OPENVIKING_BASE_URL, OPENVIKING_API_KEY, and optionally OPENVIKING_AUTH_MODE=serverless. The CLI will use Bearer auth and the serverless session message format automatically.

Frequently asked questions about OV Dream

Similar skills

Skill Creator

Efficiently create and manage skills for Gemini CLI.

Agent Development

Create and manage autonomous agents for Claude Code.

Math Olympiad Solver

Solve and verify competition math problems effectively.

Microsoft Skill Creator

Create specialized skills for Microsoft technologies.

Doublecheck

A verification pipeline for AI-generated claims.

Skill Development for Claude Code

Create and enhance skills for Claude Code plugins.