Skip to content

Releases: volcengine/OpenViking

v0.3.3

03 Apr 06:59
433406f

Choose a tag to compare

OpenViking v0.3.3

本次 v0.3.3 版本主要围绕评测与写入能力、OpenClaw 插件与集成体验、会话与资源导入链路、稳定性与安全性,以及测试与 CI 体系做了集中增强。相较 v0.3.2,这一版本一方面补齐了 benchmark / eval / write 等面向落地使用的能力,另一方面也明显加强了 OpenClaw 插件的可观测性、健康检查、容错和测试覆盖,同时修复了若干会直接影响生产使用的锁处理、任务权限、ZIP 编码、资源导入与 embedder 参数问题。

Highlights

  • 评测与写入能力继续扩展:新增 RAG benchmark 评测框架 PR #825,补充 OpenClaw 的 LoCoMo eval 脚本与说明 PR #1152,并新增内容写入接口 PR #1151
  • OpenClaw 插件可用性显著增强:补充架构文档与图示 PR #1145,安装器不再覆盖 gateway.mode PR #1149,新增端到端 healthcheck 工具 PR #1180,支持 bypass session patterns PR #1194,并在 OpenViking 故障时避免阻塞 OpenClaw PR #1158
  • 测试与 CI 覆盖大幅补强:OpenClaw 插件新增大规模单测套件 PR #1144,补充 e2e 测试 PR #1154,新增 OpenClaw2OpenViking 集成测试与 CI 流水线 PR #1168
  • 会话、解析与导入链路更稳健:支持创建 session 时指定 session_id PR #1074,CLI 聊天端点优先级与 grep --exclude-uri/-x 能力得到增强 PR #1143 PR #1174,目录导入 UX / 正确性与扫描 warning 契约也进一步改善 PR #1197 PR #1199
  • 稳定性与安全性继续加固:修复任务 API ownership 泄露问题 PR #1182,统一 stale lock 处理并补充 ownership checks PR #1171,修复 ZIP 乱码 PR #1173、embedder dimensions 透传 PR #1183、语义 DAG 增量更新缺失 summary 场景 PR #1177 等问题。

Upgrade Notes

  • OpenClaw 插件安装器不再写入 gateway.mode。如果你之前依赖安装流程自动改写该配置,升级后需要改为显式管理,见 PR #1149
  • 如果你使用 --with-bot 进行安装或启动,失败时现在会直接返回错误码;依赖“失败但继续执行”行为的脚本需要同步调整,见 PR #1175
  • 如果你接入 OpenAI Dense Embedder,自定义维度参数现在会正确传入 embed();此前依赖默认维度行为的调用方建议复核配置,见 PR #1183
  • ov status 现在会展示 embedding 与 rerank 模型使用情况,便于排障与环境核对,见 PR #1191
  • 检索侧曾尝试加入基于 tags metadata 的 cross-subtree retrieval PR #1162,但已在本版本窗口内回滚 PR #1200,因此不应将其视为 v0.3.3 的最终可用能力。
  • litellm 依赖范围更新为 >=1.0.0,<1.83.1,升级时建议同步检查锁文件与兼容性,见 PR #1179

What's Changed

Benchmark, Eval, CLI, and Writing

OpenClaw Plugin, OpenCode Plugin, Bot, and Console

Sessions, Retrieval, Parsing, and Resource Import

Stability, Runtime, and Security

Build and Dependencies

New Contributors

Full Changelog: v0.3.2...v0.3.3

