What's Changed

• feat(embedder): add Cohere dense embedder by @Dicoangelo in #941
• lisence: change the main lisence to AGPL-3.0 by @MaojiaSheng in #1085
• fix(storage): prevent silent data loss in VikingFS.append_file() by @RGB-loop in #1036
• Revert "feat(examples): mark recalled memories as used" by @qin-ptr in #1090

New Contributors

• @Dicoangelo made their first contribution in #941
• @RGB-loop made their first contribution in #1036

Full Changelog: v0.2.14...v0.2.15

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_key 与 root_key 的区别说明，#1077 by @r266-tech
• 示例中支持将 recalled memories 标记为 used，#1079 by @0xble

Parsing and Resource Import

• 新增图片解析 OCR 文本提取能力，#942 by @mvanhorn
• 修复重复标题导致的合并文件名冲突，#1005 by @deepakdevp
• 目录导入时识别 .cc 文件，#1008 by @qin-ctx
• 增加对非空 S3 目录 marker 的兼容性，#997 by @zhoujh01
• HTTP 上传链路从临时路径切换为 upload id，#1012 by @qin-ctx
• 修复从目录上传时临时归档文件丢失 .zip 后缀的问题，#1021 by @Shawn-cf-o

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

• 加固 queuefs embedding tracker 在多 worker loop 下的行为，#1024 by @qin-ctx
• vector store 移除 parent_uri，#1042 by @zhoujh01
• 为 eval 增加 embedding token 统计，并让任务结果返回 token 信息，#1038 by @yeshion23333
• 对齐 Docker doctor 中的 AGFS 检查与内置 pyagfs 版本，#1044 by @zhoujh01
• 新增 werewolf game demo，#1025 by @yuyaoyoyo-svg

Build and Dependencies

• 升级 actions/checkout 从 4 到 6，#1002 by @dependabot[bot]
• 升级 actions/cache 从 4 到 5，#1001 by @dependabot[bot]

New Contributors

• @Linsiyuan9 在 #1026 完成了首次贡献
• @Shawn-cf-o 在 #1021 完成了首次贡献
• @liberion1994 在 #954 完成了首次贡献
• @Castor6 在 #903 完成了首次贡献
• @huangxun375-stack 在 #1053 完成了首次贡献
• @evaldass 在 #1059 完成了首次贡献
• @0xble 在 #1079 完成了首次贡献

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...

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

• @xingzihai made their first contribution in #990
• @kaisongli made their first contribution in #950

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

What's Changed

• Use uv sync --locked in Dockerfile by @mtthidoteu in #963
• fix(server): handle CancelledError during shutdown paths by @ZaynJarvis in #848
• fix(bot):rollback config by @yeshion23333 in #973

New Contributors

• @mtthidoteu made their first contribution in #963

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

OpenViking v0.2.11

OpenViking v0.2.11 聚焦在四个方向：模型与检索生态扩展、解析与导入能力增强、服务端可观测性与运维能力补齐，以及多租户安全性和稳定性加固。相较 v0.2.9，这一版本不仅补上了 Helm 部署、Prometheus 指标、健康统计 API、ov doctor 与 reindex 等工程能力，也持续扩展了 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 #795、ov 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_async。PR #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_semantic。PR #905
• 修复 HTTPX 在 SOCKS5 代理场景下的识别问题，避免 OpenViking crash。PR #957
• 严格校验 ov.conf 与 ovcli.conf。PR #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_alive 对 WinError 11 的处理。PR #854

Bot、Plugin 与 OpenClaw

