[Bug]: OpenViking 插件在单实例多 Agent 场景下存在 Bug

[jianji112]

Bug Description

Issue: OpenViking 插件在单实例多 Agent 场景下存在 Bug

环境

• OpenClaw: 2026.3.13
• OpenViking 插件: remote 模式
• Agent: main / codenu / shegmei（同一实例内）

---

Bug 描述

单 OpenClaw 实例配置了多个 agent，共用 OpenViking 作为 context engine。期望每个 agent 的会话独立保存，但实际只有主 agent 的数据被写入 OV。

Bug 根因

1. 全局 agentId 无法区分多 agent：plugins.entries.openviking.config.agentId 只能配一个值，所有 agent 调用 OV 时使用同一个身份。

2. 钩子触发异常：虽然 before_prompt_build 和 afterTurn 的 runtimeContext 中包含 agentId，但 OV API 调用时仍使用全局配置的 agentId（"main"），导致只有主 agent 的会话被写入。

建议修复方向

插件应在 before_prompt_build / afterTurn 钩子中，优先使用 runtimeContext.agentId（而非全局配置的 agentId）作为 OV API 的身份标识，实现单实例多 agent 的会话隔离。

---

Steps to Reproduce

复现步骤

1. 单 OpenClaw 实例，配置 3 个 agent（main / codenu / shegmei）
2. 设置 plugins.slots.contextEngine = openviking，remote 模式，agentId = main
3. 3 个 agent 均正常收发消息
4. 向 codenu 发消息 → OV 中无新数据
5. 向 main 发消息 → OV 中 main session 有数据

Expected Behavior

• codenu 的消息 → OV 中 agent:codenu:* session 有记录
• shegmei 的消息 → OV 中 agent:shegmei:* session 有记录

Actual Behavior

• 只有 main 的消息被写入 OV，其他 agent 完全忽略

Minimal Reproducible Example

Error Logs

OpenViking Version

2026.3.13

Python Version

3.13.3

Operating System

Linux

Model Backend

None

Additional Context

No response

[evaldass]

在 OpenClaw 2026.3.28 + 插件 2026.3.25 上测试 — 多 Agent 路由正常

我在旧版 OpenClaw 上能复现这个问题，但在 OpenClaw 2026.3.28 + 插件 2026.3.25 上，多 Agent 的 agentId 路由已经正常工作。

验证内容

1. Hook 正确传递 ctx.agentId — before_prompt_build、afterTurn、session_start、session_end 都能从 OpenClaw runtime context 中获取到正确的 Agent ID。

2. 插件正确解析 — createSessionAgentResolver 在 configAgentId="default"（未配置 agentId 时的默认值）下，能正确使用 OpenClaw 传入的 ctx.agentId 作为 X-OpenViking-Agent header。

3. OV 存储到不同的 Agent 作用域 — 通过 /api/v1/fs/ls?uri=viking://agent 确认：

   • X-OpenViking-Agent: main → viking://agent/90e0d57253cd
   • X-OpenViking-Agent: default → viking://agent/f70bf9333d62
   • 两个 Agent 的数据完全隔离。

4. 日志确认 — 系统日志显示所有活跃会话的 agentId=main 均正确解析。

根因分析

问题出在 旧版 OpenClaw core（如 issue 中报告的 2026.3.13）的 hook 回调中未给非默认 Agent 传递 ctx.agentId / runtimeContext.agentId。插件代码本身已经具备完整的多 Agent 逻辑，只是需要 OpenClaw runtime 提供 Agent 身份信息。

建议

升级到 OpenClaw ≥ 2026.3.28 即可解决此问题，插件本身无需修改。