What's Changed

  • Feat(benchmark): Add benchmark/RAG : RAG system evaluation framework by @sponge225 in #825
  • docs(openclaw-plugin): refresh architecture guides with diagrams by @qin-ctx in #1145
  • fix(openclaw-plugin): stop writing gateway.mode from installers by @LinQiang391 in #1149
  • test(openclaw-plugin): add comprehensive UT suite under tests/ut/ (27… by @huangxun375-stack in #1144
  • feat(cli): improve chat endpoint configuration priority by @ruansheng8 in #1143
  • feat(eval): add locomo eval scripts for openclaw and readme by @yeshion23333 in #1152
  • add e2e test under tests/ut/e2e by @huangxun375-stack in #1154
  • Handle OpenViking outages without blocking OpenClaw by @wlff123 in #1158
  • fix(ci): skip filesystem tests on Windows due to FUSE compatibility by @kaisongli in #1156
  • feat(write): add content write interface by @zhoujh01 in #1151
  • fix(summarizer): use correct URI matching for memory context_type during reindex by @deepakdevp in #1155
  • fix(parser): use GITHUB_TOKEN for ZIP downloads if available by @jellespijker in #1146
  • feat: Add OpenClaw2OpenViking integration tests with CI pipeline by @kaisongli in #1168
  • fix(transaction): unify stale lock handling with ownership checks by @qin-ctx in #1171
  • fix(zip): Fix garbled characters by @zhoujh01 in #1173
  • fix: exit with error if --with-bot fail by @MaojiaSheng in https://gi...
Read more

v0.3.2

01 Apr 02:50
27f6188

Choose a tag to compare

What's Changed

  • Chore/pr agent ark token billing by @qin-ptr in #1117
  • Fix HTTPX recognition issue with SOCKS5 proxy causing OpenViking crash by @wlff123 in #1118
  • refactor(model): unify config-driven retry across VLM and embedding by @qin-ctx in #926
  • fix(bot): import eval session time by @yeshion23333 in #1121
  • docs(examples): retire legacy integration examples by @qin-ctx in #1124
  • fix(ci): skip filesystem tests on Windows due to FUSE compatibility by @kaisongli in #1111
  • docs(docker): use latest image tag in examples by @qin-ctx in #1125
  • upload the new wechat group qrcode by @yuyaoyoyo-svg in #1127
  • Unify test directory in openclaw-plugin by @wlff123 in #1128
  • docs(guides):Add concise OVPack guide in Chinese and English by @sponge225 in #1126
  • docs(guides): reorganize observability documentation by @qin-ctx in #1130
  • fix(installer): fall back to official PyPI when mirror lags by @qin-ctx in #1131
  • feat(docker) add vikingbot and console by @zhoujh01 in #1134
  • fix(vlm): rollback ResponseAPI to Chat Completions, keep tool calls by @chenjw in #1137
  • feat(openclaw-plugin): add session-pattern guard for ingest reply assist by @Mijamind719 in #1136

Full Changelog: v0.3.1...v0.3.2

v0.3.1

31 Mar 07:15
0502a99

Choose a tag to compare

What's Changed

  • feat(ast): add PHP tree-sitter support by @yangxinxin-7 in #1087
  • feat(ci): add multi-platform API test support for 5 platforms by @kaisongli in #1093
  • fix(ci): refresh uv.lock for docker release build by @zhoujh01 in #1094
  • fix(openclaw-plugin): simplify install flow and harden helpers by @qin-ctx in #1095
  • fix(openclaw-plugin): preserve existing ov.conf on auto install by @qin-ctx in #1098
  • ci: build docker images natively per arch by @zhoujh01 in #1100
  • Feature/memory opt by @chenjw in #1099
  • feat(storage): add auto language detection for semantic summary generation by @likzn in #1076
  • feat(prompt) support configurable prompt template directories by @zhoujh01 in #1096
  • feat: unify config-driven retry across VLM and embedding by @snemesh in #1049
  • feat(bot): import ov eval script by @yeshion23333 in #1108
  • Revert "feat: unify config-driven retry across VLM and embedding" by @qin-ptr in #1113
  • fix(storage) Fix parent_uri compatibility with legacy records by @zhoujh01 in #1107
  • fix(session): unify archive context abstracts by @qin-ctx in #1104

New Contributors

Full Changelog: v0.2.15...v0.3.1

v0.2.14

30 Mar 06:07
a66a1a6

Choose a tag to compare

OpenViking v0.2.14

本次 v0.2.14 版本主要围绕多租户能力、解析导入链路、OpenClaw 插件体验、Bot/Feishu 集成,以及服务端稳定性与安全性做了集中增强。

Highlights

  • 多租户与身份管理进一步完善。CLI 已支持租户身份默认值与覆盖,文档新增多租户使用指南,memory 也支持仅按 agent 维度隔离的 agent-only scope。
  • 解析与导入链路更完整。图片解析新增 OCR 文本提取,目录导入识别 .cc 文件,重复标题导致的文件名冲突得到修复,HTTP 上传链路改为更稳妥的 upload id 流程。
  • OpenClaw 插件显著增强。安装器与升级流程统一,默认按最新 Git tag 安装,session API 与 context pipeline 做了统一重构,并补齐了 Windows、compaction、compact result mapping、子进程重拉起等多处兼容性与稳定性问题。
  • Bot 与 Feishu 集成可用性继续提升。修复了 bot proxy 未鉴权问题,改进了 Moonshot 请求兼容性,并升级了 Feishu interactive card 的 markdown 展示体验。
  • 存储与运行时稳定性持续提升。包括 queuefs embedding tracker 加固、vector store 移除 parent_uri、Docker doctor 检查对齐,以及更细粒度的 eval token 指标。

Upgrade Notes

  • Bot proxy 接口 /bot/v1/chat/bot/v1/chat/stream 已补齐鉴权,依赖未鉴权访问的调用方需要同步调整,见 #996
  • 裸 HTTP 导入本地文件/目录时,推荐按 temp_upload -> temp_file_id 的方式接入上传链路,见 #1012
  • OpenClaw 插件的 compaction delegation 修复要求 openclaw >= v2026.3.22,见 #1000
  • OpenClaw 插件安装器现在默认跟随仓库最新 Git tag 安装,如需固定版本可显式指定,见 #1050

What's Changed

Multi-tenant, Memory, and Identity

  • 支持 CLI 租户身份默认值与覆盖,#1019 by @zhoujh01
  • 支持仅按 agent 隔离的 agent memory scope,#954 by @liberion1994
  • 新增多租户使用指南文档,#1029 by @qin-ctx
  • 在 quickstart 和 basic usage 中补充 user_keyroot_key 的区别说明,#1077 by @r266-tech
  • 示例中支持将 recalled memories 标记为 used,#1079 by @0xble

Parsing and Resource Import

OpenClaw Plugin and Installer

  • 回滚 duplicate registration guard 的加固改动,#995 by @qin-ptr
  • Windows 下 mapped session ID 做安全清洗,#998 by @qin-ctx
  • 使用 plugin-sdk exports 实现 compaction delegation,修复 #833,要求 openclaw >= v2026.3.22#1000 by @jcp0578
  • 统一 installer 升级流程,#1020 by @LinQiang391
  • 默认按最新 Git tag 安装 OpenClaw 插件,#1050 by @LinQiang391
  • 统一 session APIs,并重构 OpenClaw context pipeline 以提升一致性、可维护性和测试覆盖,#1040 by @wlff123
  • 将 openclaw-plugin 的 DEFAULT_COMMIT_TOKEN_THRESHOLD 调整为 20000#1052 by @wlff123
  • 为 OpenViking 子进程增加防御式重拉起机制,#1053 by @huangxun375-stack
  • 对齐 agent routing 并降低默认日志噪音,#1054 by @LinQiang391
  • 修复 compact result mapping,#1058 by @jcp0578
  • 移除 ov_archive_expand 中重复声明的 const sessionId#1059 by @evaldass
  • 新增 Claude Code memory plugin 示例,#903 by @Castor6

Bot, Feishu, and Security

  • 修复 Bot Proxy 接口 /bot/v1/chat/bot/v1/chat/stream 的未鉴权访问问题,#996 by @13ernkastel
  • 调整 tool content role 为 user,并优化 Feishu on_message#1023 by @yeshion23333
  • 修复/增强 Moonshot 请求错误处理,#1026 by @Linsiyuan9
  • 进一步修复 Moonshot invalid request 问题,#1028 by @Linsiyuan9
  • Feishu 消息升级为支持 markdown 的 interactive card v2,#1015 by @r266-tech
  • 根据 review feedback 打磨 interactive card 细节,#1046 by @r266-tech

Storage, Runtime, Examples, and Tooling

Build and Dependencies

New Contributors

Full Changelog: v0.2.13...v0.2.14

What's Changed

  • Revert "fix(openclaw-plugin): harden duplicate registration guard" by @qin-ptr in #995
  • Add non-empty S3 directory marker compatibility by @zhoujh01 in #997
  • fix(openclaw-plugin): sanitize mapped session IDs for Windows by @qin-ctx in #998
  • fix(parse): prevent merged filename collision on duplicate headings by @deepakdevp in #1005
  • build(deps): bump actions/checkout from 4 to 6 by @dependabot[bot] in #1002
  • build(deps): bump actions/cache from 4 to 5 by @dependabot[bot] in #1001
  • fix(parse): recognize .cc files during directory import by @qin-ctx in #1008
  • fix(openclaw-plugin): use plugin-sdk exports for compaction delegation (fixes #833) openclaw ≥ v2026.3.22 by @jcp0578 in #1000
  • feat(cli): support tenant identity defaults and overrides by @zhoujh01 in #1019
  • fix(bot): Change tool content role to user, opt feishu on_message by @yeshion23333 in #1023
  • feat(bot): Error calling LLM: litellm.BadRequestError: MoonshotExcept… by @Linsiyuan9 in #1026
  • feat(bot): use interactive card with markdown for Feishu messages (v2) by @r266-tech in #1015
  • werewolf game demo by @yuyaoyoyo-svg in #1025
  • fix(queuefs): harden embedding tracker across worker loops by @qin-ctx in #1024
  • feat(installer, openclaw-plugin): unified installer upgrade by @LinQiang391 in #1020
  • fix(http): replace temp paths with upload ids by @qin-ctx in #1012
  • Fix Unauthenticated Access to Bot Proxy Endpoints (/bot/v1/chat, /bot/v1/chat/stream) by @13ernkastel in #996
  • Fix/moonshot invalid request by @Linsiyuan9 in #1028
  • feat(parse): implement OCR text extraction for image parser by @mvanhorn in #942
  • fix(ov-cli): preserve .zip suffix for temp archives uploaded from directories by @Shawn-cf-o in #1021
  • feat(memory): support agent-only agent memory scope by @liberion1994 in #954
  • docs(concepts): add multi-tenant usage guide by @qin-ctx in #1029
  • feat(claude-code-plugin): add Claude Code memory plugin example by @Castor6 in #903
  • feat(eval): add emb token, get task add token result by @yeshion23333 in #1038
  • fix(docker): align doctor AGFS check with bundled pyagfs by @zhoujh01 in #1044
  • feat(openclaw-plugin): default plugin install to latest Git tag by @LinQiang391 in #1050
  • refactor(openclaw-plugin): Unified session APIs and refactored the OpenClaw context pipeline for more consistent behavior, better maintainability, and stronger test coverage. by @wlff123 in #1040
  • set DEFAULT_COMMIT_TOKEN_THRESHOLD to 20000 for openclaw-plugin by @wlff123 in https://g...
Read more

v0.2.13

26 Mar 06:01
20a25fd

Choose a tag to compare

What's Changed

  • test: add comprehensive unit tests for core utilities by @xingzihai in #990
  • fix(vlm): scope LiteLLM thinking param to DashScope providers only by @deepakdevp in #958
  • Api test:improve API test infrastructure with dual-mode CI by @kaisongli in #950
  • docs: Add basic usage example and Chinese documentation for examples by @xingzihai in #979
  • Fix Windows engine wheel runtime packaging by @zhoujh01 in #993
  • fix(openclaw-plugin): harden duplicate registration guard by @qin-ctx in #974

New Contributors

Full Changelog: v0.2.12...v0.2.13

v0.2.12

25 Mar 15:10
d56d7d4

Choose a tag to compare

What's Changed

New Contributors

Full Changelog: v0.2.11...v0.2.12

v0.2.11

25 Mar 12:22
32d7826

Choose a tag to compare

OpenViking v0.2.11

OpenViking v0.2.11 聚焦在四个方向:模型与检索生态扩展、解析与导入能力增强、服务端可观测性与运维能力补齐,以及多租户安全性和稳定性加固。相较 v0.2.9,这一版本不仅补上了 Helm 部署、Prometheus 指标、健康统计 API、ov doctorreindex 等工程能力,也持续扩展了 embedding、rerank、VLM 与 bot 侧的模型接入面。

这次更新的代表性改动包括:新增 MiniMax embedding、Azure OpenAI、GeminiDenseEmbedder、LiteLLM embedding/rerank、OpenAI-compatible rerank 与 Tavily 搜索后端;新增 Whisper 音频转写与飞书/Lark 云文档解析;新增多租户文件加密与文档加密;增加 Prometheus 指标导出、内存健康统计接口、可信租户头鉴权模式,以及面向 Kubernetes 的 Helm Chart。与此同时,版本还集中修复了 Windows 锁文件、会话异步提交、向量检索 NaN/Inf 分数、ZIP 路径穿越、SOCKS5 代理兼容等一批实际使用中的问题。

版本亮点

  • 模型与检索生态继续扩展:新增 MiniMax embedding #624、Azure OpenAI embedding/VLM #808、GeminiDenseEmbedder #751、LiteLLM embedding #853 与 rerank #888,并补充 OpenAI-compatible rerank #785 与 Tavily 搜索后端 #788
  • 内容接入链路更完整:音频资源现在支持 Whisper ASR 解析 #805,云文档场景新增飞书/Lark 解析器 #831,文件向量化策略变为可配置 #858,搜索结果还新增了 provenance 元数据 #852
  • 服务端运维能力明显补齐:新增 ov reindex #795ov doctor #851、Prometheus exporter #806、内存健康统计 API #706、可信租户头模式 #868 与 Helm Chart #800
  • 多租户与安全能力增强:新增多租户文件加密 #828 和文档加密能力 #893,修复租户上下文在 observer 与 reindex 流程中的透传问题 #807 #820,并修复 ZIP Slip 风险 #879 与 trusted auth 模式下 API key 校验缺失 #924
  • 稳定性与工程体验持续加固:向量检索 NaN/Inf 分数处理在结果端 #824 和源头 #882 双重兜底,会话异步提交与并发提交问题被修复 #819 #783 #900,Windows stale lock 与 TUI 输入问题持续修复 #790 #798 #854,同时补上了代理兼容 #957 与 API 重试风暴保护 #772

升级提示

  • 如果你使用 litellm 集成,请关注这一版本中的安全策略调整:先临时硬禁用 #937,后恢复为仅允许 <1.82.6 的版本范围 #966。建议显式锁定依赖版本。
  • 如果你启用 trusted auth 模式,需要同时配置服务端 API key,相关校验已在 #924 中强制执行。
  • Helm 默认配置已切换为更适合 Volcengine 场景的默认值,并补齐缺失字段 #822。升级 chart 时建议重新审阅 values 配置。
  • Windows 用户建议关注 stale PID / RocksDB LOCK 文件处理增强 #790 #798 #854

详细变更

以下列表已按主题去重整理,保留每一项唯一 PR,并附上对应链接,便于直接用于 GitHub Release。

模型、Embedding、Rerank 与检索生态

  • 新增 MiniMax embedding provider,支持通过官方 HTTP API 接入 MiniMax 向量模型。PR #624
  • 新增 OpenAI-compatible rerank provider。PR #785
  • 新增 Azure OpenAI 对 embedding 与 VLM 的支持。PR #808
  • 新增 GeminiDenseEmbedder 文本向量模型提供方。PR #751
  • 新增 Tavily 作为可配置的 web search backend。PR #788
  • 修复 LiteLLM 下 zai/ 模型前缀处理,避免重复拼接 zhipu 前缀。PR #789
  • 修复 Gemini embedder 相关问题。PR #841
  • 新增 LiteLLM embedding provider。PR #853
  • 新增默认向量索引名可配置能力。PR #861
  • 新增 LiteLLM rerank provider。PR #888
  • 修复 Ollama embedding provider 的维度解析问题。PR #915
  • 为 Jina 代码模型补充 code-specific task 默认值。PR #914
  • 在 embedder 与 vectordb 维度不匹配时给出警告提示。PR #930
  • 为 Jina embedding provider 增加代码模型维度与更可操作的 422 错误提示。PR #928
  • 搜索结果新增 provenance 元数据,方便追踪召回来源。PR #852
  • 修复 recall limit 逻辑。PR #821
  • 在结果序列化前钳制向量检索中的 inf/nan 分数,避免 JSON 失败。PR #824
  • 在相似度分数源头钳制 inf/nan,进一步避免 JSON crash。PR #882

解析、导入与内容处理

  • 新增基于 Whisper 的音频解析与 ASR 集成。PR #805
  • 修复 PDF 书签目标页为整数索引时的解析问题。PR #794
  • 新增飞书/Lark 云文档解析器。PR #831
  • 修复 MarkdownParser 的字符数限制处理。PR #826
  • 支持可配置的文件向量化策略。PR #858
  • 优化语义处理性能,并发执行 batch overview 与 file summary 生成。PR #840
  • 修复 resource add 时可能出现的 file exists 错误。PR #845
  • 修复 ZIP 解压中的 Zip Slip 路径穿越风险。PR #879

服务端、观测、部署与运维

  • 新增 CLI reindex 命令,用于主动触发内容重建索引。PR #795
  • 修复 observer 中 RequestContext 透传,支持 tenant-scoped vector count。PR #807
  • 新增基于 observer pattern 的 Prometheus metrics exporter。PR #806
  • 新增内存健康统计 API endpoints。PR #706
  • 新增 Helm Chart,支持 Kubernetes 部署。PR #800
  • 修复 Helm 默认值并补齐缺失配置字段,默认切换为 Volcengine 场景。PR #822
  • 新增 ov doctor 诊断命令。PR #851
  • ov doctor 中的 ov.conf JSON 加载逻辑集中管理。PR #913
  • 新增 trusted auth mode,支持基于 tenant headers 的可信鉴权模式。PR #868
  • 修复 trusted auth mode 下必须提供 server API key 的校验。PR #924
  • 修复 dockerized localhost server 场景下 CLI 上传本地文件的问题。PR #961
  • 将 vectordb engine 迁移到 abi3 packaging,改善构建与分发兼容性。PR #897
  • 重构集成测试体系。PR #910

多租户、安全、会话与稳定性

  • 新增多租户文件加密能力。PR #828
  • 新增文档加密能力,并重构加密相关代码。PR #893
  • 修复 reindex existence check 未正确传递 tenant context 的问题。PR #820
  • client.Session 新增 commit_asyncPR #819
  • 修复 session archive 相关问题。PR #883
  • 修复 session 并发提交时旧消息可能被重复提交的问题。PR #783
  • 新增异步 session commit、session metadata 与 archive continuity threading。PR #900
  • 为队列增加 circuit breaker,避免 API retry storm。PR #772
  • 修复 Semantic queue worker 使用错误并发限制的问题,改为 _max_concurrent_semanticPR #905
  • 修复 HTTPX 在 SOCKS5 代理场景下的识别问题,避免 OpenViking crash。PR #957
  • 严格校验 ov.confovcli.confPR #904
  • 加强 LogConfig 未知字段校验,并在 ParserConfig 中给出告警。PR #856
  • 读取 ov.conf JSON 时支持展开环境变量。PR #908
  • 临时硬禁用 LiteLLM 集成以规避安全风险。PR #937
  • 在安全范围内恢复 LiteLLM 集成,仅允许 <1.82.6 版本。PR #966

Windows 兼容性与底层资源处理

  • 修复 Windows 下 stale PID lock 与 TUI console input 处理问题。PR #790
  • 启动时清理 Windows 下残留的 RocksDB LOCK 文件。PR #798
  • 说明文档中补充 process_lock 在 Windows 的错误处理说明。PR #849
  • 修复 process_lock._is_pid_aliveWinError 11 的处理。PR #854

Bot、Plugin 与 OpenClaw

Read more

disable litellm

24 Mar 15:32

Choose a tag to compare

LiteLLM 安全热修复 Release Note

更新时间:2026-03-24

背景

由于上游依赖 LiteLLM 出现公开供应链安全事件,OpenViking 在本次热修复中临时禁用所有 LiteLLM 相关入口,以避免继续安装或运行到受影响依赖。

变更内容

  • 移除根依赖中的 litellm
  • 移除根 uv.lock 中的 litellm
  • 禁用 LiteLLM 相关的 VLM provider 入口
  • 禁用 bot 侧 LiteLLM provider 和图片工具入口
  • 增加 LiteLLM 已禁用的回归测试

建议操作

建议用户立即执行以下动作:

  1. 检查运行环境中是否安装 litellm
  2. 卸载可疑版本并重建虚拟环境、容器镜像或发布产物
  3. 对近期安装过可疑版本的机器轮换 API Key 和相关凭证
  4. 升级到本热修复版本

可用命令:

python -m pip show litellm
python -m pip uninstall -y litellm

兼容性说明

这是一个以止损为目标的防御性热修复版本。LiteLLM 相关能力会暂时不可用,直到上游给出可信的修复版本和完整事故说明。

参考链接

v0.2.9

19 Mar 15:04
337e51f

Choose a tag to compare

What's Changed

  • fix(resource): enforce agent-level watch task isolation by @lyfmt in #762
  • feat(embedder): use summary for file embedding in semantic pipeline by @yangxinxin-7 in #765
  • Fix/bot readme by @chenjw in #774
  • Fix/increment update dir vector store by @myysy in #773
  • fix(plugin): restore bug fixes from #681 and #688 lost during #662 merge by @qin-ctx in #779
  • docs: add docker compose instructions and mac port forwarding tip to … by @fengluodb in #781
  • Update docs by @zhoujh01 in #782
  • feat(ci): add comprehensive Qodo PR-Agent review rules by @chethanuk in #780
  • feat:Add mode config, add debug mode, add /remember cmd by @yeshion23333 in #757
  • fix(vectordb): share single adapter across account backends to prevent RocksDB lock contention by @ahmedhesham6 in #777

New Contributors

Full Changelog: v0.2.8...v0.2.9

v0.2.8

19 Mar 09:33
4984ba8

Choose a tag to compare

OpenViking v0.2.8 发布公告

OpenViking v0.2.8 现已发布。

这是一次围绕 上下文工程能力、插件生态、检索与记忆链路、可观测性以及工程兼容性 持续增强的版本更新。
整体来看,v0.2.8 以功能补强和稳定性修复为主,适合现有用户升级;如果你在使用 OpenClaw / OpenCode 插件、长会话记忆、资源同步或自定义模型接入,本次更新尤其值得关注。

本次更新亮点

1. 插件生态继续升级,OpenClaw / OpenCode 集成更完整

  • openclaw-plugin 升级到 2.0,从 memory plugin 进一步演进为 context engine
  • 新增并完善 OpenCode memory plugin example,补充 attribution 与后续插件更新。
  • 支持 多智能体 memory isolation,可基于 hook context 中的 agentId 做记忆隔离。
  • 修复插件自动 recall 可能导致 agent 长时间挂起的问题,并补强 legacy commit 兼容。
  • MCP 查询服务补充 api_key 支持与默认配置能力,降低接入成本。

2. Session / Memory 链路增强,长期记忆能力更稳

  • 新增 memory cold-storage archival,通过 hotness scoring 管理长期记忆冷热分层。
  • 新增长记忆 chunked vectorization,改善超长内容的向量化处理能力。
  • 增加 used() 接口,用于上下文 / skill 使用追踪。
  • 修复 async commit 过程中的上下文透传、批次内重复写入、非标准 LLM 响应处理等问题。
  • Bot 场景下改用 commit_async(),减少阻塞风险,提升长会话稳定性。

3. 检索与 Embedding 能力持续增强

  • 分层检索中正式集成 rerank,并修复无 rerank 场景下的检索可用性问题。
  • 新增 RetrievalObserver,可用于检索质量指标观测,并已接入 ov observer
  • Embedding 侧新增:
    • Ollama 本地 embedding provider 支持(#644
    • Voyage dense embedding 支持(#635
    • OpenAI-compatible provider 的 extra HTTP headers 支持(#694
    • query / document 非对称 embedding 支持(#608#702
    • OpenAI embedder 的 key=value 参数解析能力(#711
  • 修复 CJK token 估算偏低等问题,提升多语言场景下的稳定性。

4. 资源、存储与解析链路更完善

  • 新增 resource watch scheduling 与状态跟踪能力,资源同步流程更可控。
  • 新增 reindex endpoint,支持内容手动修改后的重新 embedding。
  • 解析能力新增对 legacy .doc / .xls 格式的支持。
  • 修复从 URL 导入文件时文件名与扩展名丢失的问题。
  • 存储层新增 path locking 与选择性 crash recovery,进一步提升写入安全性。
  • 修复 tenant API 的隐式 root fallback、文件系统接口路径处理、工作目录 ~ 展开等问题。

5. VLM、Trace 与可观测性能力加强

  • 新增 request-level trace metrics 与对应 API 支持。
  • 新增 memory extract telemetry breakdown,帮助更细粒度地分析记忆提取过程。
  • OpenAI VLM 支持 streaming response handling
  • 补充 max_tokens 参数以避免 vLLM 拒绝请求,并支持 OpenAI-compatible VLM 的自定义 HTTP headers。
  • 自动清理模型输出中的 <think> 标签,减少推理内容污染存储结果。

6. 工程兼容性与交付体验继续改进

  • 修复 Windows zip 路径、代码仓库索引、Rust CLI 版本等跨平台问题。
  • agfs Makefile 完成跨平台兼容性重构。
  • Vectordb engine 支持按 CPU variant 拆分。
  • Docker 构建链路持续修复,补齐 build_support/ 拷贝逻辑。
  • Release workflow 支持发布 Python 3.14 wheels

7. 文档与社区内容持续补强

  • README、INSTALL、INSTALL-ZH 等文档持续更新。
  • 新增 日文文档,进一步提升国际化支持。
  • 补充 OpenClaw 插件升级说明与新链接修复。
  • 更新社区微信群二维码等资料,方便用户加入交流。

升级建议

  • 如果你在使用 OpenClaw 旧版 memory plugin,建议重点阅读 2.0 升级说明后再升级。https://github.com/volcengine/OpenViking/blob/main/examples/openclaw-plugin/INSTALL-ZH.md
  • 如果你依赖 OpenAI-compatible 模型网关 / 本地模型服务,建议关注本次新增的 headers、max_tokensapi_key 与 embedding 参数能力。
  • 如果你在生产环境中使用 长会话记忆、资源自动同步或多智能体场景,建议升级后重点验证 memory commit、resource watch 和检索观测链路。

总结

v0.2.8 是一次面向真实智能体应用场景的持续演进版本。
这次更新重点集中在:

  • 插件生态升级,OpenClaw / OpenCode 集成更成熟
  • Session / Memory 长链路能力增强
  • 检索、Embedding 与观测能力进一步完善
  • 资源、解析、存储链路稳定性提升
  • 跨平台、Docker、CI 与发布体验持续优化

欢迎大家升级体验,并继续反馈问题与建议。

致谢

感谢所有贡献者参与本次版本更新,也欢迎本版本中的多位新贡献者加入社区。
从累计变更来看,v0.2.6 -> v0.2.8 期间共有 20 位新贡献者 完成首次贡献。

Full Changelog

What's Changed

  • docs: add MCP integration guide (EN + ZH) by @r266-tech in #518
  • Add Trendshift badge to README by @qin-ctx in #536
  • fix(session): propagate extractor failures to async task error by @dr3243636-ops in #511
  • feat(openclaw-memory-plugin): add default log configuration by @qin-ctx in #541
  • Add files via upload by @yuyaoyoyo-svg in #543
  • Update install.sh by @qin-ptr in #545
  • Revert "Update install.sh" by @qin-ptr in #547
  • refactor(openclaw-memory-plugin): use openclaw CLI for plugin configuration by @qin-ctx in #550
  • fix: correct Volcengine sparse/hybrid embedder and update sparse model docs by @yangxinxin-7 in #561
  • feat: CLI sub-command optimization by @MaojiaSheng in #560
  • fix(storage): reject traversal segments before VikingFS access checks by @lyfmt in #557
  • feat(resource): implement incremental update with COW pattern by @myysy in #535
  • build(deps): bump actions/checkout from 4 to 6 by @dependabot[bot] in #556
  • build(deps): bump docker/build-push-action from 6 to 7 by @dependabot[bot] in #555
  • build(deps): bump actions/setup-python from 5 to 6 by @dependabot[bot] in #554
  • build(deps): bump docker/metadata-action from 5 to 6 by @dependabot[bot] in #553
  • feat(bot):Feishu channel mention, support PIC conversation, per-channel workspace, by @yeshion23333 in #567
  • feat: add --sender parameter to chat commands by @chenjw in #562
  • fix(Dockerfile): add rust ov by @zhoujh01 in #570
  • Fix: change Role.ROOT to Role.USER, and mirror the HTTP server behavior (sessions.py:94-95) by calling initialize_user_directories() and initialize_agent_directories() at the start of create_session(). by @yangxinxin-7 in #572
  • fix: use normalized path in ClassifiedFile for cross-platform consistency by @sponge225 in #574
  • fix(session): remove redundant parameters from archive call by @myysy in #575
  • feat:Add OpenCode memory plugin example by @LittleLory in #569
  • Update README.md by @Soda-Wong in https://github.com/volcengine/OpenViking/pull...
Read more