• 为 memory-openviking plugin 增加清理脚本。PR #832
• 增加旧版本 plugin 清理说明。[PR #843](https://github.com/volcengine/OpenViking/pu...

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 相关能力会暂时不可用，直到上游给出可信的修复版本和完整事故说明。

参考链接

• 上游 issue: BerriAI/litellm#24512
• PyPI 项目页: https://pypi.org/project/litellm/
• GitHub Security: https://github.com/BerriAI/litellm/security
• OpenViking 热修分支: https://github.com/volcengine/OpenViking/tree/hotfix/v0.2.10-disable-litellm

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

• @fengluodb made their first contribution in #781
• @ahmedhesham6 made their first contribution in #777

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

OpenViking v0.2.8 发布公告

OpenViking v0.2.8 现已发布。

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

本次更新亮点

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

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

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

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

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

• 分层检索中正式集成 rerank，并修复无 rerank 场景下的检索可用性问题。
  • 相关 PR：#599、#754
• 新增 RetrievalObserver，可用于检索质量指标观测，并已接入 ov observer。
  • 相关 PR：#622、#623
• 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 估算偏低等问题，提升多语言场景下的稳定性。
  • 相关 PR：#661、#658

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

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

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

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

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

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

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

• README、INSTALL、INSTALL-ZH 等文档持续更新。
  • 相关 PR：#581、#582、#663、#666、#692
• 新增 日文文档，进一步提升国际化支持。
  • 相关 PR：#755
• 补充 OpenClaw 插件升级说明与新链接修复。
  • 相关 PR：#758、#761
• 更新社区微信群二维码等资料，方便用户加入交流。
  • 相关 PR：#649

升级建议

• 如果你在使用 OpenClaw 旧版 memory plugin，建议重点阅读 2.0 升级说明后再升级。https://github.com/volcengine/OpenViking/blob/main/examples/openclaw-plugin/INSTALL-ZH.md
• 如果你依赖 OpenAI-compatible 模型网关 / 本地模型服务，建议关注本次新增的 headers、max_tokens、api_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

• v0.2.7...v0.2.8
  v0.2.7...v0.2.8

• v0.2.6...v0.2.8
  v0.2.6...v0.2.8

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...

OpenViking v0.2.6 发布公告

OpenViking v0.2.6 已发布。

这是一次聚焦体验优化和稳定性增强的小版本更新。相比 v0.2.5，这一版不仅带来了更顺手的命令行交互和全新的 Console，也补齐了会话异步提交、后台任务跟踪、资源导入目录结构保留等关键能力，同时在 openclaw memory plugin、安装流程、跨平台兼容性和 CI 稳定性上做了大量修复与打磨。

重点更新

1. CLI 与对话体验进一步升级

• ov chat 现在基于 rustyline 提供更完整的行编辑体验，终端交互更自然，不再出现常见的方向键控制字符问题。
• 新增 Markdown 渲染能力，终端中的回答展示更清晰，代码块、列表等内容可读性更好。
• 支持聊天历史记录，同时提供关闭格式化和关闭历史记录的选项，便于在不同终端环境中按需使用。

2. 服务端异步能力增强，长任务不再轻易阻塞

• Session commit 新增异步提交能力，并支持通过 wait 参数控制是否同步等待结果。
• 当选择后台执行时，OpenViking 现在会返回可追踪的任务信息，调用方可以通过任务接口查询状态、结果或错误。
• 服务端新增可配置 worker count，进一步缓解单 worker 场景下长任务阻塞请求的问题。

这意味着在记忆提取、归档总结等耗时操作较多的场景下，服务端的可用性和可观测性都有明显提升。

3. 新增 Console，并持续增强 Bot 与资源操作能力

• 本版本新增独立的 OpenViking Console，提供更直观的 Web 控制台入口，方便调试、调用和查看接口结果。
• Bot 能力继续增强，新增 eval 能力，开放 add-resource 工具，并支持飞书进度通知等扩展能力。
• 资源导入支持 preserve_structure 选项，扫描目录时可以保留原始目录层级，适合更复杂的知识组织方式。
• 同时修复了 grep、glob、add-resource 等场景下的一些响应问题，提升日常使用稳定性。

4. openclaw memory plugin 能力和稳定性大幅完善

• openclaw memory plugin 在这一版中获得了较大幅度增强，补充了更完整的插件能力与相关示例。
• 插件安装链路进一步完善，现已支持通过 npm 包方式安装 setup-helper，部署和升级都更直接。
• 修复了本地运行、端口管理、配置保留、缺失文件下载、配置覆盖等一系列影响安装和使用体验的问题。
• Memory consolidation 与 skill tool memory 相关问题也得到修复，进一步提升记忆链路的稳定性。
• Vikingbot 作为 OpenViking 可选依赖的集成方式也做了完善，降低了插件和 bot 协同使用时的接入门槛。

对于希望将 OpenViking 与 memory / agent 工作流结合使用的开发者来说，这一版的可用性提升会比较明显。

5. 安装、跨平台与工程质量继续补强

• 新增 Linux ARM 支持，进一步扩展了 OpenViking 的部署平台范围。
• 修复了 Windows 下 UTF-8 BOM 配置文件的兼容问题，减少配置读取失败的情况。
• 修复了 install.sh、ov.conf.example、setup 失败退出等问题，并补充了 openclaw memory plugin 的 npm 包安装路径，提升首次安装和配置过程的成功率。
• CI 侧将 GitHub Actions runner 固定到明确 OS 版本，减少环境漂移带来的构建与发布不确定性。

总结

v0.2.6 是一个兼顾新能力与稳定性的版本。

如果你主要通过 CLI 或 Bot 使用 OpenViking，这一版会带来更顺手的交互体验；如果你在服务端接入中依赖会话提交、记忆提取和后台任务执行，这一版会带来更好的异步能力与可观测性；如果你在尝试 openclaw memory plugin 或跨平台部署，这一版也补上了不少过去容易踩坑的细节。

欢迎社区继续反馈使用体验、提交 Issue 和 PR，一起把 OpenViking 打磨得更稳、更好用。

New Contributors

• @markwhen 首次贡献于 #474
• @dr3243636-ops 首次贡献于 #472
• @ctudoudou 首次贡献于 #487
• @lixingjia77 首次贡献于 #494

感谢所有参与 v0.2.6 开发、修复、文档和工程改进的贡献者。

Full Changelog

v0.2.5...v0.2.6

What's Changed

• feat: improve ov chat UX with rustyline and markdown rendering by @chenjw in #466
• fix: grep for binding-client by @markwhen in #474
• feat(server): add configurable worker count to prevent single-worker blocking by @r266-tech in #470
• feat(sessions): add async commit support with wait parameter by @dr3243636-ops in #472
• [feat]: openclaw-memory-plugin: 新增插件功能 by @qin-ptr in #479
• fix: openclaw plugin local run by @qin-ptr in #480
• feat: support linux arm by @zhoujh01 in #482
• fix: fix ov.conf.example by @zhoujh01 in #488
• fix vikingbot grep/glob/add_resource get response issue by @typeck in #491
• docs: translate VLM providers section in README to English by @ctudoudou in #487
• refactor: remove agfs port configuration by @qin-ctx in #483
• fix: add-resource --to and --parent by @MaojiaSheng in #475
• fix: fix err log by @zhoujh01 in #495
• fix: remve emtpy merge by @zhoujh01 in #496
• fix(search): use session summaries in search and cap intent summary l… by @lixingjia77 in #494
• fix: improve file type detection and C/C++ AST extraction by @yangxinxin-7 in #497
• Revert "refactor: remove agfs port configuration" by @Soda-Wong in #498
• Fix/bot Fix Memory Consolidation Issues and Integrate Vikingbot as OpenViking Optional Dependency by @chenjw in #492
• fix(config): handle UTF-8 BOM in config files on Windows (#499) by @r266-tech in #500
• fix #477 by @chenjw in #503
• fix(setup): quit setup when fail by @zhoujh01 in #504
• feat(tasks): add async task tracking API for background operations by @dr3243636-ops in #476
• fix(openclaw-memory-plugin): improve port management and preserve existing config by @qin-ctx in #513
• docs: OpenViking Skills for search, add, operate by @MaojiaSheng in #510
• fix(openclaw-memory-plugin): add missing files and merge config instead of overwriting by @qin-ctx in #516
• fix install.sh by @qin-ptr in #517
• feat: Add console by @zhoujh01 in #383
• feat(bot):Add eval function(support locomo, skillsbench), open add-resource tool, add feishu progress notification capability by @yeshion23333 in #506
• Fix/skill tool memory by @BytedanceFu in #514
• feat(resource): add preserve_structure option for directory scanning by @r266-tech in #509
• ci: pin GitHub Actions runners to explicit OS versions by @zhoujh01 in #508
• feat(setup-helper): 用 install.js 替换 cli.js，发布为 npm 包 by @LinQiang391 in #524

New Contributors

• @markwhen made their first contribution in #474
• @dr3243636-ops made their first contribution in #472
• @ctudoudou made their first contribution in #487
• @lixingjia77 made their first contribution in #494

Full Changelog: v0.2.5...v0.2.6

What's Changed

• docs: use openviking-server to launch server by @MaojiaSheng in #398
• fix: Session.add_message() support parts parameter by @qin-ctx in #399
• feat: support GitHub tree/ URL for code repository import by @yangxinxin-7 in #400
• fix: improve ISO datetime parsing by @zztdandan in #404
• feat(pdf): extract bookmarks as markdown headings for hierarchical parsing by @r266-tech in #403
• feat: add index control to add_resource and refactor embedding logic by @Jay-ju in #401
• fix: support short-format URIs in VikingURI and VikingFS access control by @r266-tech in #402
• fix: handle None data in skill_processor._parse_skill() by @r266-tech in #405
• fix: fix add-resource by @zhoujh01 in #409
• fix: treat only .zip as archive; avoid unzipping ZIP-based container … by @sponge225 in #410
• fix(cli): support git@ SSH URL format in add-resource by @myysy in #411
• feat(pdf): add font-based heading detection and refactor PDF/Markdown parsing by @qin-ctx in #413
• 支持通过curl方式安装部署openclaw+openviking插件 by @LinQiang391 in #415
• Feature/vikingbot_opt： OpenAPI interface standardization；Feishu multi-user experience; observability enhancements; configuration system modernization. by @chenjw in #419
• docs: pip upgrade suggestion by @MaojiaSheng in #418
• feat: define a system path for future deployment by @MaojiaSheng in #423
• chore: downgrade golang version limit, update vlm version to seed 2.0 by @MaojiaSheng in #425
• [fix]: 修复通过curl命令安装场下下ubuntu/debian等系统触发系统保护无法安装的openviking的问题 by @LinQiang391 in #426
• fix(session): trigger semantic indexing for parent directory after memory extraction by @qin-ctx in #429
• feat(bot):Refactoring, New Evaluation Module, Feishu channel Opt & Feature Enhancements by @yeshion23333 in #428
• chore: agfs-client默认切到binding-client模式 by @chuanbao666 in #430
• feat(agfs): add ripgrep-based grep acceleration and fix vimgrep line parser by @yangxinxin-7 in #432
• [WIP] ci: add automated PR review workflow using Doubao model by @qin-ctx in #434
• fix(ci): use OPENAI_KEY instead of OPENAI.KEY in pr-review workflow by @qin-ctx in #435
• build(deps): bump actions/download-artifact from 7 to 8 by @dependabot[bot] in #442
• build(deps): bump actions/upload-artifact from 6 to 7 by @dependabot[bot] in #441
• build(deps): bump docker/login-action from 3 to 4 by @dependabot[bot] in #440
• build(deps): bump docker/setup-qemu-action from 3 to 4 by @dependabot[bot] in #438
• build(deps): bump docker/setup-buildx-action from 3 to 4 by @dependabot[bot] in #439
• fix(packaging): sdist 排除运行时二进制 by @zhoujh01 in #447
• ci: enhance PR review with severity classification and checklist by @qin-ctx in #437
• enable injection for Collection and CollectionAdaptor by @zhougit86 in #414
• chore: 编译子命令失败报错, golang版本最低要求1.22+ by @chuanbao666 in #444
• feat(viking_fs) support async grep by @typeck in #448
• OpenViking Plugin Exception Handling & Fixing by @wlff123 in #449
• feat(agfs): make binding client optional, add server bootstrap, tune logging and CI by @qin-ctx in #451
• fix: rust compile in uv pip install -e . by @MaojiaSheng in #452
• [wip]Enhance OpenViking Status Checks in the OpenClaw Plugin by @wlff123 in #453
• FIX: fixes multiple issues in the OpenViking chat functionality and unifies session ID generation logic between Python and Rust CLI implementations. by @chenjw in #446
• chore: 增加Makefile,方便build by @chuanbao666 in #450
• fix(bot): fix Telegram channel init crash and empty content for Claude by @ponsde in #421
• fix: suport uv pip install openviking[bot] by @chenjw in #457
• fix: agfs-client默认使用http-client by @chuanbao666 in #459
• fix(agfs): fix agfs binding-client import error by @chuanbao666 in #458
• openclaw-memory-plugin: ov.conf backend/agfs, default embedding 25121… by @LinQiang391 in #460
• vikingbot version to 3.10 by @chenjw in #461
• update vikingbot version to 0.1.3 by @chenjw in #462
• fix: github zip download timeout by @MaojiaSheng in #463

New Contributors

• @zztdandan made their first contribution in #404
• @Jay-ju made their first contribution in #401
• @sponge225 made their first contribution in #410
• @zhougit86 made their first contribution in #414
• @typeck made their first contribution in #448

Full Changelog: v0.2.3...v0.2.5