mcpField
O
ov_dream

ov_dream

github.com/volcengineAgent 工作流41.1k70 次安装今天更新
代码仓库

关于 ov_dream

这是供 OpenClaw 手动将符合条件的聊天记录同步到 OpenViking 并召回记忆的技能。它通过 `ov dream` 和 `ov recall` 显式触发，不会自动将召回内容注入提示词。

主要功能

  1. 01手动同步符合条件的聊天会话
  2. 02为每个会话保存独立同步游标
  3. 03在默认用户根 URI 下召回记忆
  4. 04排除指定的非聊天会话
  5. 05不自动注入提示词

适用场景

  1. 01将近期聊天记录同步到 OpenViking
  2. 02根据操作员查询召回记忆

安装

复制下面的命令，在终端中运行。

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

安装后在 Claude Code 中输入/ov_dream确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

__init__.py
OV_LITE_INSTALL.md
scripts/
__init__.py
dream.py
tests/
test_dream_cli.py

详细介绍

OV Dream

使用此技能进行手动 OpenViking 同步和召回，而不占用 OpenClaw 的 contextEngine 槽位。

何时使用

当用户消息以以下任一确切前缀开头时，使用此技能：

  • ov dream
  • ov recall

不要将这些消息视为普通对话。它们是显式的操作员命令。

命令

  • ov dream 手动同步。读取 OpenClaw 的 sessions.json，将符合条件的聊天记录同步到 OpenViking，然后在存在新消息时提交每个会话。

  • ov recall <query> 手动召回。在默认用户根 URI viking://user/default 下搜索 OpenViking。

同步行为

当用户消息恰好为 ov dream 时触发。

执行流程：

  1. 运行：

    python3 scripts/dream.py dream

  2. 返回同步摘要。

同步命令在可用时从 ~/.openclaw/agents/main/sessions/sessions.json 读取 OpenClaw 会话元数据。它会同步类似聊天的会话键，例如 agent:main:main、:direct:、:channel:、:group: 和 :room:。

它不得同步显式的非聊天会话，包括包含 :cron:、:heartbeat、:subagent:、:acp: 或 :hook: 的键。

每个源会话在 ~/.openclaw/memory/ov_dream_sync.json 中保留独立的同步游标。

召回行为

当用户消息以 ov recall 开头时触发。

这是此技能的硬性路由规则：

  • 如果用户说 ov recall <query>，不要基于一般推理作答。
  • 不要总结召回会做什么。
  • 不要询问是否应运行召回。
  • 立即执行本地召回命令。

执行流程：

  1. 提取 ov recall 之后的所有内容作为召回查询。

  2. 运行：

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

  3. 将相关记忆行返回给用户。

  4. 如果未找到任何记忆，返回 No memories found.

规则：

  • 将 ov recall ... 视为手动召回请求，而非普通对话轮次。
  • 将 ov recall 之后的命令文本视为确切的召回查询。
  • 从技能目录运行召回命令，以便正确解析 scripts/dream.py。
  • 不要将检索到的记忆自动注入提示词上下文。
  • 除非用户单独要求同步，否则不要触发 ov dream。
  • 如果查询为空，请向用户询问召回查询，而不是猜测。

备注

  • 此技能在第一个版本中仅支持手动操作。
  • 它不会将召回自动注入提示词。
  • 它不会替代 OpenViking 上下文引擎插件。
  • 基于磁盘的同步适用于最近记录的聊天记录。它并非精确的“当前运行会话”检测器。
  • 对于 OpenViking 无服务器模式，配置 OPENVIKING_BASE_URL、OPENVIKING_API_KEY，以及可选的 OPENVIKING_AUTH_MODE=serverless。命令行将自动使用 Bearer 认证和无服务器会话消息格式。

评论

支持 Markdown